• France
status page
Merchant Back Office
assistance
FAQContact support
Search
Categories
Tags
English
French
English
Homepage
Use cases
Create a payment
Create an installment payment
Create a multi-card (split) payment
Create a payment by Alias (Token)
Create a payment link
Create a recurring payment
Manage subscriptions
Manage your transactions (refund, cancel...)
Analyze your reports
API docs
Embedded Form
REST API
Hosted payment
Mobile payment
File exchange
Logos
Push mail
Snippets
Payment methods
Plugins
Guides
Merchant Back Office
Functional guides

V6 Response file

Header record

Pos. Description Values
01 Record code 00
02 File type PAY
03 File version 06
04 Return code of the first stage of processing

0: Processing completed

1: Format error

2: Value error

05 Information about the error Additional information about the error, empty if successfully processed.
06 Shop ID E.g.: 12345678
07 Mode TEST or PRODUCTION
08 Creation date in the YYYYMMDD format E.g.: 20220303
09 Creation time in the HHMMSS format E.g.: 145410
10 Date of file generation in the YYYYMMDD format E.g.: 20220303
11 End of processing time in HHMMSS format E.g.: 145417

Detail records

Pos. Description
01 Description: Record code.

Type: NUMERIC | Length: 2

Value: 02

02 Description: Sequence number of the detail record in the file.

Type: NUMERIC | Length: 6

E.g.:
  • 1 for the first line of the detail record line.
  • 2 for the second detail record line.
03 Description: Transaction date in the YYYYMMDD format.

Type: NUMERIC | Length: 8

E.g.: 20200603

04 Description: Transaction time in the HHMMSS format.

Type: NUMERIC | Length: 6

E.g.: 120615

05 Description: Transaction identifier.

Type: NUMERIC | Length: 6

Hosted Payment Form equivalent: vads_trans_id

REST API equivalent: cardDetails.legacyTransId

E.g.: 700001

06 Description: Transaction type

Type: VARCHAR | Length: 2

Value: CD

07 Description: Transaction amount expressed in the smallest currency unit .

Type: NUMERIC | Length: 12

Hosted Payment Page equivalent: vads_amount

REST API equivalent: amount

E.g.: 4525 for EUR 45.25

08 Description: Numeric code of the currency (ISO 4217 standard).

Type: NUMERIC | Length: 3

Hosted Payment Page equivalent: vads_currency

REST API equivalent: currency

E.g.: 978 for euro (EUR) (See chapter List of supported currencies in appendix)

09 Description: Transaction amount expressed in the smallest unit of the currency used for the capture in the bank.

Type: NUMERIC | Length: 12

Hosted Payment Page equivalent: vads_effective_amount

REST API equivalent: transactions.transactionDetails.effectiveAmount

E.g.: 4525 for EUR 45.25

10 Description: Numeric code of the currency that will be used for the capture at the ban (ISO 4217 standard).

Type: NUMERIC | Length: 3

Hosted Payment Page equivalent: vads_effective_currency

REST API equivalent: transactions.transactionDetails.effectiveCurrency

E.g.: 978 for euro (EUR) (See chapter List of supported currencies in appendix)

11
Description:
  • Date and time (in the YYYYMMDD format) in UTC time zone of the capture requested by the merchant for a payment by card.
  • Date and time (in the YYYYMMDD format) in UTC time zone of the funds transfer for a SEPA payment.

Type: NUMERIC | Length: 8

Hosted Payment Page equivalent: vads_presentation_date

REST API equivalent: transactionDetails.cardDetails.expectedCaptureDate

E.g.: 20200604

12 Description: Validation mode.

Type: NUMERIC | Length: 1

Hosted Payment Page equivalent: vads_validation_mode

REST API equivalent: cardOptions.manualValidation

Possible values:
  • 0: for automatic validation
  • 1: for manual validation

E.g.: 0

13 Description: Token or to debit.

Type: VARCHAR | Length: 50

Hosted Payment Page equivalent: vads_identifier

REST API equivalent: paymentMethodToken

E.g.: 59ecb199110145338c5704505760ec31

14 Description: MID used to process this request.

Type: VARCHAR | Length: 255

Hosted Payment Page equivalent: vads_contract_used

REST API equivalent: cardOptions.mid

E.g.: 1234567

15 Description: Order reference.

Type: VARCHAR | Length: 32

The only accepted special character is “-”.

Hosted Payment Page equivalent: vads_order_id

REST API equivalent: orderId

E.g.: CX-1254

16 Description: Order details 1.

Type: VARCHAR | Length: 255

Hosted Payment Page equivalent: vads_order_info

REST API equivalent: metadata.orderInfo

E.g.: Door code 3125

17 Description: Order details 2.

Type: VARCHAR | Length: 255

Hosted Payment Page equivalent: vads_order_info2

REST API equivalent: metadata.orderInfo2

E.g.: No elevator

18 Description: Order details 3.

Type: VARCHAR | Length: 255

Hosted Payment Page equivalent: vads_order_info3

REST API equivalent: metadata.orderInfo3

E.g.: Express

19 Description: Allows to qualify transactions as recurring (RecurringType). Field reserved for recurring payments via the FISERV acquirer (First Data) in Latin America. Will be returned with the value transmitted in the request.

Type: VARCHAR | Length: 255

Possible values:
  • FIRST: first payment of a series.
  • REPEAT: nth payment of a series.

Hosted Payment Page equivalent: N/A

REST API equivalent: N/A

E.g.: FIRST

20 Description: Number of the contract signed by the buyer (PONumber). Field reserved for recurring payments in Mexico. Will be returned with the value transmitted in the request.

Type: VARCHAR | Length: 64

Hosted Payment Page equivalent: N/A

