No momento, esta página não está disponível em português
Developer-resource icon

Payout request

Mandatory sub-lines

The PayoutDetails and Recurring sub-lines described below are mandatory when submitting a payout authorisation request. You also need to include either a  Card BankAccount , or  IBAN  sub-line on your payout request.

PayoutDetails

Field #

Format

Required

Description

1

Fixed value: SL

-white_check_mark-

Record type identifier

2

Numeric

-white_check_mark-

SL sub-line record number reference within its parent line.
The counter starts at 1, and it increments sequentially by one unit.

3

Fixed value: PayoutDetails

-white_check_mark-

Transaction type.
Defines the required field types for the specific sub-line.

4

Numeric

-white_check_mark-

Amount.

5

Numeric

-white_check_mark-

The currency exponent.

6

Alphabetic

-white_check_mark-

The three-character ISO currency code.

7

Alphanumeric

-white_check_mark-

A shopper's reference, which is the unique identifier for a shopper.

8

Email address

-white_check_mark-

The shopper's email address.

9

Alphanumeric

-x-

Shopper statement.
The soft descriptor for the transaction.

10

IP address

-x-

The IP address the shopper used to carry out the transaction.

11

YYYY-MM-DD

-white_check_mark-

The shopper's birth date.

12

Numeric

-x-

The shopper's social security number.

13

Allowed values:

  • NaturalPerson
  • Company

-white_check_mark-

The type of the entity the payout is processed for. 

14

Alphabetic

-white_check_mark-

The shopper's nationality.A valid value is an ISO 2-character country code (e.g. 'NL').

Recurring

Field # Format Required Description
1 Fixed value: SL -white_check_mark- Record type identifier
2 Numeric -white_check_mark- SL sub-line record number reference within its parent line.The counter starts at 1, and it increments sequentially by one unit.
3 Fixed value: Recurring -white_check_mark- Transaction type.
Defines the required field types for the specific sub-line.
4 Fixed value: PAYOUT -white_check_mark- The type of recurring payment.
5 Fixed value: Latest -white_check_mark- Fixed value.

Card

Besides the required PayoutDetails and Recurring sub-lines described above, a payout request needs to include either a CardBankAccount, or IBAN payment method.

For this payout, you need a user role with permission to store payout details.

  • This sub-line holds information about card payments.
  • In an authorization request for card payments, the Card sub-line needs to be submitted as sub-line 2.

Field #

Format

Required

Description

1

Fixed value: SL

-white_check_mark-

Record type identifier

2

Numeric

-white_check_mark-

`SL` sub-line record number reference within its parent line.
The counter starts at 1, and it increments sequentially by one unit.

3

Fixed value: Card

-white_check_mark-

Transaction type.
Defines the required field types for the specific sub-line.

4

Numeric

-white_check_mark-

Card number.

5

Numeric

-white_check_mark-

Expiry month.

  • Format: MM, zero-padded (eg: 03)

6

Numeric

-white_check_mark-

Expiry year.

  • Format: YYYY (eg: 2016)

7

Numeric

-white_check_mark-

CVC code.

  • Three-digit CVC/CVV code (Visa, Mastercard, Discover)
  • Four-digit CVC/CVV code (American Express)

8

Alphanumeric

-white_check_mark-

Cardholder name.

9

Numeric

-x-

Start month.

  • Format: MM, zero-padded (eg: 03)

Maestro UK only.

10

Numeric

-x-

Start year.

  • Format: YYYY (eg: 2016)

Maestro UK only.

11

Numeric

-x-

One-digit card issue number.

Maestro UK only.

FH,1.0,TEST,Company,TestCompany,Default,1,storeToken@Company.TestCompany,Payout,FileHeaderEchoData 
BH,1,BlockHeaderEchoData
L,1,MerchantAccount,TestMerchant,Payout,MerchantReference,
SL,1,PayoutDetails,1000,2,EUR,ShopperRef28411,test-payout@test.com,TESTING TX01234156XT,10.0.0.1,2017-01-11,123456789,NaturalPerson,NL
SL,2,Card,4444333322221111,12,2012,J. de Tester,,,
SL,3,Recurring,PAYOUT,LATEST
BT,1 
FT,1

