SlimPay Help Center

SFTP overview

Protocol

Our File API is mainly accessible via SFTP. We can configure connections on demand.

Two environments are accessible:

  • Preprod: For your developments and testing phases.
  • Production: Once your tests are conclusive, to start doing real transactions.

For each environment, you need to provide your public SSH key. Once your access is created, you will be provided with:

  • The host
  • The port
  • Your username

A dedicated folder will then be created for you. This folder contains two subfolders:

  • in: you drop your files here
  • out: .ack/.err and reporting files will be dropped here by SlimPay

Connection

Here is an example of a standard way to connect using command-line:

sftp -o Port=<port> -o IdentityFile=<path_to_private_key> <username>@<host>

Format

Most of the actions available in our File API can be sent using a simplified CSV format. The charset should be UTF-8 and the separator between the fields a semi-colon ;.

For now, the documentation for each format is not entirely online but you can ask for it by submitting a request.

Acknowledgement and Errors Handling

  1. You send us a file.
  2. It is immediately parsed. Two possibilities:
    • The file is correctly formatted: a file with the same name but with the extension .ack is created.
    • The file is incorrectly formatted: a file with the same name but with the extension .err is created with the corresponding error message(s) in it.
  3. The file is then processed.
  4. Depending on the type of file sent, another reporting file can be created to signal an error post-processing.

In other words, an acknowledged file does not necessarily mean that the file was processed successfully but that its format was correct.

For instance, for a direct debits creation file: a .ack file is created if the format is correct.  Later on, when processing, the system might find out that one of the mandates used is revoked: a NOP file will be generated for the affected payment.

Was this article helpful?
0 out of 0 found this helpful