REST API equivalent: N/A

E.g.: 12345

21 Description: Return code of processing.

Type: NUMERIC | Length: 2

Values:
  • 00: Successfully processed – Payment accepted
  • 05: Successfully processed – Payment rejected
  • 30: Parameter error
  • 96: Technical error

Hosted Payment Page equivalent: N/A

REST API equivalent: N/A

Additional information is provided in field 25.

22 Description: Code sent by the bank that issued the authorization request

Type: NUMERIC | Length: 2

Hosted Payment Page equivalent: vads_auth_result

REST API equivalent: transactionDetails.cardDetails.authorizationResponse.authorizationResult

Values: See chapter conref- List of authorization return codes in appendix.

E.g.: 00

23 Description: Transaction authorization number.

Type: VARCHAR | Length: 6

Hosted Payment Page equivalent: vads_auth_number

REST API equivalent: transactionDetails.cardDetails.authorizationResponse.authorizationNumber

E.g.: 3fc116

24 Description: Authorization mode.

Type: VARCHAR | Length: 4

Values:
  • FULL: Payment authorized.
  • MARK: Payment waiting for authorization.
25

Description: Authorization date in YYYYMMDD format, written in the UTC timezone.

Type: DATE | Length: 8

Hosted Payment Page equivalent: N/A

REST API equivalent: transactionDetails.cardDetails.authorizationResponse.authorizationDate

E.g.: 20200114

26

Description: Authorization date in YYYYMMDD format, written in the UTC timezone

Type: TIME | Length: 6

Hosted Payment Page equivalent: N/A

REST API equivalent: transactionDetails.cardDetails.authorizationResponse.authorizationDate

E.g.: 142512

27 Description: Additional return code

Type: NUMERIC | Length: 2

Description:
  • Risk assessment result (specific to shops that have enabled the module). The field is empty if no verifications have been completed.
  • Populated with the position of the error field if the processing return code (position 19) is set to 30.
  • Populated with an error message field if the processing return code (position 19) is set to 96.

Hosted Payment Page equivalent: vads_extra_result

REST API equivalent: N/A

Values: See chapter Error handling.

E.g.: 00

28 Description: Payment method number.

Type: VARCHAR | Length: 36

Hosted Payment Page equivalent: vads_card_number

REST API equivalent: transactionDetails.cardDetails.pan

E.g.: 497010XXXXXX0014

29 Description: Exp. date of the payment method in the YYYYMMDD format.

Type: NUMERIC | Length: 8

Hosted Payment Page equivalent: vads_expiry_year + vads_expiry_month

REST API equivalent: transactionDetails.cardDetails.expiryYear + transactionDetails.cardDetails.expiryMonth

E.g.: 20211130

30 Description: Tax credit amount allocated to the merchant for this transaction. The amount is expressed in the smallest currency unit.

The field is empty if this data has not been returned by the acquirer.

Type: NUMERIC | Length: 12

Hosted Payment Form equivalent: vads_tax_refund_amount

REST API equivalent: transactionDetails.taxRefundAmount

E.g.: 199

31 Description: UUID (Universally Unique IDentifier) - transaction identifier.

Type: VARCHAR | Length: 32

Hosted Payment Form equivalent: vads_trans_uuid

REST API equivalent: uuid

E.g.: b7a6b9ec0a5546eebce0b0641aadf27b

32 Description: Brand of the card used for the payment.

Type: VARCHAR | Length: 255

Hosted Payment Page equivalent: vads_card_brand

REST API equivalent: effectiveBrand

E.g.: VISA

33 Description: Reserved for future use.

Type: VARCHAR | Length: 255

34 Description: Reserved for future use.

Type: VARCHAR | Length: 255

35 Description: Reserved for future use.

Type: VARCHAR | Length: 255

36 Description: Reserved for future use.

Type: VARCHAR | Length: 255

37 Description: Reserved for future use.

Type: VARCHAR | Length: 255

38 Description: Reserved for future use.

Type: VARCHAR | Length: 255

39 Description: Reserved for future use.

Type: VARCHAR | Length: 255

40 Description: Reserved for future use.

Type: VARCHAR | Length: 255

41 Description: Reserved for future use.

Type: VARCHAR | Length: 255

42 Description: Reserved for future use.

Type: VARCHAR | Length: 255

End record

Pos. Description Format Values
01 Record code n2 01
02 Total number of transmitted detail records n..6  
03 Number of successful payments n..6  
04 Number of failed payments n..6  

File sample

00;PAY;06;0;;12345678;TEST;20220303;102008;20220303;171049
02;2;20220303;102008;600001;CD;93599;978;93599;978;20220304;0;59ecb199110145338c5704505760ec31;​1999999;CX-1255;;;;;;00;0;440368;FULL;20220303;171047;00;​497010XXXXXX0014;20241130;;b7a6b9ec0a5546eebce0b0641aadf27b;VISA;;;;;;;;;;
02;2;20220303;102008;600002;CD;7590;978;7590;978;20220304;0;3d62ec7ce4b249ffb53aa105419aae82;​1999888;CX-1255;info1;info2;info3;;;00;0;3fd85e5;FULL;20200603;171049;00;​497010XXXXXX0014;20230331;;0df883069306479db3825f9da97b492d;VISA;;;;;;;;;;
02;3;20220303;102008;600003;CD;12300;858;12300;858;20220304;0;;1234567890;​CX-1256;info1;info2;info3;;;00;0;3jk34p2;FULL;20220303;171051;00;​597010XXXXXX0026;20250930;199;239b22d9e21044f6887b4aba8d2d29c2;MASTERCARD;;;;;;;;;;
01;3;3;0

© 2025 {'|'} All rights reserved to Systempaylegal
25.18-1.11