BankAccount

Besides the required PayoutDetails and Recurring sub-lines described above, a payout request needs to include either a CardBankAccount, or IBAN payment methods.

For this payout, you need a user role with permission to store payout details.

  • This sub-line holds information about bank transfer payments carried out using the shopper's bank account details.
  • In an authorisation request for bank account payments, the BankAccount sub-line needs to be submitted as sub-line 2.

Field #

Format

Required

Description

1

Fixed value: SL

-white_check_mark-

Record type identifier

2

Numeric

-white_check_mark-

SL sub-line record number reference within its parent line.
The counter starts at 1, and it increments sequentially by one unit.

3

Fixed value: BankAccount

-white_check_mark-

Transaction type.
Defines the required field types for the specific sub-line.

4

Alphanumeric

-white_check_mark-

Bank account owner name.

5

Alphabetic

-white_check_mark-

Two-letter country code.
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 website.

6

Numeric

-white_check_mark-

Bank account number.

7

Alphabetic

-white_check_mark-

Two-letter bank location.

  • Format: AA

8

Alphabetic

-white_check_mark-

Two-letter bank name.

  • Format: AA

9

Numeric

-white_check_mark-

Bank code.

10

Alphabetic

-x-

Two-letter check code.

  • Format: AA

FH,1.0,TEST,Company,TestCompany,Default,1,storeToken@Company.TestCompany,Payout,FileHeaderEchoData 
BH,1,BlockHeaderEchoData
L,1,MerchantAccount,TestMerchant,Payout,MerchantReference,
SL,1,PayoutDetails,1000,2,EUR,ShopperRef28411,test-payout@test.com,TESTING TX01234156XT,10.0.0.1,2017-01-11,123456789,NaturalPerson,NL
SL,2,BankAccount,Simon Hopper,SE,123456789,20010020,Postbank Stockholm,3125876,Hameln
SL,3,Recurring,PAYOUT,LATEST
BT,1 
FT,1

IBAN

Besides the required PayoutDetails and Recurring sub-lines described above, a payout request needs to include either a CardBankAccount, or IBAN payment methods.

For this payout, you need a user role with permission to store payout details.

  • This sub-line holds information about bank transfer or SEPA Direct Debit (DD) payments carried out using the shopper's IBAN details.
  • In an authorization request for IBAN payments, the IBAN sub-line needs to be submitted as sub-line 2.
Field # Format Required Description
1 Fixed value: SL -white_check_mark- Record type identifier
2 Numeric -white_check_mark- SL sub-line record number reference within its parent line.The counter starts at 1, and it increments sequentially by one unit.
3 Fixed value: IBAN -white_check_mark- Transaction type.
Defines the required field types for the specific sub-line.
4 Alphanumeric
Cannot be only numbers. Minimum three characters.
-white_check_mark- Bank account owner name.
If provided details don't match the required format, the response returns the error message: 203 'Invalid bank account holder name'.
5 Alphabetic -white_check_mark- Two-letter country code.
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 website.
6 Alphanumeric -white_check_mark- IBAN code.
7 Alphanumeric -x- BIC code.
FH,1.0,TEST,Company,TestCompany,Default,1,storeToken@Company.TestCompany,Payout,FileHeaderEchoData 
BH,1,BlockHeaderEchoData
L,1,MerchantAccount,TestMerchant,Payout,MerchantReference,
SL,1,PayoutDetails,1000,2,EUR,ShopperRef28411,test-payout@test.com,TESTING TX01234156XT,10.0.0.1,2017-01-11,123456789,NaturalPerson,NL
SL,2,IBAN,A. Klaassen,NL,NL13TEST0123456789,
SL,3,Recurring,PAYOUT,LATEST
BT,1 
FT,1