Letzte Aktualisierung 29/10/2014

2. File format: Upload

The following section contains the standard transaction file formatting rules. If you are using another specific format compatible with our system, go to Other file formats.

2.1 General

A payment file should be formatted in compliance with the following few basic rules:

  • The file should be an ASCII text file
  • One line per order. The lines are separated by the Carriage Return and Line Feed characters (ASCII : 13 10 – HEX : 0xD 0xA)
  • The fields must be separated by a semicolon (“;”)
  • The fields themselves cannot contain any semicolons (“;”)

For new transactions (ATR), we automatically split files that are larger than 2750 lines/transactions. If this is not yet the case for your account, please ask unsere Kundendienst to enable this functionality for you.

For maintenance transactions (MTR), we don't split files, so the amount of lines should be limited to 30 000. However, to ensure that your files get processed swiftly, we recommend you limit each file to 2,500 lines.

2.2 File fields

2.2.1 Layout

A standard batch file has the following transaction layout:

Field no.
Field Description
Amount to be paid MULTIPLIED BY 100 since the format of the amount must not contain any decimals or other separators.
ISO alpha order currency code, for example: EUR, USD, GBP, CHF, etc.
Card brand (See Appendix 3 for non-credit card payment methods).
Card/account number.
Expiry date (MM/YY or MMYY).
Your unique order number (merchant reference).
Order description.
Customer name.
Our system’s unique transaction reference.

The payment procedure you have configured in the "Global transaction parameters" tab, "Default operation code" section of the Technical Information page will define your default transaction operation. When you send an operation value in the Operation field in your batch, this will overwrite the default value.

Possible values for new orders:

  • RES: request for authorisation
  • SAL: request for direct sale (payment)
  • RFD: refund, not linked to a previous payment, i.e. not a maintenance operation on an existing transaction (you cannot use this operation without specific permission from your acquirer).


  • PAU: Request for pre-authorisation
      In agreement with your acquirer you can use this operation code to temporarily reserve funds on a customer's card. This is a common practice in the travel and rental industry.
      PAU/pre-authorisation can currently only be used on MasterCard transactions and is supported by selected acquirers. This operation code cannot be set as the default in your Ingenico ePayments account.
      Should you use PAU on transactions via acquirers or with card brands that don't support pre-authorisation, these transactions will not be blocked but processed as normal (RES) authorisations.

Please note that refunds submitted via Batch are not processed until the following day (after the acquirer cut-off time set in your account).

See here for the possible values for maintenance operations.
Authorisation code, not received via our system.
The way in which the authorisation code in field 11 was received. Possible value: ‘TEL’ for telephone
The date/time when the authorisation code in field 11 was received. (MM/DD/YY hh:mm:ss)
Your affiliation name in our system.
Reference grouping several orders together, allows you to request a maintenance operation on all these transactions at a later time.
Blank fields
Customer’s street name and number.
Customer’s postcode.
Customer’s town/city name.
Customer’s country.
Customer’s telephone number.
Card Verification Code (Card Verification Value).
Blank fields

35 ECI

Electronic Commerce Indicator. You can configure a default ECI value in the "Global transaction parameters" tab, "Default ECI value" section of the Technical Information page. When you send an ECI value in the ECI field in your batch, this will overwrite the default ECI value.

0 - Swiped

1 - Manually keyed (MOTO, card not present)

2 - Recurring payments, originating from MOTO

3 - Installment payments

7 - E-commerce with SSL encryption

9 - Recurring after first e-commerce transaction

...  Blank fields ...

The following parameters are relevant within the scope of the Credential-on-File guideline (COF) by the payment schemes Visa / MasterCard. Detailed information on their usage can be found in dedicated chapter Alias creation and usage within Credential-on-File guideline (COF).

Field #


52  COF_INITIATOR* Values: 

CIT - A transaction initiated by a cardholder 
MIT - A transaction initiated by a merchant

FIRST - First of a series of transactions
SUBSEQ - Subsequent series of transactions
54 COF_SCHEDULE* Values: 

SCHED - A scheduled transaction
UNSCHED - An unscheduled transaction
55 Blank field ...
56  COF_RECURRING_EXPIRY* currently available in TEST only
End date : date of the last scheduled payment of a series

