Are you looking for test card numbers?

Would you like to contact support?

Developer-resource icon

RefundWithData request

Mandatory sub-lines

The PaymentDetails sub-line along with either a Card or IBAN sub-line described below are mandatory when submitting a bank transfer authorisation request.

PaymentDetails

Field #

Format

Field Required

Value Required

Description

1

Fixed value: SL

-white_check_mark- -white_check_mark-

Record type identifier

2

Numeric

-white_check_mark-

-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: PaymentDetails

-white_check_mark-

-white_check_mark-

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

4

Numeric

-white_check_mark-

-white_check_mark-

Amount.

5

Numeric

-white_check_mark-

-x-

The currency exponent.

6

Alphabetic

-white_check_mark-

-white_check_mark-

The three-character ISO currency code.

7

Alphanumeric

-x- -x-

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

Required element for recurring payments and to create recurring contracts.

8

Email address

-x-

-x-

The shopper's email address.

Required element for recurring payments and to create recurring contracts.

9

Alphanumeric

-x-

-x-

Shopper statement.
The soft descriptor for the transaction.

10

IP address

-x-

-x-

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

11

Numeric

-x-

-x-

Fraud offset.
The value to be applied to offset the calculated risk score.
It can be either a positive or a negative value.

12 YYYY-MM-DD -white_check_mark- -x- The shopper's birth date.
13

Numeric

-x- -x- The shopper's social security number.
14

Allowed values:

  • NaturalPerson
  • Company
-white_check_mark- -x-

The type of the entity the payout is processed for.

15

Alphabetic

-white_check_mark- -x-

The shopper's nationality.

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

Example PaymentDetails sub-lines

The following example sub-line is valid:
SL,1,PaymentDetails,1000,2,USD,1991-01-11,NaturalPerson,US

  • It includes all the fields that are required (amount, currency exponent, ISO currency code, shopper's birth date, type of entity, shopper's nationality)
  • It contains a value for each required field (respectively: 1000, 2, USD, 1991-01-11, NaturalPerson, US)

The following example sub-line is also valid:
SL,1,PaymentDetails,1000,,USD,,,

  • It includes all the fields that are required (amount, currency exponent, ISO currency code, shopper's birth date, type of entity, shopper's nationality)
  • It contains an empty value for required fields that don't need a value (currency exponent, shopper's birth date, type of entity, shopper's nationality)

The following example sub-line is not valid:
SL,1,PaymentDetails,1000,USD

  • It doesn't include all the required fields and (empty) values.

Card

Besides the required PaymentDetails sub-line described above, a refund with data request needs to include either a Card or IBAN sub-line.

  • 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 #FormatRequiredDescription
1Fixed value: SL-white_check_mark-Record type identifier
2Numeric-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.
3Fixed value: Card-white_check_mark-Transaction type.
Defines the required field types for the specific sub-line.
4Numeric-white_check_mark-Card number.
5Numeric-white_check_mark-Expiry month.
  • Format: MM, zero-padded (eg: 03)
6Numeric-white_check_mark-Expiry year.
  • Format: YYYY (eg: 2016)
7Numeric-white_check_mark-CVC code.
  • Three-digit CVC/CVV code (Visa, Mastercard, Discover)
  • Four-digit CVC/CVV code (American Express)
8Alphanumeric-white_check_mark-Cardholder name.
9Numeric-x-Start month.
  • Format: MM, zero-padded (eg: 03)
Maestro UK only.
10Numeric-x-Start year.
  • Format: YYYY (eg: 2016)
Maestro UK only.
11Numeric-x-One-digit card issue number.
Maestro UK only.
FH,1.0,TEST,Company,TestCompany,TestRefundWithData,1,ws@Company.TestCompany,RefundWithData,FileHeaderEchoData
BH,1,BlockHeaderEchoData
L,1,MerchantAccount,TestMerchant,RefundWithData,40975
SL,1,PaymentDetails,1000,2,EUR,ShopperRef28411,test-payout@adyen.com,TESTING TX01234156XT,,,2017-01-11,123456789,NaturalPerson,NL
SL,2,Card,4111111111111111,06,2016,CardHolderName,,,
BT,1
FT,1

IBAN

Besides the required PaymentDetails sub-line described above, a refund with data request needs to include either a Card or IBAN sub-line.

  • 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.