CustomerWallet response
Object containing information about a buyer wallet. It contains the list of payment methods registered for the buyer reference.
Response reference
customerReference
Format
cancellationDate
Path: tokens.cancellationDate
Date of token cancellation.
Format
tokens.creationDate
Date and time of token creation.
Format
paymentMethodToken
Path: tokens.paymentMethodToken
Token associated with a payment method.
Only tokens associated with a credit card are supported.
Format
paymentMethodType
Path: tokens.paymentMethodType
Type of payment method.
Possible values
Value | DESCRIPTION |
---|---|
CARD | Card payment |
SDD | SEPA Direct Debit |
Format
tokens.status
Format
Possible values
The possible values are:
Value | DESCRIPTION | |
---|---|---|
ACTIVE | The payment method can be used for a payment (default value) | |
EXPIRED | The payment method has expired | |
CANCELLED | The payment method is logically removed (canceled) | |
ALL | All statuses combined |
reference
Path: tokens.customer.reference
Buyer ID on the merchant side.
Format
Path: tokens.customer.email
Buyer's e-mail address.
Format
address
Path: tokens.customer.billingDetails.address
Billing address.
Warning: the characters > and < are not authorized.
Format
address2
Path: tokens.customer.billingDetails.address2
Second line of the billing address.
Warning: the characters > and < are not authorized.
Format
category
Path: tokens.customer.billingDetails.category
Buyer type.
Format
Possible values
values | DESCRIPTION |
---|---|
PRIVATE | Individual buyer type. |
COMPANY | Company buyer type. |
cellPhoneNumber
Path: tokens.customer.billingDetails.cellPhoneNumber
Buyer's cell phone number.
Accepts all formats:
Examples:
- 0623456789
- +33623456789
- 0033623456789
- (+34) 824 65 43 21
- 87 77 12 34
Format
city
Path: tokens.customer.billingDetails.city
City of the billing address.
Format
country
Path: tokens.customer.billingDetails.country
Buyer's country (in uppercase, in accordance with the ISO 3166-1 alpha-2 country codes).
Format
Possible values
Examples of possible values:
Country | Code |
---|---|
AUSTRIA | AT |
BRAZIL | BR |
CORSICA | FR |
IVORY COAST | CI |
FRANCE | FR |
GUADELOUPE | GP |
INDIA | IN |
MARTINIQUE | MQ |
NEW CALEDONIA | NC |
ST-PIERRE-ET-MIQUELON | PM |
FRENCH POLYNESIA | PF |
district
Path: tokens.customer.billingDetails.district
District of the billing address.
Format
firstName
Path: tokens.customer.billingDetails.firstName
Buyer's first name.
Format
identityCode
Path: tokens.customer.billingDetails.identityCode
National identifier. Allows to identify each citizen within a country.
Format
language
Path: tokens.customer.billingDetails.language
Buyer's language code, according to ISO 639-1.
Specify the language in which payment confirmation e-mails are sent.
Format
Possible values
Examples of possible values:
Language | Code |
---|---|
German (Germany) | DE |
English (United Kingdom) | EN |
English (United States) | EN |
Chinese (Traditional) | ZH |
Spanish (Spain) | ES |
Spanish (Chile) | ES |
French (France) | FR |
Italian (Italy) | IT |
Japanese (Japan) | JP |
Dutch (the Netherlands) | NL |
Polish (Poland) | PL |
Portuguese (Brazil) | PT |
Portuguese (Portugal) | PT |
Russian (Russia) | RU |
lastName
Path: tokens.customer.billingDetails.lastName
Buyer's last name.
Format
legalName
Path: tokens.customer.billingDetails.legalName
Legal name.
Format
phoneNumber
Path: tokens.customer.billingDetails.phoneNumber
Buyer's phone number.
Accepts all formats:
Examples:
- 0123456789
- +33123456789
- 0033123456789
- (00.571) 638.14.00
- 40 41 42 42
Format
state
Path: tokens.customer.billingDetails.state
Region (state) of the billing address. It is recommended, but not mandatory, to pass the value in ISO-3166-2.
Format
streetNumber
Path: tokens.customer.billingDetails.streetNumber
Street number of the billing address.
Accepted characters:
- Alphabetical characters (from "A" to "Z" and from "a" to "z")
- Space
Format
title
Path: tokens.customer.billingDetails.title
Buyer's title.
Examples:
- Mr
- Ms
- Mrs
Format
zipCode
Path: tokens.customer.billingDetails.zipCode
Zip code of the billing address.
Format
address
Path: tokens.customer.shippingDetails.address
Shipping address.
Warning: the characters > and < are not authorized.
Format
address2
Path: tokens.customer.shippingDetails.address2
Second line of the shipping address.
Warning: the characters > and < are not authorized.
Format
category
Path: tokens.customer.shippingDetails.category
Buyer type.
Format
Possible values
values | DESCRIPTION |
---|---|
PRIVATE | Individual buyer type. |
COMPANY | Company buyer type. |
city
Path: tokens.customer.shippingDetails.city
Shipping city.
Format
country
Path: tokens.customer.shippingDetails.country
Shipping country (in uppercase, in accordance with the ISO 3166-1 alpha-2 country codes).
Format
Possible values
Examples of possible values:
Country | Code |
---|---|
AUSTRIA | AT |
BRAZIL | BR |
CORSICA | FR |
IVORY COAST | CI |
FRANCE | FR |
GUADELOUPE | GP |
INDIA | IN |
MARTINIQUE | MQ |
NEW CALEDONIA | NC |
ST-PIERRE-ET-MIQUELON | PM |
FRENCH POLYNESIA | PF |
deliveryCompanyName
Path: tokens.customer.shippingDetails.deliveryCompanyName
Name of the delivery company.
Format
district
Path: tokens.customer.shippingDetails.district
District of the billing address.
Format
firstName
Path: tokens.customer.shippingDetails.firstName
First name of the recipient.
Format
identityCode
Path: tokens.customer.shippingDetails.identityCode
National identifier. Allows to identify each citizen within a country.
Format
lastName
Path: tokens.customer.shippingDetails.lastName
Buyer's last name.
Format
legalName
Path: tokens.customer.shippingDetails.legalName
Legal name in case of shipping to a company.
Format
phoneNumber
Path: tokens.customer.shippingDetails.phoneNumber
Buyer's phone number.
Accepts all formats:
Examples:
- 0123456789
- +33123456789
- 0033123456789
- (00.571) 638.14.00
- 40 41 42 42
Format
shippingMethod
Path: tokens.customer.shippingDetails.shippingMethod
Shipping mode.
Format
Possible values
Value | DESCRIPTION |
---|---|
RECLAIM_IN_SHOP | Item pickup at the shop. |
RELAY_POINT | Use of a third-party pickup network (Kiala, Alveol, etc.). |
RECLAIM_IN_STATION | Pickup at an airport, a train station or a travel agency. |
PACKAGE_DELIVERY_COMPANY | Shipping by the transporter (Colissimo, UPS, etc.). |
ETICKET | Issue of an electronic ticket, online download of the product. |
CARD_HOLDER_ADDRESS | Delivery to the buyer. Reserved for future use. |
VERIFIED_ADDRESS | Delivery to a verified address. Reserved for future use. |
NOT_VERIFIED_ADDRESS | Delivery to a non-verified address. Reserved for future use. |
SHIP_TO_STORE | In-store pickup. Reserved for future use. |
DIGITAL_GOOD | Digital delivery. Reserved for future use. |
ETRAVEL_OR_ETICKET | E-ticket. Reserved for future use. |
OTHER | Other: Reserved for future use. |
PICKUP_POINT | Pickup point delivery. Reserved for future use. |
AUTOMATED_PICKUP_POINT | Pickup at an automatic pickup point. Reserved for future use. |
shippingSpeed
Path: tokens.customer.shippingDetails.shippingSpeed
Shipping delay.
Format
Possible values
Examples of possible values:
Value | DESCRIPTION |
---|---|
STANDARD | Standard shipping. |
EXPRESS | Express shipping (in less than 24h). |
PRIORITY | Priority shipping (Click & Collect). |
state
Path: tokens.customer.shippingDetails.state
Region of the billing address.
Format
streetNumber
Path: tokens.customer.shippingDetails.streetNumber
Street number of the delivery address.
Accepted characters:
- Alphabetical characters (from "A" to "Z" and from "a" to "z")
- Space
Format
zipCode
Path: tokens.customer.shippingDetails.zipCode
Zip code of the billing address.
Format
ipAddress
Path: tokens.customer.extraDetails.ipAddress
Buyer's IP address.
Format
fingerPrintId
Path: tokens.customer.extraDetails.fingerPrintId
Format
browserUserAgent
Path: tokens.customer.extraDetails.browserUserAgent
"User-Agent" header of buyer's browser (HTTP/1.1 - RFC. 2616)
Format
browserAccept
Path: tokens.customer.extraDetails.browserAccept
"Accept" header of buyer's browser (HTTP/1.1 - RFC. 2616)
Format
insuranceAmount
Path: tokens.customer.shoppingCart.insuranceAmount
Insurance amount for the entire order, expressed in the smallest monetary unit (cent for euro).
Example: 30050 for EUR 300.50.
Format
shippingAmount
Path: tokens.customer.shoppingCart.shippingAmount
Amount of delivery fees for the entire order, expressed in its smallest monetary unit (cent for euro).
Example: 30050 for EUR 300.50.
Format
taxAmount
Path: tokens.customer.shoppingCart.taxAmount
Amount of taxes for the entire order expressed in the smallest monetary unit (cent for euro).
Example: 30050 for EUR 300.50.
Format
cartItemInfo
Path: tokens.customer.shoppingCart.cartItemInfo
cardItemInfo is a list that contains Customer/ShoppingCartItemInfo objects.
see tokens.customer.shoppingCart.* properties for more information.
Format
productAmount
Path: tokens.customer.shoppingCart.cartItemInfo.productAmount
Amount of the product expressed in the smallest currency unit (cent for euro).
Example: 30050 for EUR 300.50.
Format
productLabel
Path: tokens.customer.shoppingCart.cartItemInfo.productLabel
Product name.
Format
productQty
Path: tokens.customer.shoppingCart.cartItemInfo.productQty
Product quantity.
Format
productRef
Path: tokens.customer.shoppingCart.cartItemInfo.productRef
Product reference.
Format
productType
Path: tokens.customer.shoppingCart.cartItemInfo.productType
Product type.
Format
Possible values
Value | DESCRIPTION |
---|---|
FOOD_AND_GROCERY | Food and grocery |
AUTOMOTIVE | Cars / Moto |
ENTERTAINMENT | Entertainment / Culture |
HOME_AND_GARDEN | Home and gardening |
HOME_APPLIANCE | Household appliances |
AUCTION_AND_GROUP_BUYING | Auctions and group purchasing |
FLOWERS_AND_GIFTS | Flowers and presents |
COMPUTER_AND_SOFTWARE | Computers and software |
HEALTH_AND_BEAUTY | Health and beauty |
SERVICE_FOR_INDIVIDUAL | Services for individuals |
SERVICE_FOR_BUSINESS | Services for companies |
SPORTS | Sports |
CLOTHING_AND_ACCESSORIES | Clothes and accessories |
TRAVEL | Travel |
HOME_AUDIO_PHOTO_VIDEO | Sound, image and video |
TELEPHONY | Telephony |
productVat
Path: tokens.customer.shoppingCart.cartItemInfo.productVat
Product type.
Tax fee amount (expressed in the smallest currency unit).
Possible values
Value | DESCRIPTION |
---|---|
Integer | Transaction amount. Its value must be a positive integer (e.g.: 1234 for 12.34 EUR). |
Decimal number, lower than 100 | Percentage applied to the amount. Examples: 20.0 or 19.6532 |
To display a percentage applied to the payment amount for the product in question, the value should have maximum 4 digits after the decimal point. The decimal separator is mandatory for displaying a percentage. The decimal separator is represented by the "." symbol.
country
Path: tokens.tokenDetails.country
Country code of the card.
Format
effectiveBrand
Path: tokens.tokenDetails.effectiveBrand
Card brand.
Payment method | Card type (effectiveBrand) |
---|---|
Carte enseigne Accord | ACCORD_STORE |
Carte enseigne Accord - Mode sandbox | ACCORD_STORE_SB |
Alipay | ALIPAY |
American Express | AMEX |
Titre-Restaurant Dématérialisé Apetiz | APETIZ |
Carte Cpay | AURORE-MULTI |
Bancontact Mistercash | BANCONTACT |
CB | CB |
Titre-Restaurant Dématérialisé Chèque Déjeuner | CHQ_DEJ |
Titre-Restaurant Dématérialisé Conecs | CONECS |
Chèque-Vacances Connect | CVCO |
Diners | DINERS |
Discover | DISCOVER |
e-carte bleue | E-CARTEBLEUE |
Ticket Eco Chèque Edenred | EDENRED_EC |
Ticket Sports & Culture Edenred | EDENRED_SC |
Ticket Compliment Edenred | EDENRED_TC |
Ticket Restaurant Edenred | EDENRED_TR |
Paiement en 3X Franfinance | FRANFINANCE_3X |
Paiement en 4X Franfinance | FRANFINANCE_4X |
Paiement en 3x sans frais par BNPP PF | FULLCB3X |
Paiement en 4x sans frais par BNPP PF | FULLCB4X |
Giropay | GIROPAY |
iDeal Internet Banking | IDEAL |
Carte Cadeau Illicado | ILLICADO |
Carte Cadeau Illicado - Mode sandbox | ILLICADO_SB |
JCB | JCB |
Maestro | MAESTRO |
Mastercard | MASTERCARD |
Multibanco | MULTIBANCO |
MyBank | MYBANK |
Paiement 3x 4x Oney | ONEY_3X_4X |
Cartes Enseignes partenaires d'Oney | ONEY_ENSEIGNE |
PayDirekt | PAYDIREKT |
Wallet Paylib | PAYLIB |
PayPal | PAYPAL |
PayPal - Mode sandbox | PAYPAL_SB |
PostFinance | POSTFINANCE |
PostFinance E-finance | POSTFINANCE_EFIN |
Solution de crédit en ligne Presto de Cetelem | PRESTO |
Przelewy24 | PRZELEWY24 |
Prélèvement Bancaire SEPA DIRECT DEBIT | SDD |
Titre-Restaurant Dématérialisé Sodexo | SODEXO |
Sofort Banking | SOFORT_BANKING |
Union Pay | UNION_PAY |
Visa | VISA |
Visa Electron | VISA_ELECTRON |
Vpay | VPAY |
Format
effectiveProductCode
Path: tokens.tokenDetails.effectiveProductCode
Product code of the card used for the payment.
Format
issuerCode
Path: tokens.tokenDetails.issuerCode
Code associated with the issuing bank.
Format
issuerName
Path: tokens.tokenDetails.issuerName
Name of the bank associated with the issuing bank.
Format
expiryMonth
Path: tokens.tokenDetails.expiryMonth
Expiry month.
Format
expiryYear
Path: tokens.tokenDetails.expiryYear
Expiry year.
Format
mid
Path: tokens.tokenDetails.mid
Merchant ID number. If this field is populated, make sure you use the appropriate MID depending on the card scheme.
Format
pan
Path: tokens.tokenDetails.pan
Truncated card number.
Format
paymentSource
Path: tokens.tokenDetails.paymentSource
Payment source.
Format
Possible values
The possible values are:
Value | DESCRIPTION |
---|---|
EC | E-commerce: the payment method details are entered by the Buyer. This value allows to have strong authentication during a payment. |
MOTO | MAIL OR TELEPHONE ORDER: entry by an operator. The payment information is sent by mail or e-mail. Requires a VAD contract |
CC | Call Center: payment made via a call center. Requires a VAD type contract. |
OTHER | Other sales channel. Returned output value for payments made via the Back-Office, payments by file, recurring payments, proximity payments, refunds via the Shopify CMS. |
Absent ou null | The default value is "EC". |
amount
Path: tokens.tokenDetails.authorizationResponse.amount
Authorization amount.
Format
currency
Path: tokens.tokenDetails.authorizationResponse.currency
Code of the currency used during the authorization request.
Format
authorizationDate
Path: tokens.tokenDetails.authorizationResponse.authorizationDate
Date and time of the authorization request.
Format
authorizationNumber
Path: tokens.tokenDetails.authorizationResponse.authorizationNumber
Number of the authorization request.
Format
authorizationResult
Path: tokens.tokenDetails.authorizationResponse.authorizationResult
Return code of the authorization request.
See the List of authorization return codes for more information.
Format
authorizationMode
Path: tokens.tokenDetails.authorizationResponse.authorizationMode
Specifies the mode of the authorization request.
Possible values
values | DESCRIPTION |
---|---|
MARK | A pre-authorization of a null or unitary amount has been made, see below. |
FULL | An authorization of the total amount has been requested. |
When authorizationMode is MARK : An authorization for 1 EUR100 XPF1 CHF1 BRL100 CLP1 USD1000 XOF100 INR (or information request within the CB network if the acquirer supports it) has been made in order to check if the card is valid. This case occurs when the capture date exceeds the authorization validity period (e.g. 7 days for VISA / MasterCard / CB / AMEX in France).
Format
id
Path: tokens.tokenDetails.authenticationResponse.id
Unique identifier of the authentication, in UUID format.
Format
operationSessionId
Path: tokens.tokenDetails.authenticationResponse.operationSessionId
Unique identifier of the authentication, in UUID format.
Format
instructionType
Path: tokens.tokenDetails.authenticationResponse.value.instructionType
Type of instruction to carry out.
Format
Possible values
values | DESCRIPTION |
---|---|
FORM | Form with redirect type instruction. |
name
Path: tokens.tokenDetails.authenticationResponse.value.name
Instruction name.
Possible values
Value | DESCRIPTION |
---|---|
CHALLENGE | Challenge Instruction that allows interactive user authentication via the ACS. |
FINGERPRINT | Fingerprint Instruction that allows to identify the user via the ACS. |
Format
_type
Path: tokens.tokenDetails.authenticationResponse.value._type
Type of received response. The interpretation of the rest of the response depends on this attribute.
Possible values
Value | DESCRIPTION |
---|---|
AuthenticationInstruction | Instruction type response. |
AuthenticationResult | Final result type response. |
Format
timeout
Path: tokens.tokenDetails.authenticationResponse.value.timeout
Maximum response delay when executing an instruction, expressed in seconds. Beyond this delay, it is necessary to initiate the return to the payment gateway server in order to obtain the final result.
Format
method
Path: tokens.tokenDetails.authenticationResponse.value.http.method
Method (verb) used for the request.
Possible values
Value | DESCRIPTION |
---|---|
DELETE | Delete method |
GET | Get method |
PATCH | Patch method |
POST | Post method |
PUT | Put method |
Format
url
Path: tokens.tokenDetails.authenticationResponse.value.http.url
URL to which the HTTP form must be submitted.
Format
body
Path: tokens.tokenDetails.authenticationResponse.value.http.body
List of request body parameters, presented as “name”: “value”.
Format
headers
Path: tokens.tokenDetails.authenticationResponse.value.http.headers
List of HTTP request headers, presented as “name”: “value”.
Format
element
Path: tokens.tokenDetails.authenticationResponse.value.target.element
Type of the target HTML element which contains the instruction.
Possible values
Value | DESCRIPTION |
---|---|
IFRAME | iFrame |
Format
height
Path: tokens.tokenDetails.authenticationResponse.value.target.height
Height of the HTML target in pixels.
Format
visible
Path: tokens.tokenDetails.authenticationResponse.value.target.visible
Boolean indicating whether or not the HTML target must be visible.
Format
width
Path: tokens.tokenDetails.authenticationResponse.value.target.width
Width of the HTML target in pixels.
Format
showUrl
Path: tokens.tokenDetails.authenticationResponse.value.target.showUrl
Technical field for internal use that allows to show or hide the URL of the ACS.
Format
challengePreference
Path: tokens.tokenDetails.authenticationResponse.protocol.challengePreference
Indicates whether or not the merchant has requested a challenge.
Possible values
values | DESCRIPTION |
---|---|
NO_PREFERENCE | No particular preference. |
NO_CHALLENGE_REQUESTED | Challenge is not explicitly requested. |
CHALLENGE_REQUESTED | Challenge is requested by the Merchant. |
Format
name
Path: tokens.tokenDetails.authenticationResponse.protocol.name
Name of the protocol used by the cardholder authentication services.
Possible values
Value | DESCRIPTION |
---|---|
THREEDS | 3D Secure protocol |
PROCESOS_DINERS | Procesos Diners OTP protocol |
OSB | Protocol OTP OSB |
Format
simulation
Path: tokens.tokenDetails.authenticationResponse.protocol.simulation
Boolean indicating if the authentication must be carried out in simulation mode. Simulation mode allows to perform merchant integration without being in production or using a real card.
Format
network
Path: tokens.tokenDetails.authenticationResponse.protocol.network
Network where the payment method was authenticated.
Currently supported versions
Value |
---|
CB |
VISA |
MASTERCARD |
AMEX_SAFEKEY |
ELO |
PROCESOS_DINERS |
DINERS |
DISCOVER |
OSB |
Format
version
Path: tokens.tokenDetails.authenticationResponse.protocol.version
Version of the protocol used by the cardholder authentication services.
Currently supported versions
Value | DESCRIPTION |
---|---|
1.0.2 | Version 1.0.2 |
2.1.0 | Version 2.1.0 |
Format
authenticationType
Path: tokens.tokenDetails.authenticationResponse.value.authenticationType
Type of authentication that has been applied.
Possible values
Value | DESCRIPTION |
---|---|
FRICTIONLESS | Authentication in Frictionless mode, i.e. transparent for the Buyer. |
CHALLENGE | Authentication with a Challenge, the Buyer had to explicitly authenticate him/herself via the ACS. |
Format
commerceIndicator
Path: tokens.tokenDetails.authenticationResponse.value.commerceIndicator
Commerce Indicator, or ECI (Electronic Commerce Indicator) for the 3DS protocol. Indicator returned by the ACS to report the results of cardholder’s authentication attempt.
In case of authentication without payment (e.g. in case of card registration) MasterCard can return the following 2 values:
VALUE | DESCRIPTION |
---|---|
N0 | Not authenticated |
N2 | Authenticated |
Format
status
Path: tokens.tokenDetails.authenticationResponse.value.status
Authentication status, i.e. the positive/negative outcome of the authentication.
Possible values
Value | DESCRIPTION |
---|---|
ATTEMPT | Proof of authentication attempt when authentication is not available. |
ENROLLED_UNAVAILABLE | Unable to assess the enrollment status. |
FAILED | Authentication error. |
NOT_ENROLLED | Card not enrolled. |
SUCCESS | Successful authentication. |
UNAVAILABLE | The authentication could not be completed (technical error, etc.). |
DISABLED | Authentication disabling requested. |
REJECTED | Authentication rejected by the ACS. |
Format
authenticationIdType
Path: tokens.tokenDetails.authenticationResponse.value.authenticationId.authenticationIdType
Type of authentication that has been applied.
Possible values
Value | DESCRIPTION |
---|---|
xid | The field originates from the xid field of the v1 3DS protocol. |
dsTransId | The field originates from the dsTransId field of the v2 3DS protocol. |
Format
value
Path: tokens.tokenDetails.authenticationResponse.value.authenticationId.value
Value of the authentication transaction identifier known to the banking network.
The length of the field varies depending on the authentication protocol.
Protocol | Format / Length | value Example: |
---|---|---|
3DS v1 (xid) | string / 28 alphanumeric characters | f8e120f1fe934db8b8e58ba4c423db48 |
3DS v2 (dsTransId) | string / 32 alphanumeric characters + 4 dashes | 4317fdc3-ad24-5443-8000-000000000891 |
Format
authenticationValueType
Path: tokens.tokenDetails.authenticationResponse.value.authenticationValue.authenticationValueType
Type of authentication value.
Possible values
Value | DESCRIPTION |
---|---|
AEVV | American Express Verification Value (used by Amex). |
CAVV | Cardholder Authentication Verification Value (used by VISA). |
AAV | Accountholder Authentication Value (used by Mastercard). |
Format
value
Path: tokens.tokenDetails.authenticationResponse.value.authenticationValue.value
Final authentication value (depending on the DS this value can be called CAVV, AEVV or AAV) Character string encoded in base64 with a size of 28 characters.
Format
code
Path: tokens.tokenDetails.authenticationResponse.value.reason.code
Additional code explaining the result. E.g.: DS_TIMEOUT
Format
message
Path: tokens.tokenDetails.authenticationResponse.value.reason.message
Additional message explaining the result.