Bank card integration

3DSECURE boolean

Ask for a 3-D Secure V1 authentication.

Example: true

3DSECUREDISPLAYMODE main,popup,top,raw

Define the 3-D Secure authentication page display mode:
main: in the current frame;
popup: in a browser popup;
top: in the parent frame (useful in case of iframe integration);
raw: to handle the redirection by yourself.

Example: main

ALIAS string(1-40)

Identifier of a previously processed payment method.

Example: A1-fc5bafe3-8c12-4314-95c7-2e15ec3220e0

ALIASMODE oneclick, subscription

Indicates the ALIAS usage mode:
oneclick indicates a one click or an online transaction;
subscription indicates an offline transaction.

Example: oneclick

AMOUNT integer

The transaction amount in the smallest money decimal (e.g. cents for euro).

Example: 1000

AMOUNTS hash

A hash of keys / values where keys are dates and values are the amounts to process:
Dates have to be in format YYYY-MM-DD;
Amounts in the smallest money decimal (e.g. cents for euro);
See the dedicated section.

Example: {#<Date: 2016-01-01 ((2457389j,0s,0n),+0s,2299161j)>=>50000, #<Date: 2016-02-01 ((2457420j,0s,0n),+0s,2299161j)>=>20000, #<Date: 2016-03-01 ((2457449j,0s,0n),+0s,2299161j)>=>10000}

BILLINGADDRESS string(1-50)

The billing address. Be careful not to integrate any line breaks.

Example: 285 Fulton Street

BILLINGCITY string(1-255)

The billing city.

Example: New York

BILLINGCOUNTRY string(2)

The country code (ISO_3166-1_alpha-2).

Example: US

BILLINGFIRSTNAME string(1-15)

The first name part of the billing address.

Example: John

BILLINGLASTNAME string(1-15)

The last name part of the billing address.

Example: Doe

BILLINGPHONE string(1-32)

Billing phone number in international (E.164) format.

Example: +33111111111

BILLINGPOSTALCODE string(1-9)

The billing postal code.

Example: 10007

CARDFULLNAME string(1-255)

The holder’s full name (as described on the payment method). For 3-D Secure operations, the field CARDFULLNAME can only contain the following characters : [a-zA-Z1-9 -]

Example: JOHN SNOW

CARDFULLNAME string(1-255)

The holder’s full name (as described on the payment method). For 3-D Secure operations, the field CARDFULLNAME can only contain the following characters : [a-zA-Z1-9 -]

Example: JOHN SNOW

CART[X][BRAND] string(1-100)

Article brand.

Example: Micropple

CART[X][CATEGORY] computersandsoftware, electronics, appliances, homeandgarden, fashion, healthandbeauty, jewellery, sport, leisureandhobbies, carsandmotorbikes, furniture, kidsandbaby, videogamesandconsoles, toysandgames, pets, foodanddrink, giftandflowers, entertainment, travel, auctionsandgroupbuying, servicesforindividuals, servicesforprofessionals

Article category.

Example: electronics

CART[X][DELIVERYEXPECTEDDATE] date(YYYY-MM-DD)

Delivery Date.

Example: 2017-06-20

CART[X][DELIVERYEXPECTEDDELAY] int (1-3)

Number of days for delivery; must be greater than 0.

Example: 2

CART[X][DELIVERYLABEL] string(1-100)

Delivery method name or description.

Example: Micropple store

CART[X][DELIVERYSPEED] standard,express

Speed of the delivery method. (Specify EXPRESS if under 48h).

Example: express

CART[X][DELIVERYTYPE] storepickup, networkpickup, travelpickup, billingaddress, carrier, edelivery, other

Delivery method:

storepickup: collection of the goods in the merchant store
networkpickup: collection in a third party point (like ups, alveol, etc.)
travelpickup: collection in an airport, train station or travel agency
billingaddress: carrier such as La Poste, Colissimo, UPS, DHL…or any private carrier using billing address
carrier: carrier such as La Poste, Colissimo, UPS, DHL…or any private carrier using shipto address
edelivery: electronic ticket issuance, download, etc.

Example: storepickup

CART[X][DISCOUNT] float

Applied discount in percentage. The decimal separator is the dot symbol.

Example: 10.5

CART[X][FEES] integer

Marketplace fees in cents.

Example: 2000

CART[X][MERCHANTITEMID] string

Item ID in the merchant system.

Example: REF-123456

CART[X][NAME] string

Item name.

Example: Laser printer

CART[X][PRICE] int

Unit price in cents, including potential taxes and discounts.

Example: 20000

CART[X][QUANTITY] integer

Quantity of this item.

Example: 3

CART[X][SUBMERCHANTEXTERNALID] string(1-64)

Submerchant account identifier in the marketplace. This field allow a special value “OPERATOR” when the item is sold by the marketplace itself (and not a sub-merchant).

Example: shop1.com

CART[X][TAX] float

Applied taxes in percentage. The decimal separator is the dot symbol.

Example: 19.5

CART[X][TOTALAMOUNT] integer

Total amount based on PRICE, QUANTITY. Also FEES when applied.

Example: 60000

CLIENTADDRESS string(1-510)

The user’s address.

Example: 285 Fulton Street.

CLIENTDOB date(YYYY-MM-DD)

The user’s date of birth.

Example: 1982-06-20

CLIENTEMAIL email(5-255)

The user’s email.

Example: john.snow@example.com

CLIENTIDENT string(1-255)

Unique identifier of the user in your application (e.g. a login or a primary key).

Example: john.snow

CLIENTIP ipv4

The user’s public IP address.

Example: 10.1.1.1

CLIENTREFERRER string(1-255)

The user’s HTTP referrer URL.

Example: https://your_shop.com/order?id=1234

CLIENTUSERAGENT string(1-255)

The HTTP user agent.

Example: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:47.0) Gecko/20100101 Firefox/47.0

CREATEALIAS boolean

Ask for a payment method ALIAS creation. Caution: this parameter is mutually exclusive with DISPLAYCREATEALIAS. See the dedicated section.

Example: true

DESCRIPTION string(1-510)

A short description of the operation, can be used to trigger fraud actions. Don’t hesitate to ask your Payment Manager for some advice on this topic.

Example: Knows nothing

DESCRIPTOR string

The transaction label sent to the bank network. The transaction will display with this label on the user’s bank statement.

Example: myshop.com

DISPLAYCREATEALIAS boolean

Display a checkbox on the hosted form to ask the user to save his card data for future usage. Caution: this parameter is mutually exclusive with CREATEALIAS. See the dedicated section.

Example: true

EXTRADATA string(1-255)

Free field (Dalenys will send you back the content of the EXTRADATA you specified ahead).

Example: referrer=myshop.com;order=premium

HASH string(64)

The transaction’s hash as described in the dedicated section.

Example: 15477dcb8687adf90fa51e418f3c1a2d025f40b177a978c2734514734633b3c4

HFTOKEN string(1-36)

A token to use with hosted fields integration. This token replaces card holder data in a hosted field payment request.

Example: 17730892-b3f7-4411-bc81-557471ffcede

HIDECARDFULLNAME no, yes

Hide the fullname input on the hosted form. You must supply the CARDFULLNAME. See the dedicated section for more informations.

Example: true

HIDECLIENTEMAIL no, yes

Hide the CLIENTEMAIL input on the hosted form. You must supply the CLIENTEMAIL. See the dedicated section for more informations.

Example: true

IDENTIFIER string(1-32)

Your processing account technical identifier.

Example: Demo Shop

INITIALSCHEMETRANSACTIONID string(1-55)

Card scheme transaction identifier (Mastercard Trace-ID or Visa Transaction ID). Submit the original scheme transaction ID of the initial recurring payment. If provided by the card scheme, the original scheme transaction ID will be returned in the transaction notification in “SCHEMETRANSACTIONID” field.

Example: 2MCGNM21OX0729

LANGUAGE fr, en, de, es, it, nl, zh, ru, pt, sk

Configure the hosted form display language.

Example: en

METADATA string(1-255)

Additional transactional data. Contact your account manager for more informations.

Example: @METADATA-MYWEBSITE

OPERATIONTYPE payment,authorization

The action you want to process.

Example: payment

ORDERID string(1-40)

Unique ID associated to an order in the merchant’s database (as specified in your initial POST request)

Example: 1234

SELECTEDBRAND cb, visa, vpay, electron, mastercard, maestro

Preferred brand. (Please see the dedicated documentation)

Example: cb

SHIPTOADDRESS string(1-50)

The shipping address.

Example: 55 rue de la liberté

SHIPTOCOUNTRY string(2)

The country code (ISO_3166-1_alpha-2 format)

Example: US

SHIPTOFIRSTNAME string(1-15)

Holder’s first name in the shipping address.

Example: John

SHIPTOLASTNAME string(1-30)

Holder’s last name in the shipping address.

Example: Doe

SHIPTOPHONE string(1-32)

Shipping phone number in international (E.164) format.

Example: +33111111111

SHIPTOPOSTALCODE string(1-9)

The shipping postal code.

Example: 10007

SUBMERCHANTEXTERNALID string(1-64)

Submerchant account identifier in the marketplace. This field allow a special value “OPERATOR” when the item is sold by the marketplace itself (and not a sub-merchant).

Example: shop1.com

TIMEZONE string(1-128)

Timezone / default value : UTC. Please see the Data sheet dedicated list of available timezones.

Example: Europe/Paris

TRANSACTIONEXPIRATIONDATE datetime(yyyy-MM-dd HH:mm:ss)

Form expiration date. By default, the date is UTC, the timezone can be specified by using the TIMEZONE parameter.

Example:

VERSION 3.0

The API protocol version.

Example: 3.0

ALIAS string(1-40)

