Search Overlay

Segmentation en unités

Cette fonction de segmentation en unités renvoie une promesse, qui se résout en gestionnaire de paiement à usage unique représentant les données sensibles de la carte de l’utilisateur. Cette fonction peut être utilisée par l’API Paiements pour accepter des paiements. Les gestionnaires à usage unique ne sont valides que 15 minutes et ne sont pas consommés par la vérification. Voir Paiements avec un gestionnaire pour de plus amples renseignements.

La fonction de segmentation en unités a la signature suivante :

instance.tokenize(options)
.then(result => {
...
})
.catch(error => {
...
});

Async Await

TRYtry {
const result = await instance.tokenize(options);
...
} catch(error) {
...

};

La signature de la fonction contient les paramètres suivant :

ParamètreRequisTypeDescription
optionstrueobjectParamètres de tokenisation optionnels, qui contiennent des informations sur le flux 3D Secure (3DS) et des données client supplémentaires envoyées au coffre-fort client.
{return}falsepromiseRésout le résultat de la tokenisation
options
montanttruenumber

Montant du paiement en unités mineures à débiter de la carte du client. Utilisez le montant correct des unités mineures pour la devise du compte marchand.

Par exemple, pour traiter 10,99 $ US, cette valeur doit être 1099. Pour traiter 1000 yens japonais, cette valeur doit être 1000. Pour traiter 10 139 dinars tunisiens, cette valeur doit être 10139.

Min = 1

Max = 999999999

Lors de l'utilisation de 3DS 2 (c'est-à-dire useThreeDSecureVersion2= true), montant avec valeur : « 0 » peut être ignoré.

transactionTypetruestring

Indique le type de transaction pour lequel l’identifiant de paiement est créé. Les valeurs éventuelles sont :

  • PAYMENT – le gestionnaire de paiement est créé pour poursuivre le paiement.
  • STANDALONE_CREDIT – un gestionnaire de paiement est créé pour poursuivre le crédit autonome.
  • STANDALONE_CREDIT – un gestionnaire de paiement est créé pour poursuivre le crédit initial.
  • VERIFICATION – un gestionnaire de paiement est créé pour poursuivre la requête de vérification.
paymentTypetruestring

Il s’agit du type de paiement associé à ce gestionnaire de paiement. Les valeurs éventuelles sont :

  • CARTE
  • APPLEPAY
merchantRefNumtruestringUn identifiant unique est fourni par le marchand pour chaque transaction de Paysafe JS.
customerDetailstrueobjectDonnées supplémentaires du client associées au gestionnaire à usage unique provenant du coffre-fort client.
merchantDescriptorfalseobjectIl s’agit d’un descripteur de marchand qui sera affiché sur le relevé de carte du client.
accountIdfalsenumber

L’identifiant du compte marchand sélectionné à utiliser pour traiter le paiement.

Si vous êtes un marchand, ce champ n'est obligatoire que si vous avez plus d'un compte configuré pour le même mode de paiement et la même devise.webhooks Si vous êtes un partenaire utilisant une clé API partagée, ce champ est obligatoire.

Si un compte est fourni lors de la configuration, celui-ci le remplacera.

threeDsthreeDSfalseobjectUn objet représentant les paramètres 3DS. Inclure cet objet pour activer 3DS.
openAsfalsestring

Spécifier comment les fenêtres d’autorisation externes seront ouvertes (3DS, etc.)

  • IFRAME
  • NEW_TAB
applePayfalseobjectDonnées supplémentaires pour le mode de paiement Apple Pay. Doit être fourni si paymentType = APPLEPAY
singleUseCustomerTokenfalsestringIl s’agit du singleUseCustomerToken que le marchand a généré à l’aide de la requête Create a Single-Use Customer Token (Créer un jeton client à usage unique).
paymentTokenFromfalsestringIl s’agit d’un gestionnaire de paiement à usage unique associé au client.
customerDetails
holderNameconditionalstring

Nom du titulaire de la carte, 160 caractères maximum.

Lors de l’utilisation de 3DS 2 (useThreeDSecureVersion2= true) et d’une marque de carte prise en charge pour 3DS 2, le nom du titulaire est obligatoire et doit comporter entre 2 et 160 caractères.

