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 |
Extradata |
String |
/ |
Data to be included in card payment form into : <input type= « hidden» /> |
OperationId |
String |
Data to be included in card payment form into : <input type= « hidden» /> | |
TokenId |
String |
Data to be included in card payment form into : <input<br> type= « hidden» /> | |
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 |
---|---|---|---|
Id |
Long |
/ |
Card ID |
AppCardId |
String |
O |
Card identifier in the third-party application |
Network |
Long |
/ |
UNKNOWN = -1, CB = 1, MASTERCARD = 2, VISA = 3, |
Hint |
String |
/ |
Hide the card number. 6XXXX4 format |
Name |
String |
O |
Card name |
Country |
String |
/ |
ISO country code of the card |
ExpiryDate |
Date |
/ |
Card expiration date |
Beneficiary
Property | Type | Mandatory ? | Description |
---|---|---|---|
Id | Long | / | Account identifier. |
AppAccountId | String | Yes | 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 |
PayerInfo
Property | Type | Mandatory ? | Description |
---|---|---|---|
Name | String | Yes | The holder’s full name (as described on the payment method). |
String | Yes | The user’s email. |
Extraparameters
Property | Type | Mandatory ? | Description |
---|---|---|---|
ProfilName | String | Yes | Value “3DSV2” to call 3D-Secure 2.0 By default, without profil, 3DS V1 will be called |
Billing
Property | Type | Mandatory ? | Description |
---|---|---|---|
City | String | Yes | The billing city. |
Country | String | Yes | The country code (ISO_3166-1_alpha-2). |
Address | String | Yes | The billing address. Be careful not to integrate any line breaks. |
PostalCode | String | Yes | The billing postal code. |
Billingaddressstate | String | No | The billing address state. |
ShipTo
Property | Type | Mandatory ? | Description |
---|---|---|---|
City | String | Yes* | The shipping city. Mandatory if AdresseType is not EDELIVERY |
Country | String | Yes* | The country code (ISO_3166-1_alpha-2 format) Mandatory if AdresseType is not EDELIVERY |
Address | String | Yes* | The shipping address. Mandatory if AdresseType is not EDELIVERY |
PostalCode | String | Yes* | The shipping postal code. Mandatory if AdresseType is not EDELIVERY |
AddressType | Int | Yes | 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 | No | The shipping address state. |
AddressDate | String | No | Date when the shipping address used for this transaction was first used with the 3DS Requestor. |
Delivery
Property | Type | Mandatory ? | Description |
---|---|---|---|
String | Yes* | Mandatory if ShipToAddressType value is eDelivery For Electronic delivery, the email address to which the merchandise was delivered. | |
timeframe | String | No | Possible values : electronic, sameday, overnight, longer |
ClientScreen
Property | Type | Mandatory ? | Description |
---|---|---|---|
ColorDepth | Int | Yes | 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 | Yes | Total height of the Cardholder’s screen in pixels. Value is returned from the screen.height property. Ex : 1280 |
ScreenWidth | Int | Yes | 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 | No | 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 | No | 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 | No | Date that the cardholder opened the account with the 3DS Requestor. |
Passwordchangedate | Date | No | Date that cardholder’s account with the 3DS Requestor had a password change or account reset. |
Last6MonthsPurchaseCount | Int | No | Number of purchases with this cardholder account during the previous six months. |
Last24hoursaddcardattempts | Int | No | Number of “Add Card” attempts in the last 24 hours. |
Last24hourstransactioncount | Int | No | 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 | No | Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year. |
Cardenrolldate | date | No | Date that the payment account was enrolled in the cardholder’s account with the 3DS Requestor. |
Suspiciousaccountactivity | Boolean | No | Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account. |
Homephone | string(max 32) | No | The home phone number provided by the Cardholder in international (E.164) format. |
Mobilephone | string(max 32) | No | The mobile phone number provided by the Cardholder in international (E.164) format. |
Workphone | string(max 32) | No | The work phone number provided by the Cardholder in international (E.164) format. |
Preorderdate | date | No | For a pre-ordered purchase, the expected date that the merchandise will be available. |
Itemavailability | Boolean | No | Indicates whether Cardholder is placing an order for merchandise with a future availability or release date. |
Reorderingitem | Boolean | No | Indicates whether the cardholder is reordering previously purchased merchandise. |
Recurringexpiry | date | No | Date after which no further authorisations shall be performed in a recurring payment workwlow. |
recurringfrequency | Int | No | Indicates the minimum number of days between authorisations. Ex : 10 |
GiftCard
Property | Type | Mandatory ? | Description |
---|---|---|---|
Amount | Int | No | For prepaid or gift card purchase, the purchase amount total of prepaid or gift card(s) in minor units (cents). |
Count | Int | No | For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased. |
Currency | String | No | 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 | String | / | 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 |