Identifier of a previously processed payment method.

Example: A1-fc5bafe3-8c12-4314-95c7-2e15ec3220e0

DESCRIPTOR string

The transaction label sent to the bank network. The transaction will display with this label on the user’s bank statement.

Example: myshop.com

EXECCODE string(4)

The operation result code. (See the complete list of execution code)

Example: 0000

MESSAGE string(no length limit)

The operation result description linked to EXECCODE.

Example: The transaction has been accepted

OPERATIONTYPE payment

The action you want to process.

Example: payment

REDIRECTHTML string(no length limit)

HTML content to display to the user to continue the processing. The string is base64 encoded.

Example:

REDIRECTPOSTPARAMS string(no length limit)

The content is string URL encoded and contains the POST parameters to send to the REDIRECTURL.

Example: p1=v1&p2=v2

REDIRECTURL string(no length limit)

The url to redirect the user to continue the processing.

Example: http://some_url?p1=v1

SCHEMETRANSACTIONID string(1-55)

Scheme transaction ID, retrieved in response to the authorization request.

Example: 11034331402111290210

TRANSACTIONID string(1-32)

Unique Dalenys transaction ID. Make sure to store this ID in your database.

Example: A1123456

3DSECURE no, yes

Merchant’s request for 3D Secure authentication.

Example: true

3DSECUREAUTHENTICATIONSTATUS y, n, u, a, c, r, i, empty

Authentication status:
y: authentication successful
n: not authenticated
u: unavailable
a: attempted
c: cardholder challenge required
r: rejected
i: Informational Only
empty: no 3-D Secure

Example: y

3DSECURESIGNATURESTATUS y, n

Signature verification status. Possible values are:
y: signature is present in PARes message
n: no signature present in PARes message

Example: y

3DSGLOBALSTATUS ok, not_enrolled, unavailable, not_required, ko

Global status.

Example: ok

ALIAS string(1-40)

Identifier of a previously processed payment method.

Example: A1-fc5bafe3-8c12-4314-95c7-2e15ec3220e0

AMOUNT integer

The transaction amount in the smallest money decimal (e.g. cents for euro).

Example: 1000

CARD3DSECUREENROLLED y, n, u

Card 3-D Secure enrollment status. Possible values are:
y: Card enrolled
n: Card not enrolled
u: Enrollment unavailable

Example: y

CARDCODE string(12-19)

The last 4 digits of the card code.

Example: XXXXXXXXXXXX4444

CARDCOUNTRY string(2)

The country code (format ISO_3166-1_alpha-2).

Example: US

CARDFULLNAME string(1-255)

The holder’s full name (as described on the payment method).

Example: JOHN SNOW

CARDNETWORK VISA, AMERICAN EXPRESS, MASTERCARD, BANCONTACT, CB, UNKNOWN

The cardholder’s bank card network.

Example:

CARDTYPE string

The payment method type.

Example: VISA

CARDUSAGE enterprise, debit, credit, prepaid

Card product code.

Example:

CARDVALIDITYDATE date(MM-YY)

Card expiry date.

Example: 12-17

CHARGEBACKDATE date(YYYY-MM-DD)

Chargeback date.

Example: 2017-05-25

CHARGEBACKTYPE chargeback, representment

Chargeback type.

Example: chargeback

CLIENTEMAIL email(5-255)

The user’s email.

Example: john.snow@example.com

CLIENTIDENT string(1-255)

Unique identifier of the user in your application (e.g. a login or a primary key).

Example: john.snow

CURRENCY string(3)

Currency code (ISO 4217 format).

Example: EUR

DESCRIPTOR string

The transaction label sent to the bank network. The transaction will display with this label on the user’s bank statement.

Example: myshop.com

EXECCODE string(4)

The operation result code. (See the complete list of execution code)

Example: 0000

EXTRADATA string(1-255)

Free field (Dalenys will send you back the content of the EXTRADATA you specified ahead).

Example: referrer=myshop.com;order=premium

HASH string(64)

The transaction’s hash as described in the dedicated section.

Example: 15477dcb8687adf90fa51e418f3c1a2d025f40b177a978c2734514734633b3c4

IDENTIFIER string(1-32)

Your processing account technical identifier.

Example: YOUR_IDENTIFIER

LANGUAGE fr, en, de, es, it, nl, zh, ru, pt, sk

Configure the hosted form display language.

Example: en

MESSAGE string(no length limit)

The operation result description linked to EXECCODE.

Example: The transaction has been accepted

OPERATIONTYPE payment, authorization

The action you want to process.

Example: payment

ORDERID string(1-40)

Unique ID associated to an order in the merchant’s database (as specified in your initial POST request)

Example: 1234

SCHEMETRANSACTIONID string(1-55)

Scheme transaction ID, retrieved in response to the authorization request.

Example: 11034331402111290210

SELECTEDBRAND cb, visa, vpay, electron, mastercard, maestro

Preferred brand.

Example: CB

STAN int(6)

System Trace Audit Number.

Example: 123456

TAGS string(no max length)

Tags set by the Dalenys’s rule engine

Example: POTENTIAL FRAUD=Volume&TO BE CHECKED=Custom 1

TRANSACTIONID string(1-32)

Unique Dalenys transaction ID. Make sure to store this ID in your database.

Example: A1123456

VERSION 3.0

The API protocol version.

Example: 3.0

ALIAS string(1-40)

Identifier of a previously processed payment method.

Example: A1-fc5bafe3-8c12-4314-95c7-2e15ec3220e0

ALIASMODE oneclick, subscription

Indicates the ALIAS usage mode:
oneclick indicates a one click or an online transaction;
subscription indicates an offline transaction.

Example: oneclick

AMOUNT integer

The transaction amount in the smallest money decimal (e.g. cents for euro).

Example: 1000

AMOUNTS hash

A hash of keys / values where keys are dates and values are the amounts to process:
Dates have to be in format YYYY-MM-DD;
Amounts in the smallest money decimal (e.g. cents for euro);
See the dedicated section.

Example: {#<Date: 2016-01-01 ((2457389j,0s,0n),+0s,2299161j)>=>50000, #<Date: 2016-02-01 ((2457420j,0s,0n),+0s,2299161j)>=>20000, #<Date: 2016-03-01 ((2457449j,0s,0n),+0s,2299161j)>=>10000}

APIKEYID string (36)

ID used to authenticate a transaction using APIKEY.

Example: a688b3a1-d227-4cdd-9454-5d7cfcc74ef9

BILLINGADDRESS string(1-50)

The billing address. Be careful not to integrate any line breaks.

Example: 285 Fulton Street

BILLINGCITY string(1-255)

The billing city.

Example: New York

BILLINGCOUNTRY string(2)

The country code (ISO_3166-1_alpha-2).

Example: US

BILLINGFIRSTNAME string(1-15)

The first name part of the billing address.

Example: John

BILLINGLASTNAME string(1-15)

The last name part of the billing address.

Example: Doe

BILLINGPHONE string(1-32)

Billing phone number in international (E.164) format.

Example: +33111111111

BILLINGPOSTALCODE string(1-9)

The billing postal code.

Example: 10007

CARDFULLNAME string(1-255)

The holder’s full name (as described on the payment method). For 3-D Secure operations, the field CARDFULLNAME can only contain the following characters : [a-zA-Z1-9 -]

Example: JOHN SNOW

CARDFULLNAME string(1-255)

The holder’s full name (as described on the payment method). For 3-D Secure operations, the field CARDFULLNAME can only contain the following characters : [a-zA-Z1-9 -]

Example: JOHN SNOW

CART[X][BRAND] string(1-100)

Article brand.

Example: Micropple

CART[X][CATEGORY] computersandsoftware, electronics, appliances, homeandgarden, fashion, healthandbeauty, jewellery, sport, leisureandhobbies, carsandmotorbikes, furniture, kidsandbaby, videogamesandconsoles, toysandgames, pets, foodanddrink, giftandflowers, entertainment, travel, auctionsandgroupbuying, servicesforindividuals, servicesforprofessionals

Article category.

Example: electronics

CART[X][DELIVERYEXPECTEDDATE] date(YYYY-MM-DD)

Delivery Date.

Example: 2017-06-20

CART[X][DELIVERYEXPECTEDDELAY] int (1-3)

Number of days for delivery; must be greater than 0.

Example: 2

CART[X][DELIVERYLABEL] string(1-100)

Delivery method name or description.

Example: Micropple store

CART[X][DELIVERYSPEED] standard,express

Speed of the delivery method. (Specify EXPRESS if under 48h).

Example: express

CART[X][DELIVERYTYPE] storepickup, networkpickup, travelpickup, billingaddress, carrier, edelivery, other

Delivery method:

storepickup: collection of the goods in the merchant store
networkpickup: collection in a third party point (like ups, alveol, etc.)
travelpickup: collection in an airport, train station or travel agency
billingaddress: carrier such as La Poste, Colissimo, UPS, DHL…or any private carrier using billing address
carrier: carrier such as La Poste, Colissimo, UPS, DHL…or any private carrier using shipto address
edelivery: electronic ticket issuance, download, etc.

Example: storepickup

CART[X][DISCOUNT] float

Applied discount in percentage. The decimal separator is the dot symbol.

Example: 10.5

CART[X][FEES] integer

Marketplace fees in cents.

Example: 2000

CART[X][MERCHANTITEMID] string

Item ID in the merchant system.

Example: REF-123456

CART[X][NAME] string

Item name.

Example: Laser printer

CART[X][PRICE] int

Unit price in cents, including potential taxes and discounts.

Example: 20000

CART[X][QUANTITY] integer

Quantity of this item.

Example: 3

CART[X][SUBMERCHANTEXTERNALID] string(1-64)

Submerchant account identifier in the marketplace. This field allow a special value “OPERATOR” when the item is sold by the marketplace itself (and not a sub-merchant).

Example: shop1.com

CART[X][TAX] float

Applied taxes in percentage. The decimal separator is the dot symbol.

Example: 19.5

CART[X][TOTALAMOUNT] integer

Total amount based on PRICE, QUANTITY. Also FEES when applied.

Example: 60000

CLIENTADDRESS string(1-510)

The user’s address.

Example: 285 Fulton Street.

CLIENTDOB date(YYYY-MM-DD)

The user’s date of birth.

Example: 1982-06-20

CLIENTEMAIL email(5-255)

The user’s email.

Example: john.snow@example.com

CLIENTIDENT string(1-255)

Unique identifier of the user in your application (e.g. a login or a primary key).

Example: john.snow

CLIENTIP ipv4

The user’s public IP address.

Example: 10.1.1.1

CLIENTREFERRER string(1-255)

The user’s HTTP referrer URL.

Example: https://your_shop.com/order?id=1234

CLIENTUSERAGENT string(1-255)

The HTTP user agent.

Example: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:47.0) Gecko/20100101 Firefox/47.0