billingDetailsfalseobjectAdresse de facturation de la carte : des détails supplémentaires pour l’objet billingDetails se trouvent dans la documentation sur l’API Paiements.
profilefalseobjectIl s’agit du profil du client : des détails supplémentaires pour l’objet profile se trouvent dans la documentation sur L’API Paiements.
billingDetails
countrytruestringPays de l’adresse de facturation
ziptruestringCode postal/zip de l’adresse
statefalsestringÉtat/province/région de l’adresse
cityfalsestringVille dans laquelle l’adresse est située
streetfalsestringLa première ligne de l’adresse municipale
street2falsestringLa deuxième ligne de l’adresse municipale
phonefalsestringLe numéro de téléphone du client
nicknamefalsestringLe surnom du client
profile
firstNamefalsestringIl s’agit du prénom du client.
lastNamefalsestringIl s’agit du nom de famille du client.
localefalsestring

Il s’agit du lieu de résidence du client.

Valeurs éventuelles :

  • ca_en
  • en_US
  • fr_CA
  • en_GB
dateOfBirthfalsestringIl s’agit de la date de naissance du client.
adresse courrielfalsestringIl s’agit de l’adresse courriel du client.
phonefalsestringIl s’agit du numéro de téléphone du client.
dateOfBirth
dayfalsenumberLe jour de naissance du client.
yearfalsenumberL’année de naissance du client.
monthfalsenumberLe mois de naissance du client.
merchantDescriptor
dynamicDescriptortrue

string

length<=20

Il s’agit d’un descripteur de marchand qui sera affiché sur le relevé de carte du client.
phonefalse

string

length<=13

Il s’agit du numéro de téléphone du marchand, qui sera ajouté au descripteur du marchand sur le relevé de carte du client.
threeDsthreeDS
merchantUrltruestringIl s’agit de l’adresse URL complète du site Web commercial ou du service à la clientèle du marchand.
deviceChanneltruestring

Il s'agit du type d'interface de canal utilisé pour initier la transaction. Les valeurs éventuelles sont :

  • BROWSER
  • SDK
  • 3RI
useThreeDSecureVersion2falseboolean

Spécifie si cette instance de Paysafe.js doit implémenter 3DS 2. Si « true » et que « accountId » n’est pas configuré pour 3DS 2, une erreur sera renvoyée dans le rappel.

S’il est omis, la valeur par défaut est « false ».

authenticationPurposefalsestring

Indique le type de requête d’authentification. Cet élément de données fournit des informations supplémentaires à ACS afin de déterminer la meilleure approche pour traiter une requête d’authentification. Les valeurs éventuelles sont :

  • PAYMENT_TRANSACTION
  • INSTALMENT_TRANSACTION

S’il est omis, la valeur par défaut est PAYMENT_TRANSACTION.

maxAuthorizationsForInstalmentPaymentconditionalnumber

Indique le nombre maximum d’autorisations permises pour les paiements échelonnés.

Min = 1

Max = 999

Requis lorsque authenticationPurpose = INSTALMENT_TRANSACTION.

billingCycleconditionalobject

Informations sur le cycle de facturation pour les paiements récurrents.

Requis lorsque authenticationPurpose = INSTALMENT_TRANSACTION.

electronicDeliveryfalseobjectIl s’agit de l’information sur la livraison électronique.
profilefalseobjectIl s’agit du profil du client.
messageCategoryfalsestring

Il s'agit de la catégorie du message pour un cas d'utilisation spécifique. Les valeurs éventuelles sont :

  • PAYMENT
  • NON_PAYMENT

S’il est omis, la valeur par défaut est PAYMENT.

requestorChallengePreferencefalsestring

Indique si un défi est demandé pour cette transaction. Les valeurs éventuelles sont :

  • CHALLENGE_MANDATED
  • CHALLENGE_REQUESTED
  • NO_PREFERENCE
transactionIntentconditionalstring

Identifie le type de transaction étant autorisée. Cet élément n’est requis que sur certains marchés, p. ex. le Brésil. Les valeurs éventuelles sont :

  • GOODS_OR_SERVICE_PURCHASE
  • CHECK_ACCEPTANCE
  • ACCOUNT_FUNDING
  • QUASI_CASH_TRANSACTION
  • PREPAID_ACTIVATION
