Ressources
CardPayment
| Property | Type | Mandatory | Description |
|---|---|---|---|
Amount |
Long |
O |
Payment amount (in cents) |
Fee |
Long |
N |
Fee amount (the amount value does not include the fee amount) |
ThreeDSecurePreference |
Int |
O |
0 = ask for a strong authentication 1 = ask for a frictionless authentication 2 = ask for no preference, the decision will be made by issuer ; 3 = ask for no authentication |
OrderId |
String |
O |
Payment identifier in the third-party application |
Id |
Long |
/ |
Payment ID |
availableCards |
String |
O |
List of cards to be displayed on the payment page. Possible values ( to separate with ’ ;’ ) : CB MASTERCARD MAESTRO VISA VISA_ELECTRON |
IsMine |
Bool |
O |
True, if the account holder is also the bank card holder (it refers to an account top-up and not a payment), False if the bank card holder is not the owner of the account holder |
Message |
String |
O |
Payment message |
urlReturn |
String |
O |
Url of callback client requested at the end of a card payment |
urlCallback |
String |
O |
Specify url of callback server requested at the end of adding card (the domain must be the same as the one of the callback URL provided initially) |
Status |
Int |
O |
Operation status -1 = unknow 0 = waiting 1 = completed 2 = refunded 3 = refused 4 = Waiting for validation 5 = Cancelled 6 = Waiting to be sent |
ErrorCode |
Int |
O |
0 = 0XXX operation succeeded or still processing 10 = 1XXX operation rejected because of bad request configuration 11 = 2XXX operation rejected because of bad reference usage 12 = 3XXX operation rejected because of bad account configuration 13 = 4XXX operation rejected because of the bank or the supplier 14 = 5XXX operation rejected because of a system error 15 = 6XXX operation rejected because of anti-fraud engine |
Href |
String |
O |
The "href" parameter includes the url, to which the third-party application should redirect the client’s browser to complete a card payment . |
PaymentDate |
DateTime |
Payment date Ex : 2013-09-10 T15:49:58 .791121+02:00 | |
Type |
Int |
/ |
Payment types : 0 = Payment 1 = Refund |
Payments
| Property | Type | Mandatory | Description |
|---|---|---|---|
OrderId |
Long |
/ |
SubPayment identifier in the third-party application |
Id |
Long |
/ |
Sub Operation OrderId |
Amount |
Long |
O |
SubPayment amount (in cents) |
Fee |
Long |
N |
Subpayment fee amount (the amount value does not include the fee amount) |
Message |
String |
N |
Subpayment message |
Status |
Int |
O |
Sub operation status -1 = unknow 0 = waiting 1 = completed 2 = refunded 3 = refused 4 = Waiting for validation 5 = Cancelled 6 = Waiting to be sent |
Card
| Property | Type | Mandatory | Description |
|---|---|---|---|
AppCardId |
String |
O |
Card identifier in the third-party application |
Href |
Uri |
/ |
Uri for the details of the bank card |
Beneficiary
| Property | Type | Mandatory | Description |
|---|---|---|---|
Id |
Long |
/ |
Account identifier. |
AppAccountId |
String |
O |
Account identifier provided by the third-party application. |
DisplayName |
Long |
/ |
Account display name |
String |
/ |
Account email | |
Phonenumber |
String |
/ |
Account phone number |
Href |
Uri |
/ |
Uri for the account details |
Extraparameters
| Property | Type | Mandatory | Description |
|---|---|---|---|
ProfilName |
String |
O |
Value “3DSV2” to call 3D-Secure 2.0 By default, without profil, 3DS V1 will be called |
PayerInfo
| Property | Type | Mandatory | Description |
|---|---|---|---|
Name |
String |
O |
The holder’s full name (as described on the payment method). |
String |
O |
The user’s email. |
Billing
| Property | Type | Mandatory | Description |
|---|---|---|---|
City |
String |
O |
The billing city. |
Country |
String |
O |
The country code (ISO_3166-1_alpha-2). |
Address |
String |
O |
The billing address. Be careful not to integrate any line breaks. |
PostalCode |
String |
O |
The billing postal code. |
Billingaddressstate |
String |
N |
The billing address state. |
ShipTo
| Property | Type | Mandatory | Description |
|---|---|---|---|
City |
String |
O* |
The shipping city. Mandatory if AdresseType is not EDELIVERY |
Country |
String |
O* |
The country code (ISO_3166-1_alpha-2 format) Mandatory if AdresseType is not EDELIVERY |
Address |
String |
O* |
The shipping address. Mandatory if AdresseType is not EDELIVERY |
PostalCode |
String |
O* |
The shipping postal code. Mandatory if AdresseType is not EDELIVERY |
AddressType |
Int |
O |
Shipping indicator. 0 = eDelivery 1 = Verified 2 = New 3 = Billing 4 = Store Pickup 5 = Travel Pickup 6 = Other The parameter DELIVERYEMAIL is mandatory when EDELIVERY mode is set. The other ship to address fields are optional when ‘storepickup’, travelpickup or other is set. |
AddressState |
String |
N |
The shipping address state. |
AddressDate |
String |
N |
Date when the shipping address used for this transaction was first used with the 3DS Requestor. |
Delivery
| Property | Type | Mandatory | Description |
|---|---|---|---|
String |
O* |
Mandatory if ShipToAddressType value is eDelivery For Electronic delivery, the email address to which the merchandise was delivered. | |
timeframe |
String |
N |
Possible values : electronic, sameday, overnight, longer |
ClientScreen
| Property | Type | Mandatory | Description |
|---|---|---|---|
ColorDepth |
Int |
N |
Value representing the bit depth of the colour palette for displaying images, in bits per pixel. Obtained from Cardholder browser using the screen.colorDepth property. Ex : 32 |
ScreenHeight |
Int |
N |
Total height of the Cardholder’s screen in pixels. Value is returned from the screen.height property. Ex : 1280 |
ScreenWidth |
Int |
N |
Total width of the cardholder’s screen in pixels. Value is returned from the screen.width property. Ex : 1024 |
ThreeDsOptData
| Property | Type | Mandatory | Description |
|---|---|---|---|
ClientAuthMethod |
String |
N |
guest : No merchant authentication occurred (i.e. cardholder “logged in” as guest) ; credentials : Login to the cardholder account at the merchant system using merchant’s own credentials ; federated : Login to the cardholder account at the merchant system using federated ID ; issuer : Login to the cardholder account at the merchant system using issuer credentials ; thirdparty : Login to the cardholder account at the merchant system using third-party authentication ; fido : Login to the cardholder account at the merchant system using FIDO Authenticator ; |
AccountChangeDate |
Date |
N |
Date that the cardholder’s account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added. |
AccountCreationDate |
Date |
N |
Date that the cardholder opened the account with the 3DS Requestor. |
Passwordchangedate |
Date |
N |
Date that cardholder’s account with the 3DS Requestor had a password change or account reset. |
Last6MonthsPurchaseCount |
Int |
N |
Number of purchases with this cardholder account during the previous six months. |
Last24hoursaddcardattempts |
Int |
N |
Number of “Add Card” attempts in the last 24 hours. |
Last24hourstransactioncount |
Int |
N |
Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours. |
Last12Monthstransactioncount |
Int |
N |
Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year. |
Cardenrolldate |
date |
N |
Date that the payment account was enrolled in the cardholder’s account with the 3DS Requestor. |
Suspiciousaccountactivity |
Boolean |
N |
Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account. |
Homephone |
string(max 32) |
N |
The home phone number provided by the Cardholder in international (E.164) format. |
Mobilephone |
string(max 32) |
N |
The mobile phone number provided by the Cardholder in international (E.164) format. |
Workphone |
string(max 32) |
N |
The work phone number provided by the Cardholder in international (E.164) format. |
Preorderdate |
date |
N |
For a pre-ordered purchase, the expected date that the merchandise will be available. |
Itemavailability |
Boolean |
N |
Indicates whether Cardholder is placing an order for merchandise with a future availability or release date. |
Reorderingitem |
Boolean |
N |
Indicates whether the cardholder is reordering previously purchased merchandise. |
Recurringexpiry |
date |
N |
Date after which no further authorisations shall be performed in a recurring payment workwlow. |
recurringfrequency |
Int |
N |
Indicates the minimum number of days between authorisations. Ex : 10 |
GiftCard
| Property | Type | Mandatory | Description |
|---|---|---|---|
Amount |
Int |
N |
For prepaid or gift card purchase, the purchase amount total of prepaid or gift card(s) in minor units (cents). |
Count |
Int |
N |
For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased. |
Currency |
String |
N |
For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217. |
ExtraResults
| Property | Type | Mandatory | Description |
|---|---|---|---|
threedsecure |
Boolean |
/ |
True / False |
threedsecureauthstatus |
Int |
/ |
0 = Yes 1 = No 2 = unavaible 3 = Attempted |
threedsecuresignaturestatus |
Int |
/ |
0 = Yes 1 = No |
threedsecureglobalstatus |
Int |
/ |
0 = Yes 1 = Not_enrolled 2 = unavaible 3 = Not_required |
ThreeDsCardEnrolled |
Int |
/ |
0 = Yes 1 = No 2 = unavaible |
ExecCode |
String (4) |
/ |
The operation result code |
ExecMessage |
String |
/ |
The operation result description linked to EXECCODE |
warrantyresult |
String |
/ |
Yes / no |
3dsecureversion |
Int |
/ |
The kind of 3-D Secure protocol version. Ex : 1 |
3dsecuremode |
Int |
/ |
Applied authentification mode : 0 = ask for a strong authentication 1 = ask for a frictionless authentication |
bankauthresult |
Int |
/ |
Return code of the authorisation request returned by the issuing bank |