V1 Format
Each file must consist of a series of records.
A “record” is a list of parameters separated by the “;” character ending with a carriage return.
The files are structured as follows:
- A header record containing transmission details.
- A variable number of records, each corresponding to a payment order.
The header record
Pos. | Description | Values |
---|---|---|
01 | Header version | 01 |
02 | Shop ID | 12345678 |
03 | Mode | TEST or PRODUCTION |
04 | Channel | INVOICE |
Detail record
Pos. | Description |
---|---|
01 | Description: Defines the action to be performed. If the field is sent empty, the "PAYMENT” value is applied by default. Type: VARCHAR | Length: 32 | Optional Hosted Payment Form equivalent: vads_page_action REST API equivalent: formAction Possible value: PAYMENT |
02 | Description: Unique invoice reference. The only accepted special character is “-”. Type: VARCHAR | Length: 64 | Required Hosted Payment Form equivalent: vads_order_id REST API equivalent: orderId E.g.: CX-1254 |
03 | Description: Transaction amount expressed in the smallest currency unit . The amount cannot be populated with 0, unless the operation to be performed (Position 01) is “REGISTER”. Type: NUMERIC | Length: 13 | Required Hosted Payment Form equivalent: vads_amount REST API equivalent: amount E.g.: 4525 for EUR 45.25 |
04 | Description: Numeric code of the currency (ISO 4217 standard). Type: NUMERIC | Length: 3 | Required Must correspond to the currency of the company. Hosted Payment Form equivalent: vads_currency REST API equivalent: currency E.g.: 978 for euro (EUR) (See chapter List of supported currencies in appendix) |
05 | Description: Buyer’s e-mail address. Type: VARCHAR | Length: 255 | Optional Hosted Payment Form equivalent: vads_cust_email REST API equivalent: customer.email E.g.: sample@example.net |
06 | Description: Validation mode. For more information, see the chapter Configuring the default validation mode of the “Transaction management” user manual. Type: NUMERIC | Length: 1 | Optional Hosted Payment Form equivalent: vads_validation_mode REST API equivalent: cardOptions.manualValidation Possible values:
E.g.: 0 |
07 | Description: Description of the invoice to be paid. This description will be displayed to the buyer after the entry of the invoice reference in the data collection form. To guide the buyer and to reassure him/her, the “Description” area allows the merchant to display information specifying the invoice to his/her buyer. This description is displayed when the buyer clicks the “?” symbol to the right of the “Reference” entry field. To be in compliance with the GDPR, it is recommended to limit the display of personal information in this field. For example, for rent payment, specify the billing period and the reference of the accommodation rather than the name of the tenant. Type: VARCHAR | Length: 65 | Optional Hosted Payment Form equivalent: vads_order_description REST API equivalent: description E.g.: My order description |
08 | Description: Expiry date of the payment order. Cannot be before the current date and may not exceed 90 days. If this parameter is not sent, the value defined in the shop configuration will be applied (Settings > Shop menu, Configuration tab). Type: NUMERIC | Length: 8 | Optional Hosted Payment Page equivalent: N/A REST API equivalent: expirationDate E.g.: 20210603 |
09 | Description: Field specific to Latin America. Tax rate applied to the entire order. The value must be the percentage to be applied (19.6 for 19.6%). Type: NUMERIC | Length: 4 | Optional Hosted Payment Form equivalent: vads_tax_rate REST API equivalent: taxRate E.g.: 19.6 |
10 | Description: Merchant preference regarding 3DS authentication. If the field is sent empty, the “NO_PREFERENCE” value is applied by default. Type: VARCHAR | Length: 32 | Optional Hosted Payment Form equivalent: vads_threeds_mpi REST API equivalent: strongAuthentication Possible values:
E.g.: NO_PREFERENCE |
11 | Description: Using the data collection form. This field must be set to true, if transmitted. Type: BOOLEAN | Length: 1 | Optional Hosted Payment Page equivalent: N/A REST API equivalent: dataCollectionForm E.g.: true |
File samples
- basic example:
01;12345678;TEST;INVOICE
PAYMENT;CX-1254;3000;978;;;;;;;
- advanced example:
01;12345678;TEST;INVOICE
PAYMENT;CX-1254;3000;978;sample@example.net;0;My Order Description;20210603;;NO_PREFERENCE;
Download the sample pack: https://scelliuspaiement.labanquepostale.fr/doc/files/samples/sample-files.zip.
You will find sample files in the INVOICE folder.