SlimPay Help Center

Remittance files

The 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 users with direct debit authorizations for whom a SEPA mandate needs to be created, as well as for data updates of users who have changed email, phone number, billing address or name.

Capture_d_e_cran_2021-09-13_a__10.25.15.png

 

How to inject a file ?

Once connected to the Dashboard V.2 (same procedure if you are still using the Back Office (V.1)), 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 means the validity of the syntax and only that. The accuracy of the data entered in the file must be checked during the construction of the file (transaction amount, transaction date, customer names, etc.). 

 


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.

 

 

mceclip2.png

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 discount files

The "Download" button: allows you to download a discount file

The "View" button: allows you to view the details of a discount 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.


Example:

name of the remittance file: remittance-0075.in
name of the acknowledgement file: remise-0075.in.ack

A positive acknowledgement only validates the fact that the file syntax is correct without prejudging the quality 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's failed payment (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".

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

 

 

mceclip0.pngSomething is not clear? We have explained the different types of orders in Lexicon.

 

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