YYYYMMDD (i.e. 20190914)
57 COF_RECURRING_FREQUENCY* currently available in TEST only
Days between payments for a scheduled series.

numeric between 2 and 4 digits (i.e. 31, 031 or 0031)
* Please send the parameter values according to the format as defined in the table. Otherwise the transaction will be blocked by our system.

Additional fields may also be optionally sent by merchants who have activated certain options/functionalities in their accounts. Please refer to the respective option documentation for more information on additional fields linked to the option.

2.2.2 Minimum required fields for new transactions

This section only applies to new transactions. Go to Maintenance operations for more information on maintenance operations on existing transactions.

General: new transaction

For new transactions that you would like to enter into our system, the minimum fields required at the transaction level are:

  • Amount (field 1 in the file layout)
  • Currency (field 2)
  • Card (or account) number (field 4)
  • Expiry date (field 5)
  • CVC (field 27) (this field is required depending on your acquirer and the ECI value for your transactions)
  • Your order reference (field 6)
  • Operation (field 10)


General: new transaction

10000;EUR;;4111111111111111;11/12;Order0001;;Paul Smith;;SAL;;;;;;;;;;;;;;;;;123;

9500;EUR;;5399999999999999;11/10;Order0002;;Jane Doe;;SAL;;;;;;;;;;;;;;;;;485;

2050;EUR;;4444333322221111;11/09;Order0003;;John Doe;;SAL;;;;;;;;;;;;;;;;;875; 

Exception: authorisations received via an alternative channel

When a (related) transaction does not yet exist in our system, the minimum fields required at the transaction level for authorisations received via an alternative channel (e.g. an authorisation received by phone with your acquirer) are:

  • Amount (field 1 in the file layout).
  • Currency (field 2).
  • Card (or account) number (field 4).
  • Expiry date (field 5).
  • Your order reference (field 6).
  • Card (account) holder name (field 8).
  • Operation (field 10).
  • Authorisation code (field 11).
  • Authorisation mode (field 12).
  • Authorisation date (field 13).


Exception: authorisation already received through an alternative channel

1000;EUR;;4111111111111111;11/12;Order0001;;Paul Smith;;IMP;43785;TEL;08/08/07 15:15:52;

9500;EUR;;5399999999999999;11/10;Order0002;;Jane Doe;;IMP;83145;TEL;08/08/07 15:21:45;

2050;EUR;;4111111111111111;11/09;Order0003;;John Doe;;IMP;73586;TEL;08/08/07 15:26:12;

2.2.3 Magstripe/swipe transactions

For transactions accepted inflight through magnetic stripe/swipe, "TRACK2" data can be sent in line 42 of a batch file.

TRACK2 is a track read by ATMs and credit card checkers. It contains the cardholder's account, encrypted PIN, and other discretionary information. 

2.3 Headers and Footer

You will need to use the headers and the footer if you are uploading your files automatically or sending maintenance operations in your file.

There are two headers: OHL containing login information and OHF containing general file information. The headers have to be entered in the first lines of the file, before the actual payment data.

There is one general file footer called OTF. The file footer has to be entered as the last line of the file, after the actual payment data. The footer layout is simply “OTF;”.

The following example shows a file containing both headers and footer. In the following sections, we will take a closer look at the layout of the login information and file information headers.




10000;EUR;;4111111111111111;11/12;Order0001;golf balls;Paul Smith;;RES;;;;;;;;;;;;;;;;;;123;

9500;EUR;;5399999999999999;11/10;Order0002;mobile phone;Jane Doe;;RES;;;;;;;;;;;;;;;;;;485;


2.3.1 OHL: Login information header

Only use a Login Header when you are uploading your files automatically (exception: manual file upload on a Group).

Login Header layout:


Fixed value, indicating this is a header containing login information
Your affiliation name in our system
The password belonging to your user (> USERID)
Only applicable for Group structures, value: MGID
Your (API) user (please refer to the User Manager documentation for more information on API users)

