Bancontact 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][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

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

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

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

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

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

AMOUNT integer

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

Example: 1000

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

CARDVALIDITYDATE date(MM-YY)

Card expiry date.

Example: 12-17

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

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

AMOUNT integer

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

Example: 1000

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][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

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

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

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

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

AMOUNT integer

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

Example: 1000

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

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

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][DISCOUNT] float

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

Example: 10.5

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

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,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

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

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

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,refund

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:

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

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

TRANSACTIONID string(1-32)

The payment’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