V5 Request file

Header record

Pos. Description Values
01 Record code 00
02 File type PAY
03 File version 05
04 Shop ID 12345678
05 Mode (TEST or PRODUCTION) TEST
06 Creation date In YYYYMMDD format
07 Time of creation In HHMMSS format
08 Requested execution date.

Reserved for future use.

Do not populate

Detail record

IMPORTANT

The number of records present in the file directly affects the amount of time it will take to process the file as well as the availability of the return file.

Beyond 2000 records, it is recommended to generate several payment files.

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 Page equivalent: vads_trans_id

REST API equivalent: N/A

E.g.: 000001

06 Description: Transaction type

Type: VARCHAR | Length: 2

Value: CD

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

Type: NUMERIC | Length: 13

Hosted Payment Page equivalent: vads_amount

REST API equivalent: amount

E.g.: 4525 for EUR 45.25

01 Description: Record code.

Type: NUMERIC | Length: 2

Value: 02

09 Description: Requested capture date in the YYYYMMDD format. Leave empty to indicate the current date.

Type: NUMERIC | Length: 8

Hosted Payment Page equivalent: N/A

REST API equivalent: N/A

E.g.: 20200603

10 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
  • Empty: for using the default validation mode.

E.g.: 0

11 Description: Token or to debit.

Type: VARCHAR | Length: 50

Hosted Payment Page equivalent: vads_identifier

REST API equivalent: paymentMethodToken

E.g.: 59ecb199110145338c5704505760ec31

12 Description: The Merchant ID to be used. Leave empty for using the default contract.

Type: VARCHAR | Length: 128

Hosted Payment Page equivalent: vads_contracts

REST API equivalent: cardOptions.mid

E.g.: 1234567

13 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

14 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

15 Description: Order details 2.

Type: VARCHAR | Length: 255

Hosted Payment Page equivalent: vads_order_info2

REST API equivalent: metadata.orderInfo2

E.g.: No elevator

16 Description: Order details 3.

Type: VARCHAR | Length: 255

Hosted Payment Page equivalent: vads_order_info3

REST API equivalent: metadata.orderInfo3

E.g.: Express

17 Description: Allows to qualify transactions as recurring (RecurringType). Field reserved for recurring payments via the FISERV acquirer (First Data) in Latin America. Can be sent empty.

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

18 Description: Number of the contract signed by the buyer (PONumber). Field reserved for recurring payments in Mexico. Can be sent empty.

Type: VARCHAR | Length: 64

Hosted Payment Page equivalent: N/A

REST API equivalent: N/A

E.g.: 12345

End record

Pos. Description Values
01 Record code 01
02 Number of transmitted detail records.

It is recommended not to exceed 2000 records per file.

E.g.: 3

File sample

File name: 20200603.12345678.PAY.REQ.T.01

00;PAY;05;12345678;TEST;20200603;102008;
02;1;20200603;102008;600001;CD;1199;978;20200604;0;59ecb199110145338c5704505760ec31;;CX-1254;;;;;
02;2;20200603;102008;600002;CD;7590;978;;0;3d62ec7ce4b249ffb53aa105419aae82;1999888;CX-1255;;;;;
02;3;20200603;102008;600002;CD;1230;840;;0;;1234567890;CX-1256;info1;info2;info3;;
01;3