Skip to main content

SlimPay Help Center

Remittance files



Remittance files are used to deposit direct debit or credit transfer orders on the SlimPay server.

They can also be used for the migration of existing customers with direct debit authorizations (for whom a SEPA mandate needs to be created), as well as for customer data updates including changes to email address, phone number, billing address or name.




How to inject a file

Once connected to the Dashboard V.2 (same procedure if you are still using the Back Office), in the left menu, please click on File > File Management > Import a file. 


What are the possible statuses of an injected file

When searching for injected files in > File Management> Lookup a file> Search, all files will appear: "Files awaiting injection" and "Files processed".

The injected files can have a valid status: OK .Ack or incorrect: .Err .

NB: The status .ack or .err is a validity of the file's syntax only. The accuracy of the data entered in the file (transaction amount, transaction date, customer names, etc.) must be checked during the construction of the file.

Characteristics common to the remittance and acknowledgement file

These are text files with records of variable size in CSV format with the semicolon character (" ; ") as separator.

If accented characters are used, you must ensure that they are encoded in UTF-8 format.


Type of remittance files

SlimPay supports several types of orders, which are used for different purposes:

  • Direct debit orders (type 1) = to debit the merchant's customers
  • Transfer orders (type 2) = to credit / refund the merchant's customers
  • Mandate migration orders (type 14) = to migrate existing, local country-specific debit authorizations to SEPA mandates (only for merchants who have not yet migrated to SEPA)
  • Orders to update customer bank details (Type 4) = to update customer bank details
  • Orders to create debit plans (Type 17) = to create automatic debit plans for customers
  • Orders to cancel debit plans (Type 7) = to stop debit plans when customers unsubscribe
  • Debit plan modification orders (Type 15) = to modify a debit plan (amount and/or date)

Each file can contain only one type of order (all orders in a file must be of the same type).

When SlimPay receives the remittance file from the merchant, SlimPay validates the format and returns a remittance file with the same name as the original final file with an additional extension .ack (positive acknowledgement) or .err (negative acknowledgement) depending on the validation result.




The "injected files" tab: allows you to view all the remittance files uploaded on the dashboard.

The "pending for injection" tab: are the files that have been imported on the dashboard, that have not yet been processed. Our batch runs quite fast, so your files will not stay on this tab for long. Once processed, they disappear from the "pending for injection" tab and land on the "injected files" tab.

The "Export" button: allows you to export the list of your remittance files.

The "Download" button: allows you to download a remittance file.

The "View" button: allows you to view the details of a remittance file.


Positive acknowledgement

If the input remittance file has been received and its syntax is correct, an acknowledgement file is generated.

The acknowledgement file will have the same name as the remittance file, to which the extension ".ack" is added. If the remittance file already had an extension, it is kept.


Name of the remittance file -
Name of the acknowledgement file -

A positive acknowledgement only validates the fact that the file syntax is correct. It offers no guarantee on the accuracy of the information provided.

If a remittance file contains records whose content cannot be executed (unknown customer reference, expired mandate, etc.), an R-transactions (rejections) file is generated containing a line describing the problem for each rejected record. This file is in the same format as the one selected by the merchant for the R-transactions provided after execution.


mceclip0.pngWhat are failed payments (R-Transactions)?


Negative acknowledgement

If a problem is detected in the syntax of the remittance file, an error file is generated.

This file will have the same name as the remittance file followed by the extension ".err".


Name of the remittance file -
Name of the error file -

The content of the error file is a line containing an error message that describes the problem encountered. The receipt by the merchant of an .err file means that the entire remittance has been rejected. No payment order for this remittance will be taken into account for bank execution.



mceclip0.pngSomething is not clear? Information regarding remittance files and related topics can be found in our Lexicon.


Was this article helpful?
0 out of 0 found this helpful
Return to top