DESCRIPTION string(1-510)

A short description of the operation, can be used to trigger fraud actions. Don’t hesitate to ask your Payment Manager for some advice on this topic.

Example: Knows nothing

EXTRADATA string(1-255)

Free field (Dalenys will send you back the content of the EXTRADATA you specified ahead).

Example: referrer=myshop.com;order=premium

HASH string(64)

The transaction’s hash as described in the dedicated section.

Example: 15477dcb8687adf90fa51e418f3c1a2d025f40b177a978c2734514734633b3c4

HFTOKEN string(1-36)

A token to use with hosted fields integration. This token replaces card holder data in a hosted field payment request.

Example: 17730892-b3f7-4411-bc81-557471ffcede

IDENTIFIER string(1-32)

Your processing account technical identifier.

Example: Demo Shop

INITIALSCHEMETRANSACTIONID string(1-55)

Card scheme transaction identifier (Mastercard Trace-ID or Visa Transaction ID). Submit the original scheme transaction ID of the initial recurring payment. If provided by the card scheme, the original scheme transaction ID will be returned in the transaction notification in “SCHEMETRANSACTIONID” field.

Example: 2MCGNM21OX0729

METADATA string(1-255)

Additional transactional data. Contact your account manager for more informations.

Example: @METADATA-MYWEBSITE

OPERATIONTYPE authorization, payment, capture, refund, credit, void

The action you want to process.

Example: payment

ORDERID string(1-40)

Unique ID associated to an order in the merchant’s database (as specified in your initial POST request)

Example: 1234

SELECTEDBRAND cb, visa, vpay, electron, mastercard, maestro

Preferred brand. (Please see the dedicated documentation)

Example: cb

SHIPTOADDRESS string(1-50)

The shipping address.

Example: 55 rue de la liberté

SHIPTOCITY string(1-255)

The shipping city.

Example: New York

SHIPTOCOUNTRY string(2)

The country code (ISO_3166-1_alpha-2 format)

Example: US

SHIPTOFIRSTNAME string(1-15)

Holder’s first name in the shipping address.

Example: John

SHIPTOLASTNAME string(1-30)

Holder’s last name in the shipping address.

Example: Doe

SHIPTOPHONE string(1-32)

Shipping phone number in international (E.164) format.

Example: +33111111111

SHIPTOPOSTALCODE string(1-9)

The shipping postal code.

Example: 10007

TIMEZONE string(1-128)

Timezone / default value : UTC. Please see the Data sheet dedicated list of available timezones.

Example: Europe/Paris

VERSION 3.0

The API protocol version.

Example: 3.0

ALIAS string(1-40)

Identifier of a previously processed payment method.

Example: A1-fc5bafe3-8c12-4314-95c7-2e15ec3220e0

DESCRIPTOR string

The transaction label sent to the bank network. The transaction will display with this label on the user’s bank statement.

Example: myshop.com

EXECCODE string(4)

The operation result code. (See the complete list of execution code)

Example: 0000

MESSAGE string(no length limit)

The operation result description linked to EXECCODE.

Example: The transaction has been accepted

OPERATIONTYPE authorization, payment, capture, refund, credit, void

The action you want to process.

Example: payment

TRANSACTIONID string(1-32)

Unique Dalenys transaction ID. Make sure to store this ID in your database.

Example: A1123456

3DSECURE no, yes

Merchant’s request for 3D Secure authentication.

Example: true

3DSECUREAUTHENTICATIONSTATUS y, n, u, a, c, r, i, empty

Authentication status:
y: authentication successful
n: not authenticated
u: unavailable
a: attempted
c: cardholder challenge required
r: rejected
i: Informational Only
empty: no 3-D Secure

Example: y

3DSECURESIGNATURESTATUS y, n

Signature verification status. Possible values are:
y: signature is present in PARes message
n: no signature present in PARes message

Example: y

3DSGLOBALSTATUS ok, not_enrolled, unavailable, not_required, ko

Global status.

Example: ok

ALIAS string(1-40)

Identifier of a previously processed payment method.

Example: A1-fc5bafe3-8c12-4314-95c7-2e15ec3220e0

AMOUNT integer

The transaction amount in the smallest money decimal (e.g. cents for euro).

Example: 1000

CARD3DSECUREENROLLED y, n, u

Card 3-D Secure enrollment status. Possible values are:
y: Card enrolled
n: Card not enrolled
u: Enrollment unavailable

Example: y

CARDCODE string(12-19)

The last 4 digits of the card code.

Example: XXXXXXXXXXXX4444

CARDCOUNTRY string(2)

The country code (format ISO_3166-1_alpha-2).

Example: US

CARDFULLNAME string(1-255)

The holder’s full name (as described on the payment method).

Example: JOHN SNOW

CARDNETWORK VISA, AMERICAN EXPRESS, MASTERCARD, BANCONTACT, CB, UNKNOWN

The cardholder’s bank card network.

Example:

CARDTYPE string

The payment method type.

Example: VISA

CARDUSAGE enterprise, debit, credit, prepaid

Card product code.

Example:

CARDVALIDITYDATE date(MM-YY)

Card expiry date.

Example: 12-17

CHARGEBACKDATE date(YYYY-MM-DD)

Chargeback date.

Example: 2017-05-25

CHARGEBACKTYPE chargeback, representment

Chargeback type.

Example: chargeback

CLIENTEMAIL email(5-255)

The user’s email.

Example: john.snow@example.com

CLIENTIDENT string(1-255)

Unique identifier of the user in your application (e.g. a login or a primary key).

Example: john.snow

CURRENCY string(3)

Currency code (ISO 4217 format).

Example: EUR

DESCRIPTOR string

The transaction label sent to the bank network. The transaction will display with this label on the user’s bank statement.

Example: myshop.com

EXECCODE string(4)

The operation result code. (See the complete list of execution code)

Example: 0000

EXTRADATA string(1-255)

Free field (Dalenys will send you back the content of the EXTRADATA you specified ahead).

Example: referrer=myshop.com;order=premium

HASH string(64)

The transaction’s hash as described in the dedicated section.

Example: 15477dcb8687adf90fa51e418f3c1a2d025f40b177a978c2734514734633b3c4

IDENTIFIER string(1-32)

Your processing account technical identifier.

Example: YOUR_IDENTIFIER

LANGUAGE fr, en, de, es, it, nl, zh, ru, pt, sk

Configure the hosted form display language.

Example: en

MESSAGE string(no length limit)

The operation result description linked to EXECCODE.

Example: The transaction has been accepted

OPERATIONTYPE payment, authorization

The action you want to process.

Example: payment

ORDERID string(1-40)

Unique ID associated to an order in the merchant’s database (as specified in your initial POST request)

Example: 1234

SELECTEDBRAND cb, visa, vpay, electron, mastercard, maestro

Preferred brand.

Example: CB

STAN int(6)

System Trace Audit Number.

Example: 123456

TAGS string(no max length)

Tags set by the Dalenys’s rule engine

Example: POTENTIAL FRAUD=Volume&TO BE CHECKED=Custom 1

TRANSACTIONID string(1-32)

Unique Dalenys transaction ID. Make sure to store this ID in your database.

Example: A1123456

VERSION 3.0

The API protocol version.

Example: 3.0

3DSECURE boolean

Ask for a 3-D Secure V1 authentication.

Example: true

3DSECUREDISPLAYMODE main, popup, top

Define the 3-D Secure authentication page display mode:
main: in the current frame;
popup: in a browser popup;
top: in the parent frame (useful in case of iframe integration);
raw: to handle the redirection by yourself.

Example: main

AMOUNT integer

The transaction amount in the smallest money decimal (e.g. cents for euro).

Example: 1000

AMOUNTS hash

A hash of keys / values where keys are dates and values are the amounts to process:
Dates have to be in format YYYY-MM-DD;
Amounts in the smallest money decimal (e.g. cents for euro);
See the dedicated section.

