Line authorisation

Authorisations requests can be submitted in a Batch file for the following payment methods

  1. SEPA direct debits
  2. Credit cards

SEPA Direct Debit (SEPA DD) fields

These are the fields for the payment method "sepadirectdebit" (field # 4).

Field Number Format Required Description

12

[A-z0-9-. ]+

(tick)

The bank account IBAN code.

13

[A-z0-9-. ]+

(tick)

The name of the bank account holder.

14

[A-Z]{2}

(tick)

The country value format needs to adhere to the ISO 3166-1 alpha-2 standard. An invalid country code results in a transaction/request rejection. You can look up country codes on the ISO web site.

Example

L,1,TestMerchant,sepadirectdebit,1999,EUR,DD5401,user10,j.janssen@test.com,Test Product 6,,NL13TEST0123456789,Jan Janssen,NL,L

Credit card fields

These are the fields for the payment method "card" (field # 4).

Field Number Format Required Description

12

[0-9]+

(tick)

The card number. Do not use any separators.

13

[0-9]{2}

(tick)

The card expiry month.

Format: 2 digits, zero-padded for single digits. For example:

  • 03 = March
  • 11 = November

14

[0-9]{4}

(tick)

The card expiry year.

Format: 4 digits. For example: 2018.

15

[0-9]{3,4}

(tick)

The card verification code. Depending on the card brand, it is known also as:

  • CVV2/CVC2 – length: 3 digits
  • CID – length: 4 digits

16

Any characters

(tick)

The name of the card holder, as printed on the card.

17

[0-9]{2}

(error)

Start month (Maestro UK/Solo only) (e.g. 06)

18

[0-9]{4}

(error)

Start year (Maestro UK/Solo only) (e.g. 2009)

19

[0-9]{1}

(error)

Issue number (Maestro UK/Solo only)

20

Any characters

(error)

Billing address street

21

Any characters

(error)

Billing address house number or name

22

Any characters

(error)

Billing address city

23

Any characters

(error)

Billing address ZIP/postal code

24

Any characters

(error)

Billing address province/county

25

[A-Z]{2}

(error)

Billing address country code (ISO, e.g. GB,NL)

Example:

L,1,TestMerchant,card,1999,EUR,DD5401_22,user10,r.johnson@test.com,Test Product 6,,4111111111111111,08,2018,737,R. JOHNSON,,,,Marylebone High Street,11,London,W1U 4RY,London,GB,L
When supplying billing address you must either populate all the billing address fields or none. A partially filled address fails validation and is not processed correctly.