initialPurchaseTimeconditionalstringIl s’agit de la date et de l’heure de l’achat. Le format de date ISO 8601 est attendu, c’est-à-dire AAAA-MM-JJ-THH:MM:SSZ. Remarque : Cet élément n’est requis que si messageCategory=NON_PAYMENT et authenticationPurpose=INSTALMENT_TRANSACTION ou RECURRING_TRANSACTION.
orderItemDetailsfalseobjectIl s’agit des détails d’un achat ou d’une précommande effectués précédemment.
purchasedGiftCardDetailsfalseobjectIl s’agit des détails d’un achat effectué précédemment avec une carte-cadeau.
userAccountDetailsfalseobjectIl s’agit des détails du compte d’utilisateur du site Web du marchand.
billingCycle
endDatetruestringIl s’agit de la date après laquelle aucune autre autorisation ne sera accordée. Le format de date ISO 8601 est attendu, c’est-à-dire AAAA-MM-JJ.
frequencytruenumber

Il s’agit du nombre minimum de jours entre deux autorisations.

Min = 1

Max = 999

electronicDelivery
isElectronicDeliverytruebooleanIndique si le produit est livré par voie électronique. L’objet electronicDelivery est facultatif; cependant, si l’objet est utilisé, cet élément est obligatoire.
adresse courrielfalse

string

longueur <= 240ₒcaractères

Il s’agit de l’adresse courriel à laquelle la marchandise a été livrée.

profile
adresse courrielfalse

string

longueur <= 255ₒcaractères

Il s’agit de l’’adresse courriel du client.

phonefalse

string

longueur <= 40ₒcaractères

Il s’agit du numéro de téléphone principal du client.
cellphonefalse

string

longueur <= 40ₒcaractères

Il s’agit du numéro de téléphone cellulaire du client.
orderItemDetails
preOrderItemAvailabilityDatefalsestringPour un achat en précommande, il s’agit de la date à laquelle la marchandise est censée être disponible. Le format de date ISO 8601 est attendu, c’est-à-dire AAAA-MM-JJ.
preOrderPurchaseIndicatorfalsestring

Indique si le titulaire de la carte passe une commande pour des marchandises disponibles ou des marchandises dont la disponibilité ou la date de sortie est à venir. Les valeurs éventuelles sont :

  • MERCHANDISE_AVAILABLE
  • FUTURE_AVAILABILITY
reorderItemsIndicatorfalsestring

Indique si le titulaire de la carte commande à nouveau des marchandises. Les valeurs éventuelles sont :

  • FIRST_TIME_ORDER
  • REORDER
shippingIndicatorfalsestring

Il s’agit du mode de livraison pour la transaction. Les valeurs éventuelles sont :

  • SHIP_TO_BILLING_ADDRESS
  • SHIP_TO_VERIFIED_ADDRESS
  • SHIP_TO_DIFFERENT_ADDRESS
  • SHIP_TO_STORE
  • DIGITAL_GOODS
  • TRAVEL_AND_EVENT_TICKETS
  • OTHER
purchasedGiftCardDetails
montantfalsenumber

Il s’agit du montant de la carte-cadeau, en unités mineures.

Max = 99999999999

countfalsenumber

Il s’agit du nombre total de cartes prépayées, de cartes-cadeaux ou de codes achetés.

Max = 99

devisefalsestringCode à trois caractères pour la devise de la carte-cadeau – p. ex. USD pour dollars américains.
userAccountDetails
createdDatefalsestringIl s’agit de la date à laquelle le titulaire de la carte a ouvert le compte auprès du demandeur 3DS. Le format de date ISO 8601 est attendu, c’est-à-dire AAAA-MM-JJ.
createdRangefalsestring

Il s’agit du temps écoulé entre l’ouverture du compte par le titulaire de la carte auprès du demandeur 3DS et l’appel API de la transaction en cours. Les valeurs éventuelles sont :

  • DURING_TRANSACTION
  • NO_ACCOUNT
  • LESS_THAN_THIRTY_DAYS
  • THIRTY_TO_SIXTY_DAYS
  • MORE_THAN_SIXTY_DAYS
changedDatefalsestringIl s’agit de la date à laquelle le compte du titulaire de la carte auprès du demandeur 3DS a été modifié pour la dernière fois. Le format de date ISO 8601 est attendu, c’est-à-dire AAAA-MM-JJ.
changedRangefalsestring

Il s’agit du temps écoulé entre la dernière modification des informations relatives au compte du titulaire de la carte et l’appel à l’API de la transaction en cours. Les valeurs éventuelles sont :

  • MORE_THAN_SIXTY_DAYS
  • DURING_TRANSACTION
  • LESS_THAN_THIRTY_DAYS
  • THIRTY_TO_SIXTY_DAYS