Example: {#<Date: 2016-01-01 ((2457389j,0s,0n),+0s,2299161j)>=>50000, #<Date: 2016-02-01 ((2457420j,0s,0n),+0s,2299161j)>=>20000, #<Date: 2016-03-01 ((2457449j,0s,0n),+0s,2299161j)>=>10000}

APIKEYID string (36)

ID used to authenticate a transaction using APIKEY.

Example: a688b3a1-d227-4cdd-9454-5d7cfcc74ef9

BILLINGADDRESS string(1-50)

The billing address. Be careful not to integrate any line breaks.

Example: 285 Fulton Street

BILLINGCITY string(1-255)

The billing city.

Example: New York

BILLINGCOUNTRY string(2)

The country code (ISO_3166-1_alpha-2).

Example: US

BILLINGFIRSTNAME string(1-15)

The first name part of the billing address.

Example: John

BILLINGLASTNAME string(1-15)

The last name part of the billing address.

Example: Doe

BILLINGPHONE string(1-32)

Billing phone number in international (E.164) format.

Example: +33111111111

BILLINGPOSTALCODE string(1-9)

The billing postal code.

Example: 10007

CARDFULLNAME string(1-255)

The holder’s full name (as described on the payment method). For 3-D Secure operations, the field CARDFULLNAME can only contain the following characters : [a-zA-Z1-9 -]

Example: JOHN SNOW

CART[X][DISCOUNT] float

Applied discount in percentage. The decimal separator is the dot symbol.

Example: 10.5

CART[X][FEES] integer

Marketplace fees in cents.

Example: 2000

CART[X][MERCHANTITEMID] string

Item ID in the merchant system.

Example: REF-123456

CART[X][NAME] string

Item name.

Example: Laser printer

CART[X][PRICE] int

Unit price in cents, including potential taxes and discounts.

Example: 20000

CART[X][QUANTITY] integer

Quantity of this item.

Example: 3

CART[X][SUBMERCHANTEXTERNALID] string(1-64)

Submerchant account identifier in the marketplace. This field allow a special value “OPERATOR” when the item is sold by the marketplace itself (and not a sub-merchant).

Example: shop1.com

CART[X][TAX] float

Applied taxes in percentage. The decimal separator is the dot symbol.

Example: 19.5

CART[X][TOTALAMOUNT] integer

Total amount based on PRICE, QUANTITY. Also FEES when applied.

Example: 60000

CLIENTADDRESS string(1-510)

The user’s address.

Example: 285 Fulton Street.

CLIENTDOB date(YYYY-MM-DD)

The user’s date of birth.

Example: 1982-06-20

CLIENTEMAIL email(5-255)

The user’s email.

Example: john.snow@example.com

CLIENTIDENT string(1-255)

Unique identifier of the user in your application (e.g. a login or a primary key).

Example: john.snow

CREATEALIAS boolean

Ask for a payment method ALIAS creation. Caution: this parameter is mutually exclusive with DISPLAYCREATEALIAS. See the dedicated section.

Example: true

DESCRIPTION string(1-510)

A short description of the operation, can be used to trigger fraud actions. Don’t hesitate to ask your Payment Manager for some advice on this topic.

Example: Knows nothing

DESCRIPTOR string

The transaction label sent to the bank network. The transaction will display with this label on the user’s bank statement.

Example: myshop.com

DISPLAYCREATEALIAS boolean

Display a checkbox on the hosted form to ask the user to save his card data for future usage. Caution: this parameter is mutually exclusive with CREATEALIAS. See the dedicated section.

Example: true

EXTRADATA string(1-255)

Free field (Dalenys will send you back the content of the EXTRADATA you specified ahead).

Example: referrer=myshop.com;order=premium

HASH string(64)

The transaction’s hash as described in the dedicated section.

Example: 15477dcb8687adf90fa51e418f3c1a2d025f40b177a978c2734514734633b3c4

HIDECARDFULLNAME no, yes

Hide the fullname input on the hosted form. You must supply the CARDFULLNAME. See the dedicated section for more informations.

Example: true

HIDECLIENTEMAIL no, yes

Hide the CLIENTEMAIL input on the hosted form. You must supply the CLIENTEMAIL. See the dedicated section for more informations.

Example: true

IDENTIFIER string(1-32)

Your processing account technical identifier.

Example: Demo Shop

LANGUAGE fr, en, de, es, it, nl, zh, ru, pt, sk

Configure the hosted form display language.

Example: en

METADATA string(1-255)

Additional transactional data. Contact your account manager for more informations.

Example: @METADATA-MYWEBSITE

OPERATIONTYPE payment, authorization

The action you want to process.

Example: payment

ORDERID string(1-40)

Unique ID associated to an order in the merchant’s database (as specified in your initial POST request)

Example: 1234

SHIPTOADDRESS string(1-50)

The shipping address.

Example: 55 rue de la liberté

SHIPTOCOUNTRY string(2)

The country code (ISO_3166-1_alpha-2 format)

Example: US

SHIPTOFIRSTNAME string(1-15)

Holder’s first name in the shipping address.

Example: John

SHIPTOLASTNAME string(1-30)

Holder’s last name in the shipping address.

Example: Doe

SHIPTOPHONE string(1-32)

Shipping phone number in international (E.164) format.

Example: +33111111111

SHIPTOPOSTALCODE string(1-9)

The shipping postal code.

Example: 10007

SUBMERCHANTEXTERNALID string(1-64)

Submerchant account identifier in the marketplace. This field allow a special value “OPERATOR” when the item is sold by the marketplace itself (and not a sub-merchant).

Example: shop1.com

TIMEZONE string(1-128)

Timezone / default value : UTC. Please see the Data sheet dedicated list of available timezones.

Example: Europe/Paris

TRANSACTIONEXPIRATIONDATE datetime(yyyy-MM-dd HH:mm:ss)

Form expiration date. By default, the date is UTC, the timezone can be specified by using the TIMEZONE parameter.

Example:

USETEMPLATE web, mobile

Which custom payment form to use.

Example: web

VERSION 3.0

The API protocol version.

Example: 3.0

3DSECURE no, yes

3-D Secure’s status.

Example: true

3DSECUREAUTHENTICATIONSTATUS y, n, u, a, c, r, i, empty

Authentication status:
y: authentication successful
n: not authenticated
u: unavailable
a: attempted
c: cardholder challenge required
r: rejected
i: Informational Only
empty: no 3-D Secure

Example: y

3DSECURESIGNATURESTATUS y, n

Signature verification status. Possible values are:
y: signature is present in PARes message
n: no signature present in PARes message

Example: y

3DSGLOBALSTATUS ok, not_enrolled, unavailable, not_required, ko

Global status.

Example: ok

AMOUNT integer

The transaction amount in the smallest money decimal (e.g. cents for euro).

Example: 1000

CARD3DSECUREENROLLED y, n, u

Card 3-D Secure enrollment status. Possible values are:
y: Card enrolled
n: Card not enrolled
u: Enrollment unavailable

Example: y

CARDCODE string(12-19)

The last 4 digits of the card code.

Example: XXXXXXXXXXXX4444

CLIENTEMAIL email(5-255)

The user’s email.

Example: john.snow@example.com

CLIENTIDENT string(1-255)

Unique identifier of the user in your application (e.g. a login or a primary key).

Example: john.snow

CURRENCY string(3)

Currency code (ISO 4217 format).

Example: EUR

DESCRIPTOR string

The transaction label sent to the bank network. The transaction will display with this label on the user’s bank statement.

Example: myshop.com

EXECCODE string(4)

The operation result code. (See the complete list of execution code)

Example: 0000

EXTRADATA string(1-255)

Free field (Dalenys will send you back the content of the EXTRADATA you specified ahead).

Example: referrer=myshop.com;order=premium

HASH string(64)

The transaction’s hash as described in the dedicated section.

Example: 15477dcb8687adf90fa51e418f3c1a2d025f40b177a978c2734514734633b3c4

IDENTIFIER string(1-32)

Your processing account technical identifier.

Example: YOUR_IDENTIFIER

LANGUAGE fr, en, de, es, it, nl, zh, ru, pt, sk

Configure the hosted form display language.

Example: en

MESSAGE string(no length limit)

The operation result description linked to EXECCODE.

Example: The transaction has been accepted

OPERATIONTYPE authorization, payment

The action you want to process.

Example: payment

ORDERID string(1-40)

Unique ID associated to an order in the merchant’s database (as specified in your initial POST request)

Example: 1234

TRANSACTIONID string(1-32)

Unique Dalenys transaction ID. Make sure to store this ID in your database.

Example: A1123456

VERSION 3.0

The API protocol version.

Example: 3.0

3DSECURE no, yes

Merchant’s request for 3D Secure authentication.

Example: true

AMOUNT integer

The transaction amount in the smallest money decimal (e.g. cents for euro).

Example: 1000

CLIENTEMAIL email(5-255)

The user’s email.

Example: john.snow@example.com

CLIENTIDENT string(1-255)

Unique identifier of the user in your application (e.g. a login or a primary key).

Example: john.snow

CURRENCY string(3)

Currency code (ISO 4217 format).

Example: EUR

DESCRIPTION string(1-510)

A short description of the operation, can be used to trigger fraud actions. Don’t hesitate to ask your Payment Manager for some advice on this topic.

Example: Knows nothing

DESCRIPTOR string

The transaction label sent to the bank network. The transaction will display with this label on the user’s bank statement.

Example: myshop.com

EXTRADATA string(1-255)

Free field (Dalenys will send you back the content of the EXTRADATA you specified ahead).

Example: referrer=myshop.com;order=premium

HASH string(64)

The transaction’s hash as described in the dedicated section.

Example: 15477dcb8687adf90fa51e418f3c1a2d025f40b177a978c2734514734633b3c4

IDENTIFIER string(1-32)

Your processing account technical identifier.

Example: YOUR_IDENTIFIER

LANGUAGE fr, en, de, es, it, nl, zh, ru, pt, sk

Configure the hosted form display language.

Example: en

METADATA string(1-255)

Additional transactional data. Contact your account manager for more informations.

Example: @METADATA-MYWEBSITE

OPERATIONTYPE authorization, payment

The action you want to process.

Example: payment

ORDERID string(1-40)

Unique ID associated to an order in the merchant’s database (as specified in your initial POST request)

Example: 1234

VERSION 3.0

The API protocol version.

Example: 3.0

3DSECURE boolean

Ask for a 3-D Secure V1 authentication.

Example: true

3DSECUREDISPLAYMODE main,popup,top,raw

Define the 3-D Secure authentication page display mode:
main: in the current frame;
popup: in a browser popup;
top: in the parent frame (useful in case of iframe integration);
raw: to handle the redirection by yourself.

Example: main

ALIAS string(1-40)

Identifier of a previously processed payment method.

Example: A1-fc5bafe3-8c12-4314-95c7-2e15ec3220e0

ALIASMODE oneclick, subscription

Indicates the ALIAS usage mode:
oneclick indicates a one click or an online transaction;
subscription indicates an offline transaction.

Example: oneclick

AMOUNT integer

The transaction amount in the smallest money decimal (e.g. cents for euro).

Example: 1000

AMOUNTS hash

A hash of keys / values where keys are dates and values are the amounts to process:
Dates have to be in format YYYY-MM-DD;
Amounts in the smallest money decimal (e.g. cents for euro);
See the dedicated section.

Example: {#<Date: 2016-01-01 ((2457389j,0s,0n),+0s,2299161j)>=>50000, #<Date: 2016-02-01 ((2457420j,0s,0n),+0s,2299161j)>=>20000, #<Date: 2016-03-01 ((2457449j,0s,0n),+0s,2299161j)>=>10000}

APIKEYID string (36)

ID used to authenticate a transaction using APIKEY.

Example: a688b3a1-d227-4cdd-9454-5d7cfcc74ef9

BILLINGADDRESS string(1-50)

The billing address. Be careful not to integrate any line breaks.

Example: 285 Fulton Street

BILLINGCITY string(1-255)

The billing city.

Example: New York

BILLINGCOUNTRY string(2)

The country code (ISO_3166-1_alpha-2).

Example: US

BILLINGFIRSTNAME string(1-15)

The first name part of the billing address.

Example: John

BILLINGLASTNAME string(1-15)

The last name part of the billing address.

Example: Doe

BILLINGPHONE string(1-32)

Billing phone number in international (E.164) format.

Example: +33111111111

BILLINGPOSTALCODE string(1-9)

The billing postal code.

Example: 10007

CARDCODE string(12-19)

The user’s bank card’s Primary Account Number (PAN).

Example: 1111222233334444

CARDCVV string(3-4)

The user’s bank card’s cryptogram.

Example: 123

CARDFULLNAME string(1-255)

The holder’s full name (as described on the payment method). For 3-D Secure operations, the field CARDFULLNAME can only contain the following characters : [a-zA-Z1-9 -]

Example: JOHN SNOW

CARDFULLNAME string(1-255)

The holder’s full name (as described on the payment method). For 3-D Secure operations, the field CARDFULLNAME can only contain the following characters : [a-zA-Z1-9 -]

Example: JOHN SNOW

CARDVALIDITYDATE date(MM-YY)

Card expiry date. In case of Network Token Transaction, provide Network Token Expiration Date

Example: 12-17

CART[X][BRAND] string(1-100)

Article brand.

Example: Micropple

CART[X][CATEGORY] computersandsoftware, electronics, appliances, homeandgarden, fashion, healthandbeauty, jewellery, sport, leisureandhobbies, carsandmotorbikes, furniture, kidsandbaby, videogamesandconsoles, toysandgames, pets, foodanddrink, giftandflowers, entertainment, travel, auctionsandgroupbuying, servicesforindividuals, servicesforprofessionals

Article category.

Example: electronics

CART[X][DELIVERYEXPECTEDDATE] date(YYYY-MM-DD)

Delivery Date.

Example: 2017-06-20

CART[X][DELIVERYEXPECTEDDELAY] int (1-3)

Number of days for delivery; must be greater than 0.

Example: 2

CART[X][DELIVERYLABEL] string(1-100)

Delivery method name or description.

Example: Micropple store

CART[X][DELIVERYSPEED] standard,express

Speed of the delivery method. (Specify EXPRESS if under 48h).

Example: express

CART[X][DELIVERYTYPE] storepickup, networkpickup, travelpickup, billingaddress, carrier, edelivery, other

Delivery method:

storepickup: collection of the goods in the merchant store
networkpickup: collection in a third party point (like ups, alveol, etc.)
travelpickup: collection in an airport, train station or travel agency
billingaddress: carrier such as La Poste, Colissimo, UPS, DHL…or any private carrier using billing address
carrier: carrier such as La Poste, Colissimo, UPS, DHL…or any private carrier using shipto address
edelivery: electronic ticket issuance, download, etc.

Example: storepickup

CART[X][DISCOUNT] float

Applied discount in percentage. The decimal separator is the dot symbol.

Example: 10.5

CART[X][FEES] integer

Marketplace fees in cents.

Example: 2000

CART[X][MERCHANTITEMID] string

Item ID in the merchant system.

Example: REF-123456

CART[X][NAME] string

Item name.

Example: Laser printer

CART[X][PRICE] int

Unit price in cents, including potential taxes and discounts.

Example: 20000

CART[X][QUANTITY] integer

Quantity of this item.

Example: 3

CART[X][SUBMERCHANTEXTERNALID] string(1-64)

Submerchant account identifier in the marketplace. This field allow a special value “OPERATOR” when the item is sold by the marketplace itself (and not a sub-merchant).

Example: shop1.com

CART[X][TAX] float

Applied taxes in percentage. The decimal separator is the dot symbol.

Example: 19.5

CART[X][TOTALAMOUNT] integer

Total amount based on PRICE, QUANTITY. Also FEES when applied.

Example: 60000

CLIENTADDRESS string(1-510)

The user’s address.

Example: 285 Fulton Street.

CLIENTDOB date(YYYY-MM-DD)

The user’s date of birth.

Example: 1982-06-20

CLIENTEMAIL email(5-255)

The user’s email.

Example: john.snow@example.com

CLIENTIDENT string(1-255)

Unique identifier of the user in your application (e.g. a login or a primary key).

Example: john.snow

CLIENTIP ipv4

The user’s public IP address.

Example: 10.1.1.1

CLIENTREFERRER string(1-255)

The user’s HTTP referrer URL.

Example: https://your_shop.com/order?id=1234

CLIENTUSERAGENT string(1-255)

The HTTP user agent.

Example: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:47.0) Gecko/20100101 Firefox/47.0

CREATEALIAS boolean

Ask for a payment method ALIAS creation. Caution: this parameter is mutually exclusive with DISPLAYCREATEALIAS. See the dedicated section.

Example: true

DESCRIPTION string(1-510)

A short description of the operation, can be used to trigger fraud actions. Don’t hesitate to ask your Payment Manager for some advice on this topic.

Example: Knows nothing

DESCRIPTOR string

The transaction label sent to the bank network. The transaction will display with this label on the user’s bank statement.

Example: myshop.com

DISPLAYCREATEALIAS boolean

Display a checkbox on the hosted form to ask the user to save his card data for future usage. Caution: this parameter is mutually exclusive with CREATEALIAS. See the dedicated section.

Example: true

EXTRADATA string(1-255)

Free field (Dalenys will send you back the content of the EXTRADATA you specified ahead).

Example: referrer=myshop.com;order=premium

HASH string(64)

The transaction’s hash as described in the dedicated section.

Example: 15477dcb8687adf90fa51e418f3c1a2d025f40b177a978c2734514734633b3c4

IDENTIFIER string(1-32)

Your processing account technical identifier.

Example: Demo Shop

INITIALSCHEMETRANSACTIONID string(1-55)

Card scheme transaction identifier (Mastercard Trace-ID or Visa Transaction ID). Submit the original scheme transaction ID of the initial recurring payment. If provided by the card scheme, the original scheme transaction ID will be returned in the transaction notification in “SCHEMETRANSACTIONID” field.

Example: 2MCGNM21OX0729

LANGUAGE fr, en, de, es, it, nl, zh, ru, pt, sk

Configure the hosted form display language.

Example: en

METADATA string(1-255)

Additional transactional data. Contact your account manager for more informations.

Example: @METADATA-MYWEBSITE

OPERATIONTYPE authorization, payment, capture, refund, credit, void

The action you want to process.

Example: payment

ORDERID string(1-40)

Unique ID associated to an order in the merchant’s database (as specified in your initial POST request)

Example: 1234

SELECTEDBRAND cb, visa, vpay, electron, mastercard, maestro

Preferred brand. (Please see the dedicated documentation)

Example: cb

SHIPTOADDRESS string(1-50)

The shipping address.

Example: 55 rue de la liberté

SHIPTOCITY string(1-255)

The shipping city.

Example: New York

SHIPTOCOUNTRY string(2)

The country code (ISO_3166-1_alpha-2 format)

Example: US

SHIPTOFIRSTNAME string(1-15)

Holder’s first name in the shipping address.

Example: John

SHIPTOLASTNAME string(1-30)

Holder’s last name in the shipping address.

Example: Doe

SHIPTOPHONE string(1-32)

Shipping phone number in international (E.164) format.

Example: +33111111111

SHIPTOPOSTALCODE string(1-9)

The shipping postal code.

Example: 10007

SUBMERCHANTEXTERNALID string(1-64)

Submerchant account identifier in the marketplace. This field allow a special value “OPERATOR” when the item is sold by the marketplace itself (and not a sub-merchant).

Example: shop1.com

TIMEZONE string(1-128)

Timezone / default value : UTC. Please see the Data sheet dedicated list of available timezones.

Example: Europe/Paris

TRANSACTIONEXPIRATIONDATE datetime(yyyy-MM-dd HH:mm:ss)

Form expiration date. By default, the date is UTC, the timezone can be specified by using the TIMEZONE parameter.

Example:

VERSION 3.0

The API protocol version.

Example: 3.0

ALIAS string(1-40)

Identifier of a previously processed payment method.

Example: A1-fc5bafe3-8c12-4314-95c7-2e15ec3220e0

DESCRIPTOR string

The transaction label sent to the bank network. The transaction will display with this label on the user’s bank statement.

Example: myshop.com

EXECCODE string(4)

The operation result code. (See the complete list of execution code)

Example: 0000

MESSAGE string(no length limit)

The operation result description linked to EXECCODE.

Example: The transaction has been accepted

OPERATIONTYPE authorization, payment, capture, refund, credit, void

The action you want to process.

Example: payment

REDIRECTHTML string(no length limit)

HTML content to display to the user to continue the processing. The string is base64 encoded.

Example:

REDIRECTPOSTPARAMS string(no length limit)

The content is string URL encoded and contains the POST parameters to send to the REDIRECTURL.

Example: p1=v1&p2=v2

REDIRECTURL string(no length limit)

The url to redirect the user to continue the processing.

Example: http://some_url?p1=v1

SCHEMETRANSACTIONID string(1-55)

Scheme transaction ID, retrieved in response to the authorization request.

Example: 11034331402111290210

TRANSACTIONID string(1-32)

Unique Dalenys transaction ID. Make sure to store this ID in your database.

Example: A1123456

3DSECURE boolean

Ask for a 3-D Secure V1 authentication.

Example: true

3DSECUREDISPLAYMODE main,popup,top,raw

Define the 3-D Secure authentication page display mode:
main: in the current frame;
popup: in a browser popup;
top: in the parent frame (useful in case of iframe integration);
raw: to handle the redirection by yourself.

Example: main

ALIAS string(1-40)

Identifier of a previously processed payment method.

Example: A1-fc5bafe3-8c12-4314-95c7-2e15ec3220e0

ALIASMODE oneclick, subscription

Indicates the ALIAS usage mode:
oneclick indicates a one click or an online transaction;
subscription indicates an offline transaction.

Example: oneclick

AMOUNT integer

The transaction amount in the smallest money decimal (e.g. cents for euro).

Example: 1000

AMOUNTS hash

A hash of keys / values where keys are dates and values are the amounts to process:
Dates have to be in format YYYY-MM-DD;
Amounts in the smallest money decimal (e.g. cents for euro);
See the dedicated section.

Example: {#<Date: 2016-01-01 ((2457389j,0s,0n),+0s,2299161j)>=>50000, #<Date: 2016-02-01 ((2457420j,0s,0n),+0s,2299161j)>=>20000, #<Date: 2016-03-01 ((2457449j,0s,0n),+0s,2299161j)>=>10000}

APIKEYID string (36)

ID used to authenticate a transaction using APIKEY.

Example: a688b3a1-d227-4cdd-9454-5d7cfcc74ef9

BILLINGADDRESS string(1-50)

The billing address. Be careful not to integrate any line breaks.

Example: 285 Fulton Street

BILLINGCITY string(1-255)

The billing city.

Example: New York

BILLINGCOUNTRY string(2)

The country code (ISO_3166-1_alpha-2).

Example: US

BILLINGFIRSTNAME string(1-15)

The first name part of the billing address.

Example: John

BILLINGLASTNAME string(1-15)

The last name part of the billing address.

Example: Doe

BILLINGPHONE string(1-32)

Billing phone number in international (E.164) format.

Example: +33111111111

BILLINGPOSTALCODE string(1-9)

The billing postal code.

Example: 10007

CARDFULLNAME string(1-255)

The holder’s full name (as described on the payment method). For 3-D Secure operations, the field CARDFULLNAME can only contain the following characters : [a-zA-Z1-9 -]

Example: JOHN SNOW

CARDVALIDITYDATE date(MM-YY)

Card expiry date. In case of Network Token Transaction, provide Network Token Expiration Date

Example: 12-17

CART[X][BRAND] string(1-100)

Article brand.

Example: Micropple

CART[X][CATEGORY] computersandsoftware, electronics, appliances, homeandgarden, fashion, healthandbeauty, jewellery, sport, leisureandhobbies, carsandmotorbikes, furniture, kidsandbaby, videogamesandconsoles, toysandgames, pets, foodanddrink, giftandflowers, entertainment, travel, auctionsandgroupbuying, servicesforindividuals, servicesforprofessionals

Article category.

Example: electronics

CART[X][DELIVERYEXPECTEDDATE] date(YYYY-MM-DD)

Delivery Date.

Example: 2017-06-20

CART[X][DELIVERYEXPECTEDDELAY] int (1-3)

Number of days for delivery; must be greater than 0.

Example: 2

CART[X][DELIVERYLABEL] string(1-100)

Delivery method name or description.

Example: Micropple store

CART[X][DELIVERYSPEED] standard,express

Speed of the delivery method. (Specify EXPRESS if under 48h).

Example: express

CART[X][DELIVERYTYPE] storepickup, networkpickup, travelpickup, billingaddress, carrier, edelivery, other

Delivery method:

storepickup: collection of the goods in the merchant store
networkpickup: collection in a third party point (like ups, alveol, etc.)
travelpickup: collection in an airport, train station or travel agency
billingaddress: carrier such as La Poste, Colissimo, UPS, DHL…or any private carrier using billing address
carrier: carrier such as La Poste, Colissimo, UPS, DHL…or any private carrier using shipto address
edelivery: electronic ticket issuance, download, etc.

Example: storepickup

CART[X][DISCOUNT] float

Applied discount in percentage. The decimal separator is the dot symbol.

Example: 10.5

CART[X][FEES] integer

Marketplace fees in cents.

Example: 2000

CART[X][MERCHANTITEMID] string

Item ID in the merchant system.

Example: REF-123456

CART[X][NAME] string

Item name.

Example: Laser printer

CART[X][PRICE] int

Unit price in cents, including potential taxes and discounts.

Example: 20000

CART[X][QUANTITY] integer

Quantity of this item.

Example: 3

CART[X][SUBMERCHANTEXTERNALID] string(1-64)

Submerchant account identifier in the marketplace. This field allow a special value “OPERATOR” when the item is sold by the marketplace itself (and not a sub-merchant).

Example: shop1.com

CART[X][TAX] float

Applied taxes in percentage. The decimal separator is the dot symbol.

Example: 19.5

CART[X][TOTALAMOUNT] integer

Total amount based on PRICE, QUANTITY. Also FEES when applied.

Example: 60000

CLIENTADDRESS string(1-510)

The user’s address.

Example: 285 Fulton Street.

CLIENTDOB date(YYYY-MM-DD)

The user’s date of birth.

Example: 1982-06-20

CLIENTEMAIL email(5-255)

The user’s email.

Example: john.snow@example.com

CLIENTIDENT string(1-255)

Unique identifier of the user in your application (e.g. a login or a primary key).

Example: john.snow

CLIENTIP ipv4

The user’s public IP address.

Example: 10.1.1.1

CLIENTREFERRER string(1-255)

The user’s HTTP referrer URL.

Example: https://your_shop.com/order?id=1234

CLIENTUSERAGENT string(1-255)

The HTTP user agent.

Example: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:47.0) Gecko/20100101 Firefox/47.0

CREATEALIAS boolean

Ask for a payment method ALIAS creation. Caution: this parameter is mutually exclusive with DISPLAYCREATEALIAS. See the dedicated section.

Example: true

DESCRIPTION string(1-510)

A short description of the operation, can be used to trigger fraud actions. Don’t hesitate to ask your Payment Manager for some advice on this topic.

Example: Knows nothing

DESCRIPTOR string

The transaction label sent to the bank network. The transaction will display with this label on the user’s bank statement.

Example: myshop.com

DISPLAYCREATEALIAS boolean

Display a checkbox on the hosted form to ask the user to save his card data for future usage. Caution: this parameter is mutually exclusive with CREATEALIAS. See the dedicated section.

Example: true

EXTRADATA string(1-255)

Free field (Dalenys will send you back the content of the EXTRADATA you specified ahead).

Example: referrer=myshop.com;order=premium

HASH string(64)

The transaction’s hash as described in the dedicated section.

Example: 15477dcb8687adf90fa51e418f3c1a2d025f40b177a978c2734514734633b3c4

IDENTIFIER string(1-32)

Your processing account technical identifier.

Example: Demo Shop

INITIALSCHEMETRANSACTIONID string(1-55)

Card scheme transaction identifier (Mastercard Trace-ID or Visa Transaction ID). Submit the original scheme transaction ID of the initial recurring payment. If provided by the card scheme, the original scheme transaction ID will be returned in the transaction notification in “SCHEMETRANSACTIONID” field.

Example: 2MCGNM21OX0729

LANGUAGE fr, en, de, es, it, nl, zh, ru, pt, sk

Configure the hosted form display language.

Example: en

METADATA string(1-255)

Additional transactional data. Contact your account manager for more informations.

Example: @METADATA-MYWEBSITE

NETWORKTOKENCODE string(11-19)

A network token

Example: 1111222233334444

NETWORKTOKENECI string(2)

Elecronic Commerce Identifier

Example: 06

NETWORKTOKENTAVV base64(28)

Token Authorization Verification Value. Mandatory for oneclick Transaction.

Example: AAEBAwQjS1AAXXXXXXXJYe09bQA=

NETWORKTOKENTRID string(11)

Token Requestor ID

Example: 11222444555

OPERATIONTYPE authorization, payment, capture, refund, credit, void

The action you want to process.

Example: payment

ORDERID string(1-40)

Unique ID associated to an order in the merchant’s database (as specified in your initial POST request)

Example: 1234

SELECTEDBRAND cb, visa, vpay, electron, mastercard, maestro

Preferred brand. (Please see the dedicated documentation)

Example: cb

SHIPTOADDRESS string(1-50)

The shipping address.

Example: 55 rue de la liberté

SHIPTOCITY string(1-255)

The shipping city.

Example: New York

SHIPTOCOUNTRY string(2)

The country code (ISO_3166-1_alpha-2 format)

Example: US

SHIPTOFIRSTNAME string(1-15)

Holder’s first name in the shipping address.

Example: John

SHIPTOLASTNAME string(1-30)

Holder’s last name in the shipping address.

Example: Doe

SHIPTOPHONE string(1-32)

Shipping phone number in international (E.164) format.

Example: +33111111111

SHIPTOPOSTALCODE string(1-9)

The shipping postal code.

Example: 10007

SUBMERCHANTEXTERNALID string(1-64)

Submerchant account identifier in the marketplace. This field allow a special value “OPERATOR” when the item is sold by the marketplace itself (and not a sub-merchant).

Example: shop1.com

TIMEZONE string(1-128)

Timezone / default value : UTC. Please see the Data sheet dedicated list of available timezones.

Example: Europe/Paris

TRANSACTIONEXPIRATIONDATE datetime(yyyy-MM-dd HH:mm:ss)

Form expiration date. By default, the date is UTC, the timezone can be specified by using the TIMEZONE parameter.

Example:

VERSION 3.0

The API protocol version.

Example: 3.0

ALIAS string(1-40)

Identifier of a previously processed payment method.

Example: A1-fc5bafe3-8c12-4314-95c7-2e15ec3220e0

ALIASMODE oneclick, subscription

Indicates the ALIAS usage mode:
oneclick indicates a one click or an online transaction;
subscription indicates an offline transaction.

Example: oneclick

AMOUNT integer

The transaction amount in the smallest money decimal (e.g. cents for euro).

Example: 1000

AMOUNTS hash

A hash of keys / values where keys are dates and values are the amounts to process:
Dates have to be in format YYYY-MM-DD;
Amounts in the smallest money decimal (e.g. cents for euro);
See the dedicated section.

Example: {#<Date: 2016-01-01 ((2457389j,0s,0n),+0s,2299161j)>=>50000, #<Date: 2016-02-01 ((2457420j,0s,0n),+0s,2299161j)>=>20000, #<Date: 2016-03-01 ((2457449j,0s,0n),+0s,2299161j)>=>10000}

APIKEYID string (36)

ID used to authenticate a transaction using APIKEY.

Example: a688b3a1-d227-4cdd-9454-5d7cfcc74ef9

BILLINGADDRESS string(1-50)

The billing address. Be careful not to integrate any line breaks.

Example: 285 Fulton Street

BILLINGCITY string(1-255)

The billing city.

Example: New York

BILLINGCOUNTRY string(2)

The country code (ISO_3166-1_alpha-2).

Example: US

BILLINGFIRSTNAME string(1-15)

The first name part of the billing address.

Example: John

BILLINGLASTNAME string(1-15)

The last name part of the billing address.

Example: Doe

BILLINGPHONE string(1-32)

Billing phone number in international (E.164) format.

Example: +33111111111

BILLINGPOSTALCODE string(1-9)

The billing postal code.

Example: 10007

CARDFULLNAME string(1-255)

The holder’s full name (as described on the payment method). For 3-D Secure operations, the field CARDFULLNAME can only contain the following characters : [a-zA-Z1-9 -]

Example: JOHN SNOW

CARDFULLNAME string(1-255)

The holder’s full name (as described on the payment method). For 3-D Secure operations, the field CARDFULLNAME can only contain the following characters : [a-zA-Z1-9 -]

Example: JOHN SNOW

CART[X][BRAND] string(1-100)

Article brand.

Example: Micropple

CART[X][CATEGORY] computersandsoftware, electronics, appliances, homeandgarden, fashion, healthandbeauty, jewellery, sport, leisureandhobbies, carsandmotorbikes, furniture, kidsandbaby, videogamesandconsoles, toysandgames, pets, foodanddrink, giftandflowers, entertainment, travel, auctionsandgroupbuying, servicesforindividuals, servicesforprofessionals

Article category.

Example: electronics

CART[X][DELIVERYEXPECTEDDATE] date(YYYY-MM-DD)

Delivery Date.

Example: 2017-06-20

CART[X][DELIVERYEXPECTEDDELAY] int (1-3)

Number of days for delivery; must be greater than 0.

Example: 2

CART[X][DELIVERYLABEL] string(1-100)

Delivery method name or description.

Example: Micropple store

CART[X][DELIVERYSPEED] standard,express

Speed of the delivery method. (Specify EXPRESS if under 48h).

Example: express

CART[X][DELIVERYTYPE] storepickup, networkpickup, travelpickup, billingaddress, carrier, edelivery, other

Delivery method:

storepickup: collection of the goods in the merchant store
networkpickup: collection in a third party point (like ups, alveol, etc.)
travelpickup: collection in an airport, train station or travel agency
billingaddress: carrier such as La Poste, Colissimo, UPS, DHL…or any private carrier using billing address
carrier: carrier such as La Poste, Colissimo, UPS, DHL…or any private carrier using shipto address
edelivery: electronic ticket issuance, download, etc.

Example: storepickup

CART[X][DISCOUNT] float

Applied discount in percentage. The decimal separator is the dot symbol.

Example: 10.5

CART[X][FEES] integer

Marketplace fees in cents.

Example: 2000

CART[X][MERCHANTITEMID] string

Item ID in the merchant system.

Example: REF-123456

CART[X][NAME] string

Item name.

Example: Laser printer

CART[X][PRICE] int

Unit price in cents, including potential taxes and discounts.

Example: 20000

CART[X][QUANTITY] integer

Quantity of this item.

Example: 3

CART[X][SUBMERCHANTEXTERNALID] string(1-64)

Submerchant account identifier in the marketplace. This field allow a special value “OPERATOR” when the item is sold by the marketplace itself (and not a sub-merchant).

Example: shop1.com

CART[X][TAX] float

Applied taxes in percentage. The decimal separator is the dot symbol.

Example: 19.5

CART[X][TOTALAMOUNT] integer

Total amount based on PRICE, QUANTITY. Also FEES when applied.

Example: 60000

CLIENTADDRESS string(1-510)

The user’s address.

Example: 285 Fulton Street.

CLIENTDOB date(YYYY-MM-DD)

The user’s date of birth.

Example: 1982-06-20

CLIENTEMAIL email(5-255)

The user’s email.

Example: john.snow@example.com

CLIENTIDENT string(1-255)

Unique identifier of the user in your application (e.g. a login or a primary key).

Example: john.snow

CLIENTIP ipv4

The user’s public IP address.

Example: 10.1.1.1

CLIENTREFERRER string(1-255)

The user’s HTTP referrer URL.

Example: https://your_shop.com/order?id=1234

CLIENTUSERAGENT string(1-255)

The HTTP user agent.

Example: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:47.0) Gecko/20100101 Firefox/47.0

DESCRIPTION string(1-510)

A short description of the operation, can be used to trigger fraud actions. Don’t hesitate to ask your Payment Manager for some advice on this topic.

Example: Knows nothing

EXTRADATA string(1-255)

Free field (Dalenys will send you back the content of the EXTRADATA you specified ahead).

Example: referrer=myshop.com;order=premium

HASH string(64)

The transaction’s hash as described in the dedicated section.

Example: 15477dcb8687adf90fa51e418f3c1a2d025f40b177a978c2734514734633b3c4

IDENTIFIER string(1-32)

Your processing account technical identifier.

Example: Demo Shop

INITIALSCHEMETRANSACTIONID string(1-55)

Card scheme transaction identifier (Mastercard Trace-ID or Visa Transaction ID). Submit the original scheme transaction ID of the initial recurring payment. If provided by the card scheme, the original scheme transaction ID will be returned in the transaction notification in “SCHEMETRANSACTIONID” field.

Example: 2MCGNM21OX0729

METADATA string(1-255)

Additional transactional data. Contact your account manager for more informations.

Example: @METADATA-MYWEBSITE

OPERATIONTYPE authorization, payment, capture, refund, credit, void

The action you want to process.

Example: payment

ORDERID string(1-40)

Unique ID associated to an order in the merchant’s database (as specified in your initial POST request)

Example: 1234

SELECTEDBRAND cb, visa, vpay, electron, mastercard, maestro

Preferred brand. (Please see the dedicated documentation)

Example: cb

SHIPTOADDRESS string(1-50)

The shipping address.

Example: 55 rue de la liberté

SHIPTOCITY string(1-255)

The shipping city.

Example: New York

SHIPTOCOUNTRY string(2)

The country code (ISO_3166-1_alpha-2 format)

Example: US

SHIPTOFIRSTNAME string(1-15)

Holder’s first name in the shipping address.

Example: John

SHIPTOLASTNAME string(1-30)

Holder’s last name in the shipping address.

Example: Doe

SHIPTOPHONE string(1-32)

Shipping phone number in international (E.164) format.

Example: +33111111111

SHIPTOPOSTALCODE string(1-9)

The shipping postal code.

Example: 10007

TIMEZONE string(1-128)

Timezone / default value : UTC. Please see the Data sheet dedicated list of available timezones.

Example: Europe/Paris

VERSION 3.0

The API protocol version.

Example: 3.0

DESCRIPTOR string

The transaction label sent to the bank network. The transaction will display with this label on the user’s bank statement.

Example: myshop.com

EXECCODE string(4)

The operation result code. (See the complete list of execution code)

Example: 0000

MESSAGE string(no length limit)

The operation result description linked to EXECCODE.

Example: The transaction has been accepted

OPERATIONTYPE authorization, payment, capture, refund, credit, void

The action you want to process.

Example: payment

TRANSACTIONID string(1-32)

Unique Dalenys transaction ID. Make sure to store this ID in your database.

Example: A1123456

AMOUNT integer

When not specified, 100% of the authorization amount is captured. Could not be higher than the authorization amount.

Example: 1000

DESCRIPTION string(1-510)

A short description of the operation, can be used to trigger fraud actions. Don’t hesitate to ask your Payment Manager for some advice on this topic.

Example: Knows nothing

EXTRADATA string(1-255)

Free field (Dalenys will send you back the content of the EXTRADATA you specified ahead).

Example: referrer=myshop.com;order=premium

FEES integer

Marketplace fees in cents.

Example: 2000

HASH string(64)

The transaction’s hash as described in the dedicated section.

Example: 15477dcb8687adf90fa51e418f3c1a2d025f40b177a978c2734514734633b3c4

IDENTIFIER string(1-32)

Your processing account technical identifier.

Example: Demo Shop

MERCHANTITEMID string

Item ID in the merchant system.

Example: REF-123456

OPERATIONTYPE capture

The action you want to process.

Example: payment

ORDERID string(1-40)

Unique ID associated to an order in the merchant’s database (as specified in your initial POST request)

Example: 1234

SUBMERCHANTEXTERNALID string(1-64)

Submerchant account identifier in the marketplace. This field allow a special value “OPERATOR” when the item is sold by the marketplace itself (and not a sub-merchant).

Example: shop1.com

TRANSACTIONID string(1-32)

The authorization’s TRANSACTIONID you want to capture.

Example: A1123456

VERSION 3.0

The API protocol version.

Example: 3.0

DESCRIPTOR string

The transaction label sent to the bank network. The transaction will display with this label on the user’s bank statement.

Example: myshop.com

EXECCODE string(4)

The operation result code. (See the complete list of execution code)

Example: 0000

MESSAGE string(no length limit)

The operation result description linked to EXECCODE.

Example: The transaction has been accepted

OPERATIONTYPE capture

The action you want to process.

Example: payment

TRANSACTIONID string(1-32)

Unique Dalenys transaction ID. Make sure to store this ID in your database.

Example: A1123456

AMOUNT integer

The amount to refund. When not specified, refund 100% of the initial transaction resting amount. Could not be higher than the resting amount.

Example: 1000

DESCRIPTION string(1-510)

A short description of the operation, can be used to trigger fraud actions. Don’t hesitate to ask your Payment Manager for some advice on this topic.

Example: Knows nothing

EXTRADATA string(1-255)

Free field (Dalenys will send you back the content of the EXTRADATA you specified ahead).

Example: referrer=myshop.com;order=premium

FEES integer

Marketplace fees in cents.

Example: 2000

HASH string(64)

The transaction’s hash as described in the dedicated section.

Example: 15477dcb8687adf90fa51e418f3c1a2d025f40b177a978c2734514734633b3c4

IDENTIFIER string(1-32)

Your processing account technical identifier.

Example: Demo Shop

MERCHANTITEMID string

Item ID in the merchant system.

Example: REF-123456

OPERATIONTYPE refund

The action you want to process.

Example: payment

ORDERID string(1-40)

Unique ID associated to an order in the merchant’s database (as specified in your initial POST request)

Example: 1234

SUBMERCHANTEXTERNALID string(1-64)

Submerchant account identifier in the marketplace. This field allow a special value “OPERATOR” when the item is sold by the marketplace itself (and not a sub-merchant).

Example: shop1.com

TRANSACTIONID string(1-32)

The payment or capture’s TRANSACTIONID you want to refund.

Example: A1123456

VERSION 3.0

The API protocol version.

Example: 3.0

DESCRIPTOR string

The transaction label sent to the bank network. The transaction will display with this label on the user’s bank statement.

Example: myshop.com

EXECCODE string(4)

The operation result code. (See the complete list of execution code)

Example: 0000

MESSAGE string(no length limit)

The operation result description linked to EXECCODE.

Example: The transaction has been accepted

OPERATIONTYPE refund

The action you want to process.

Example: payment

TRANSACTIONID string(1-32)

Unique Dalenys transaction ID. Make sure to store this ID in your database.

Example: A1123456

HASH string(64)

The transaction’s hash as described in the dedicated section.

Example: 15477dcb8687adf90fa51e418f3c1a2d025f40b177a978c2734514734633b3c4

IDENTIFIER string(1-32)

Your processing account technical identifier.

Example: Demo Shop

OPERATIONTYPE stopntimes

The action you want to process.

Example: payment

SCHEDULEID string(2-32)

Schedule identifier.

Example: A123456

VERSION 3.0

The API protocol version.

Example: 3.0

EXECCODE string(4)

The operation result code. (See the complete list of execution code)

Example: 0000

MESSAGE string(no length limit)

The operation result description linked to EXECCODE.

Example: The transaction has been accepted

OPERATIONTYPE stopntimes

The action you want to process.

Example: payment

DESCRIPTION string(1-510)

A short description of the operation, can be used to trigger fraud actions. Don’t hesitate to ask your Payment Manager for some advice on this topic.

Example: Knows nothing

EXTRADATA string(1-255)

Free field (Dalenys will send you back the content of the EXTRADATA you specified ahead).

Example: referrer=myshop.com;order=premium

HASH string(64)

The transaction’s hash as described in the dedicated section.

Example: 15477dcb8687adf90fa51e418f3c1a2d025f40b177a978c2734514734633b3c4

IDENTIFIER string(1-32)

Your processing account technical identifier.

Example: Demo Shop

OPERATIONTYPE void

The action you want to process.

Example: payment

ORDERID string(1-40)

Unique ID associated to an order in the merchant’s database (as specified in your initial POST request)

Example: 1234

TRANSACTIONID string(1-32)

The operation’s ‘TRANSACTIONID you want to void.

Example: A1123456

VERSION 3.0

The API protocol version.

Example: 3.0

DESCRIPTOR string

The transaction label sent to the bank network. The transaction will display with this label on the user’s bank statement.

Example: myshop.com

EXECCODE string(4)

The operation result code. (See the complete list of execution code)

Example: 0000

MESSAGE string(no length limit)

The operation result description linked to EXECCODE.

Example: The transaction has been accepted

OPERATIONTYPE void

The action you want to process.

Example: payment

TRANSACTIONID string(1-32)

Unique Dalenys transaction ID. Make sure to store this ID in your database.

Example: A1123456

INITIALSCHEMETRANSACTIONID string(1-55)

Card scheme transaction identifier (Mastercard Trace-ID or Visa Transaction ID). Submit the original scheme transaction ID of the initial recurring payment. If provided by the card scheme, the original scheme transaction ID will be returned in the transaction notification in “SCHEMETRANSACTIONID” field.

Example: 2MCGNM21OX0729

RECURRINGSEQUENCE int(1-2)

Number (n+1) of times the registered card is used for a financial transaction, considering that the very first time is the initial transaction during which the card is registered (tokenized).

Example: RECURRINGSQUENCE=1 -> initial transaction during wich the card is tokenized ; RECURRINGSQUENCE=2 -> first time the card token is used ; RECURRINGSQUENCE=3 -> second time the card token is used ; etc

AVSPOSTALCODE string(1-9)

The address postal code to submit to the Address Verification System.

Example: 10007

AVSSTREETNAME string(4-50)

The address street name to submit to the Address Verification System.

Example: Champs élysées

AVSSTREETNUMBER integer

The address street number to submit to the Address Verification System.

Example: 42

AVSCODE string(1)

The Address Verification System result code. See the Address Verification System result codes section.

Example: A

AVSMESSAGE string(1, 255)

The Address Verification System result message. See the Address Verification System result codes section.

Example: A

DESCRIPTOR string(1-36)

Descriptor suffix to be displayed on cardholder’s statement. Please note that only alphabetic characters, digits, “.” and “-“ are allowed.

Example: end of trial

SUBSCRIBERACCOUNT string(1-34)

Subscriber’s IBAN.

Example: DE11888888889999999999

SUBSCRIBERDOB date(YYYY-MM-DD)

Subscriber’s date of birth.

Example: 1982-06-20

SUBSCRIBERNAME string(1-255)

Subscriber’s name.

Example: John Doe

SUBSCRIBERZIPCODE string(1-9)

Subscriber’s address postal code.

Example: 75008

TRAVELAGENCYCODE string(1-8)

Travel agency code

Example: 12345678

TRAVELAGENCYNAME string(1-25)

Travel agency name

Example: Travel Agency

TRAVELDEPARTUREDATE YYYY-MM-DD

Travel departure date

Example: 2020-12-01

TRAVELLEGS[X][TRAVELCARRIERCODE] string(2)

Travel carrier code

Example: AA

TRAVELLEGS[X][TRAVELCARRIERNUMBER] string(1-5)

Flight number excluding carrier code

Example: 81

TRAVELLEGS[X][TRAVELDESTINATIONLOCATIONCODE] string(3)

Destination airport/city IATA code

Example: JFK

TRAVELLEGS[X][TRAVELFAREBASISCODE] string(1-6)

Fare basis code

Example: VLVA2FI

TRAVELLEGS[X][TRAVELORIGINLOCATIONCODE] string(3)

Origin airport/city IATA code

Example: CDG

TRAVELLEGS[X][TRAVELSERVICECLASS] string(1-2)

Service class

Example: V

TRAVELLEGS[X][TRAVELSTOPOVERCODE] string(1)

Stop over code

Example: N

TRAVELPASSENGERNAME string(1-20)

Passenger name

Example: JC Denton

TRAVELTICKETNUMBER string

Ticket/document number, or PNR locator code.

Example: 1059127084903