The fields you fill in will depend on whether you use the login details from:

  • Your PSPID and a USERID
  • A Group: when you have a “Group” structure and you want to send a file containing transactions for more than one PSPID belonging to your group, the login details need to contain a (default) PSPID that belongs to your group and a “Group” level user (as opposed to a user belonging to a specific PSPID).

We will illustrate this in the following examples:


Merchant login header

Mike has a PSPID called MilkyMike. He wants to submit his files automatically from an application at his end. To do this, he has created an API user called MikeAPI in his account, with A78H29U41 for the password. His login header would be:


Group login header

John Doe Trading has 3 different PSPIDs: JohnUK, JohnUS and JohnAU. They have a group structure, called JohnDGroup, grouping the 3 PSPIDs together. In JohnDGroup, they have created an API user called JohnUser1 with MySecret12 for the password.

John wants to automatically submit a file containing transactions for the 3 different PSPIDs. He has the most transactions in the UK. This is what his login header will look like:


2.3.2 OHF: File information header

File Header layout:


Fixed value, indicating this is a header containing general file information
Mandatory reference (name) for the file, freely definable. You can use this reference to look up your file afterwards. (max. 50 characters)

Possible values:

  • ATR: code for new orders (transactions)
  • MTR: code for maintenance operations on existing transactions
Any file you upload is automatically an ATR file unless you specify otherwise in the file header.

For new orders: left blank, RES, SAL, RFD

For maintenance operations: REN, DEL, DES, SAL, SAS, RFD, RFS

(Go to File fields and File specifics for operation explanations)

The OPERATION parameter at the file level can be overwritten by the OPERATION parameter at transaction level.

Number of payments in the file. Numeric. Mandatory unless you are using a file footer (in which case we still suggest you use this field).


File information header for new orders

Jane has a file called Membership0607 containing 86 requests for authorisation. Her file information header would be:


File information header for maintenance transactions

Mike has a file called RefundsJune containing 9 (final) refunds. His file information header would be:


The login and file information details can be transmitted in file headers, as illustrated above, or as parameters in HTTP POST requests (only for automatic file upload).

Diese Website verwendet Cookies, um Ihnen die beste Nutzer-Erfahrung zu geben. Wenn Sie Cookies nicht akzeptieren möchten, empfehlen wir Ihnen, Ihre Cookie-Einstellungen zu ändern. Klicken Sie auf "Akzeptieren", um alle Cookies von dieser Website zu ermöglichen.


Cookies werden verwendet, um die Webseite zu verbessern und Informationen anzubieten, die für Sie von Interesse sind.

Funktionsbezogene Cookies

Funktionsbezogene Cookies sind für das ordnungsgemäße Funktionieren der Webseite nötig. Diese Cookies können nicht deaktiviert werden.


Optimierungscookies ermöglichen es uns, die Nutzung der Webseite zu analysieren, damit wir unsere Webseite bewerten und verbessern können.
Dies ist der Standardwert.


Personalisierte Cookies werden für Soziale Medien und die erweiterte Personalisierung verwendet. Sie ermöglichen es uns, Ihnen Informationen bezüglich Ihres Unternehmens zu zeigen.

Beispiel für unterstützte Funktionen

  • Ländereinstellung speichern
  • Spracheinstellung speichern

Beispiel für eine unerlaubte Funktion

  • Personenbezogene Daten über Ihren Besuch speichern
  • anonymes Tracking über Google Analytics
  • Tracking zum Zweck der Weitervermarktung

Beispiel für unterstützte Funktionen

  • Ländereinstellung speichern
  • Spracheinstellung speichern
  • Anonymes Tracking über Google Analytics

Beispiel für eine unerlaubte Funktion

  • Personenbezogene Daten über Ihren Besuch speichern
  • Tracking zum Zweck der Weitervermarktung

Beispiel für unterstützte Funktionen

  • Ländereinstellung speichern
  • Spracheinstellung speichern
  • Anonymes Tracking über Google Analytics
  • Auf Ihre Interessen abgestimmte Inhalte bereitstellen
  • Auf Ihre Interessen abgestimmte Inserate bereitstellen
  • Tracking zum Zweck der Weitervermarktung

Beispiel für unerlaubte Funktionen

  • Personenbezogene Daten speichern