passwordChangedDatefalsestringIl s’agit de la date à laquelle le compte du titulaire de la carte a été réinitialisé ou le mot de passe modifié. Le format de date ISO 8601 est attendu, c’est-à-dire AAAA-MM-JJ.
passwordChangedRangefalsestring

Il s’agit du temps écoulé entre le dernier changement de mot de passe ou la réinitialisation du compte du titulaire de la carte et l’appel à l’API de la transaction en cours. Les valeurs éventuelles sont :

  • MORE_THAN_SIXTY_DAYS
  • NO_CHANGE
  • DURING_TRANSACTION
  • LESS_THAN_THIRTY_DAYS
  • THIRTY_TO_SIXTY_DAYS
totalPurchasesSixMonthCountfalsenumber

Il s’agit du nombre total d’achats effectués sur le compte de ce titulaire au cours des six derniers mois.

Max = 9999

addCardAttemptsForLastDayfalsenumber

Il s’agit du nombre de tentatives d’ajout de carte au cours des dernières 24 heures.

Max = 999

transactionCountForPreviousDayfalsenumber

Il s’agit du nombre de transactions (réussies et abandonnées) pour ce compte de titulaire de carte avec le demandeur 3DS sur tous les comptes de paiement au cours des 24 dernières heures.

Max = 999

transactionCountForPreviousYearfalsenumber

Il s’agit du nombre de transactions (réussies et abandonnées) pour ce compte de titulaire de carte avec le demandeur 3DS sur tous les comptes de paiement au cours de l’année précédente.

Max = 999

suspiciousAccountActivityfalsebooleanIndique si le demandeur 3DS a constaté une activité suspecte, y compris une fraude antérieure, sur le compte du titulaire de la carte.
shippingDetailsUsagefalseobjectIl s’agit des informations relatives à l’utilisation des services d’expédition.
paymentAccountDetailsfalseobjectIl s’agit des détails du compte de paiement courant du titulaire de la carte.
userLoginfalseobjectIl s’agit des informations de connexion du titulaire de la carte.
priorThreeDSAuthenticationfalseobjectIl s’agit des informations d’authentification précédentes utilisées avec le marchand, le titulaire de la carte et la carte actuels.
travelDetailsfalseobjectIl s’agit des détails de voyage spécifiques à Amex.
shippingDetailsUsage
cardHolderNameMatchfalsebooleanIndique si le nom du titulaire du compte est identique au nom d’expédition utilisé pour cette transaction.
initialUsageDatefalsestringIl s’agit de la date à laquelle l’adresse d’expédition pour cette transaction a été utilisée pour la première fois avec le demandeur 3DS. Le format de date ISO 8601 est attendu, c’est-à-dire AAAA-MM-JJ.
initialUsageRangefalsestring

Il s’agit du temps écoulé entre la première utilisation de cette adresse de livraison et la transaction en cours. Les valeurs éventuelles sont :

  • MORE_THAN_SIXTY_DAYS
  • CURRENT_TRANSACTION
  • LESS_THAN_THIRTY_DAYS
  • THIRTY_TO_SIXTY_DAYS
paymentAccountDetails
createdDatefalsestringIl s’agit de la date à laquelle le titulaire de la carte a ouvert le compte auprès du demandeur 3DS. Le format de date ISO 8601 est attendu, c’est-à-dire AAAA-MM-JJ.
createdRangefalsestring

Indique la durée pendant laquelle le compte de paiement a été inscrit sur le compte du titulaire de la carte auprès du demandeur 3DS. Les valeurs éventuelles sont :

  • MORE_THAN_SIXTY_DAYS
  • NO_ACCOUNT
  • DURING_TRANSACTION
  • LESS_THAN_THIRTY_DAYS
  • THIRTY_TO_SIXTY_DAYS
userLogin
datafalsestring

Ce champ est réservé aux futures itérations de 3D Secure 2.

longueur <= 2048ₒcaractères

authenticationMethodfalsestring

Il s’agit du mécanisme utilisé par le titulaire de la carte pour s’authentifier auprès du demandeur 3DS. Les valeurs éventuelles sont :

  • THIRD_PARTY_AUTHENTICATION
  • NO_LOGIN
  • INTERNAL_CREDENTIALS
  • FEDERATED_ID
  • ISSUER_CREDENTIALS
  • FIDO_AUTHENTICATOR
timefalsestringIl s’agit de la date et de l’heure de l’authentification du titulaire de la carte. Le format de date ISO 8601 est attendu, c’est-à-dire : AAAA-MM-JJ-THH:MM:SSZ.
priorThreeDSAuthentication
datafalsestring

Ce champ est réservé aux futures itérations de 3D Secure 2.

longueur <= 2048ₒcaractères

methodfalsestring

Il s’agit du mécanisme utilisé par le titulaire de la carte pour s’authentifier auprès du demandeur 3DS. Les valeurs éventuelles sont :

  • FRICTIONLESS_AUTHENTICATION
  • ACS_CHALLENGE
  • AVS_VERIFIED
  • OTHER_ISSUER_METHOD
Idfalsestring

Il s’agit d’un ancien identifiant d’authentification du titulaire de la carte.

longueur <= 36ₒcaractères

timefalsestringIl s’agit de la date et de l’heure de l’authentification du titulaire de la carte. Le format de date ISO 8601 est attendu, c’est-à-dire : AAAA-MM-JJ-THH:MM:SSZ.
travelDetails
isAirTravelfalseboolean

Indique si la transaction est un achat lié au transport aérien, p. ex. l’achat d’un billet.

S’il est omis, la valeur par défaut est « false ».

airlineCarrierconditionalstring

Il s’agit du transporteur aérien sélectionné.

Remarque : Cet élément n’est requis que si isAirTravel=true.

longueur <= 256ₒcaractères

departureDateconditionalstring

Il s’agit de la date de départ dans le fuseau horaire du lieu de départ. Le format de date ISO 8601 est attendu, c’est-à-dire AAAA-MM-JJ.

Remarque : Cet élément n’est requis que si isAirTravel=true.

destinationconditionalstring

Il s’agit du code de l’aéroport de destination.

Remarque : Cet élément n’est requis que si isAirTravel=true.

longueur <= 5ₒcaractères

originconditionalstring

Il s’agit du code de l’aéroport de départ.

Remarque : Cet élément n’est requis que si isAirTravel=true.

longueur <= 5ₒcaractères

passengerFirstNameconditionalstring

Il s’agit du prénom du titulaire de la carte figurant dans les données de facturation.

Remarque : Cet élément n’est requis que si isAirTravel=true.

longueur <= 99ₒcaractères

passengerLastNameconditionalstring

Il s’agit du nom de famille du titulaire de la carte figurant dans les données de facturation.

Remarque : Cet élément n’est requis que si isAirTravel=true.

longueur <= 99ₒcaractères

applePay
countrytruestringLe code de pays à deux caractères en exposant ISO 3166.

Exemple de tokenisation

<html>
...
<body>
...
<script>
let instance;
paysafe.fields.setup("my Base64 encoded single-use-token API key", {
currencyCode: 'USD'
}).then(hostedInstance => {
instance = hostedInstance;
return instance.show();
}).then(paymentMethods => {
if(paymentMethods.card && !paymentMethods.card.error) {
var payButton = document.getElementById("payButton");
payButton.addEventListener("click", function (event) {
instance.tokenize({
amount: 1000,
transactionType: "PAYMENT",
paymentType: "CARTE",
merchantRefNum: 'merchant-ref-num',
}).then(result => {
// handle result
}).catch(error => {
console.log(error);
});
});
}
}).catch(error => {
console.log(error);
});
</script></body></html>

Exemple de segmentation en unités avec 3D Secure

<html>
...
<body>
...
<script>
let instance;
paysafe.fields.setup("my Base64 encoded single-use-token API key", {
currencyCode: 'USD'
}).then(hostedInstance => {
instance = hostedInstance;
return instance.show();
}).then(paymentMethods => {
if(paymentMethods.card && !paymentMethods.card.error) {
var payButton = document.getElementById("payButton");
payButton.addEventListener("click", function (event) {
instance.tokenize({
amount: 1000,
threeDs: {
deviceChannel: "BROWSER"
},
transactionType: "PAYMENT",
paymentType: "CARTE",
merchantRefNum: 'merchant-ref-num',
}).then(result => {
// handle result
}).catch(error => {
console.log(error);
});
});
}
}).catch(error => {
console.log(error);
});
</script></body></html>

Pour les cartes inscrites au système 3D Secure, le client peut voir apparaître une fenêtre superposée de l’émetteur de sa carte pour autoriser le paiement. 3D Secure 2 n’est pris en charge que par Visa, Mastercard et American Express.

Segmentation en unités avec 3D Secure

3D Secure 2 offre un moyen amélioré et transparent d’authentifier les clients, tout en prenant en charge les applications mobiles et la validation biométrique et par jeton, et en rationalisant le passage en caisse grâce à l’authentification « sans friction ». Voir la documentation 3D Secure 2 pour plus de détails sur la mise en œuvre de 3D Secure 2. 

Le marchand doit d’abord être configuré par Paysafe Group afin d’utiliser 3D Secure 2. 3D Secure 2 n’est pris en charge que par Visa, Mastercard et American Express.

Avec 3D Secure 2, le marchand peut passer des paramètres facultatifs supplémentaires dans l’objet ThreeDS de Paysafe.js :

  • authenticationPurpose – seules deux valeurs sont autorisées : PAYMENT_TRANSACTION (valeur par défaut) et INSTALMENT_TRANSACTION
  • maxAuthorizationsForInstalmentPayment
  • billingCycle

Voir l’objet authentifications dans la documentation de l’API 3D Secure 2 pour une description de ces paramètres.

Le paramètre holderName est obligatoire pour pouvoir utiliser 3D Secure 2.

Exemple de segmentation en unités avec ApplePay

Pour segmenter les données applePay, vous devez indiquer le type de paiement APPLEPAY et les données supplémentaires applePay dans les options de tokenisation.

Cette fonction de segmentation en unités accepte un objet d’options et est une promesse, qui se résout en un gestionnaire de paiement à usage unique. Le gestionnaire de paiement représente les données sensibles de la carte ApplePay de l’utilisateur. Cette fonction peut être utilisée par l’API Paiements pour accepter des paiements. Le gestionnaire de paiement à usage unique n’est valide que 15 minutes. Voir Configuration de la signature.

<html>
...
<body>
...
<script>
let instance;
paysafe.fields.setup("my Base64 encoded single-use-token API key", {
currencyCode: 'USD',
fields: {
applePay: {
selector: '#apple-pay',
type: 'buy',
label: 'Demo JS',
color: 'white-outline',
}
},
}).then(hostedInstance => {
instance = hostedInstance;
return instance.show();
}).then(paymentMethods => {
if(paymentMethods.applePay && !paymentMethods.applePay.error) {
var payButton = document.getElementById("apple-pay");
payButton.addEventListener("click", function (event) {
instance.tokenize({
amount: 1000,
transactionType: "PAYMENT",
paymentType: "APPLEPAY",
applePay: {
country: 'US',
},
merchantRefNum: 'merchant-ref-num',
}).then(result => {
// handle result
// Close Apple Pay window
instance.complete('success');
}).catch(error => {
console.log(error);
// Close Apple Pay window
instance.complete('fail');
});
});
}
}).catch(error => {
console.log(error);
});
</script></body></html>

Segmenter une signature de promesse

La fonction instance.tokenize() renvoie une promesse, qui contient le résultat de la tokenisation.

La promesse fait référence aux paramètres décrits ci-dessous. 

ParamètreRequisTypeDescription
resultfalseobjectLe résultat contenant le jeton de paiement.
errorResponsethrowsobjectEn cas d’erreur, la segmentation en unités sera rejetée avec l’objet errorResponse.
errorResponse
codetruestringCode d’erreur court identifiant le type d’erreur.
displayMessagetruestringFournit un message d’erreur qui peut être affichée aux utilisateurs.
detailedMessagetruestringUn message d’erreur détaillé qui peut être consigné.
correlationIdtruestringIdentifiant unique qui peut être fourni à l’équipe de soutien Paysafe comme référence pour l’investigation.
fieldErrorsfalsearrayDétails de toute erreur de valeur de paramètre (facultatif). Actuellement, seulement lorsqu’une erreur 9003 est générée.
fieldError
fieldtruestringNom du champ. Par exemple : threeDS.userAccountDetails.userLogin.time.
messagetruestringErreur dans le champ.
result
tokenfalsestringJeton de paiement représentant les détails sensibles de la carte après une tokenisation réussie.

Liste des erreurs de rappel de segmentation en unités

CodeMessage affichéMessage détailléDescription
9001Aucune connexion au serveur.Aucune connexion au serveur.La requête transmise au serveur a échoué. Code d’état HTTP 0 sans corps de réponse.
9002Erreur de communication avec le serveur.Erreur de communication avec le serveur.

La réponse du serveur ne peut pas être traitée.

  • Le format de réponse n’est pas JSON.
  • Le code d’état HTTP est 200, mais aucun jeton de paiement n’est présent.
  • Le code d’état HTTP est différent de 200, mais il n’y a pas de code d’erreur ni de description.
9003Invalid fields: ${fields}.Invalid fields: ${fields}.E.g., Invalid fields: card number,cvv,expiry date,threeDS.authenticationPurpose.

Un ou plusieurs champs ont des valeurs non valides. L’erreur pour les champs non valides provient des validations frontales ou lorsque l’API Coffre-fort client ou 3D Secure 2 renvoie l‘erreur 5068 ou 7508.

Les valeurs éventuelles sont les suivantes (remarquez les espaces) :

  • numéro de la carte
  • cvv
  • date d’expiration
  • année d’expiration
  • mois d’expiration
  • Tous les champs 3D Secure 2 aussi. Par exemple, threeDS.billingCycle.endDate.
9015Il y a eu une erreur (9015), veuillez contacter notre service de soutien.Argument d’options non valide.Le paramètre options n’est pas un objet.
9037Erreur de communication avec le serveur 3DS.Erreur de communication avec le serveur 3DS.Une erreur s’est produite lors de la communication avec l’API 3DS.
9039L’inscription n’est pas acceptée. Réessayez avec la même carte ou une autre carte.Le résultat de l’inscription n’est pas accepté pour le compte fourni.La carte du client n’est pas inscrite à 3DS.
9040Authenfication non acceptée. Réessayez avec la même carte ou une autre carte.Le résultat de l’authentification n’est pas accepté pour le compte fourni.L’authentification du paiement 3DS a échoué.
9041Il y a eu une erreur (9041), veuillez contacter notre service de soutien.Il y a eu une erreur (9041), veuillez contacter notre service de soutien.Aucun PaRes n’est renvoyé par le serveur ACS
9042L’utilisateur a interrompu l’authentification.L’utilisateur a interrompu l’authentification.Le client a interrompu le processus d’authentification 3DS sur le site de la banque émettrice.
9110Il y a eu une erreur (9110), veuillez contacter notre service de soutien.Impossible de lancer la SDK ThreeDs.Utilisé lorsque la SDK ThreeDs n’a pas réussi à se charger ou que le rappel de démarrage de la SDK ThreeDs a été invoqué avec une erreur non gérée.
9111Il y a eu une erreur (9111), veuillez contacter notre service de soutien.Configuration du marchand non valide.Utilisé lorsque la configuration du marchand n’est pas valide
9114Il y a eu une erreur (9114), veuillez contacter notre service de soutien.Impossible de lancer le défi de la SDK ThreeDs.Utilisé lorsque le rappel de défi de la SDK ThreeDs est invoqué avec une erreur.
9125Il y a eu une erreur (9125), veuillez contacter notre service de soutien.Marque de carte non prise en charge utilisée : [...].Utilisé lorsque le client utilise une marque de carte non prise en charge par la configuration 3D Secure 2 du marchand.
9073Une erreur s’est produite (9073); veuillez contacter notre service de soutien.Le compte n’est pas configuré correctement.Le compte marchand utilisé pour la segmentation en unités n’est pas configuré ou est absent du portail d’administration.
9131Une erreur est survenue (9131); veuillez contacter notre service de soutien.L’état du payment handle est FAILEDÉchec de création du Payment handle. Pour plus d’informations, veuillez consulter le code d’erreur dans le portail d’entreprise.
Erreurs spécifiques à ApplePay
9072Il y a eu une erreur (9072), veuillez contacter notre service de soutien.Le nom de domaine n’est pas vérifié dans le compte Apple du développeur pour l’identification du marchand : ${apple_merchant_id}Le nom de domaine n’est pas vérifié pour le compte développeur de l’identifiant Apple spécifié.
9083Il y a eu une erreur (9083), veuillez contacter notre service de soutien.Un problème est survenu lors de l’analyse des données de paiement Apple Pay. Veuillez essayer de nouveau.Impossible de traiter les données Apple Pay renvoyées par la session Apple.
9089Il y a eu une erreur (9089), veuillez contacter notre service de soutien.La validation du marchand chez Apple a échouéLa validation du marchand par rapport aux serveurs d’Apple Pay a échoué.