Fonction onTokenization
La fonction de rappel onTokenization recevra le résultat de tokenisation – un jeton à usage unique créé par l’API Coffre-fort client, qui peut être utilisé pour effectuer le paiement à l’aide de l’API Paiements par carte. La tentative de tokenisation peut réussir ou échouer, et dans onTokenization, vous devez appeler les fonctions showSuccess et showFailure après l’autorisation de la carte introduite dans la fiche de paiement.
La signature de la fonction est la suivante :
paysafe.request.onTokenization(callback);
Les paramètres de la fonction sont décrits ci-dessous.
| Requis | Type | Description | |||||
|---|---|---|---|---|---|---|---|
| callback | true | fonction (event, error){} | Rappel de l’utilisateur invoqué lorsque les informations de tokenisation sont disponibles. | ||||
| événement | true | object | Contient le résultat de la tokenisation. En cas d’échec, l’objet est nul et l’argument d’erreur contient des informations détaillées. Vous devez invoquer showFailure pour terminer le processus. En cas de réussite, vous devez invoquer showSuccess pour terminer le processus. | ||||
| showSuccess | true | function | Fonction qui doit être invoquée par le marchand pour montrer que la tokenisation a réussi. | ||||
| showFailure | true | function | Fonction qui doit être invoquée par le marchand pour montrer que la tokenisation a échoué. | ||||
| result | true | object | Résultat de tokenisation. | ||||
| paymentMethod | true | string | Mode de paiement utilisé : APPLEPAY | ||||
| token | true | string | Jeton à utiliser pour effectuer le paiement via l’API Paiements. | ||||
| shippingContact | false | object | Coordonnées pour l’expédition. Affiché si l’option init requestShippingAddress est définie sur true. | ||||
| name | true | string | Nom de la personne-ressource. | ||||
| adresse courriel | false | string | Adresse courriel de la personne-ressource. | ||||
| postalCode | true | string | Code postal correspondant à l’adresse. | ||||
| countryCode | true | string | Le code de pays à deux caractères en exposant ISO 3166 de l’adresse de livraison. | ||||
| addressLines | false | tableau de chaînes | Données de l’adresse. | ||||
| PhoneNumber | true | string | Numéro de téléphone de la personne-ressource. | ||||
| locality | false | string | Ville de la personne-ressource. | ||||
| administrativeArea | false | string | État/province de la personne-ressource | ||||
| billingContact | false | object | Informations de facturation de la personne-ressource. Affiché si l’option init requestBilliingAddress est définie sur true. | ||||
| name | true | string | Nom de la personne-ressource. | ||||
| adresse courriel | false | string | Adresse courriel de la personne-ressource. | ||||
| postalCode | true | string | Code postal correspondant à l’adresse. | ||||
| countryCode | true | string | Le code de pays ISO 3166 à deux caractères en exposant de l’adresse de facturation. | ||||
| addressLines | false | tableau de chaînes | Données de l’adresse. | ||||
| phoneNumber | true | string | Numéro de téléphone de la personne-ressource. | ||||
| locality | false | string | Ville de la personne-ressource. | ||||
| administrativeArea | false | string | État/province de la personne-ressource | ||||
| carte | true | object | Données de la carte utilisée lors de la tokenisation. | ||||
| network | true | string | Réseau de cartes. Par exemple : « Visa » ou « Mastercard ». | ||||
| type | true | string | Type de carte. Par exemple : « débit » ou « crédit ». | ||||
| lastDigits | true | string | Quatre derniers chiffres du numéro de la carte | ||||
| error | s.o. | object | Objet de l’erreur indiquant la raison de l’échec : | ||||
| {throws} | s.o. | Déclenche une exception avec les erreurs suivantes : 9004, 9014, 9067. | |||||
| {return} | false | ||||||
Exemple Apple Pay
Cet exemple dans l’environnement TEST montre comment spécifier l’apparence du bouton de paiement. Ne comprend pas init ni le code showButtons.
<html>
<head>
<script type="text/javascript" src="https://hosted.paysafe.com/request/v1/latest/paysafe.request.min.js"></script>
</head>
<body>
...
<div id="x-paysafe-apple-pay-button"></div>
...
<script>
paysafe.request.onTokenization(function (event, error) {
if (event) {
// Process the token - event.result.token
// Acknowledge - event.showSuccess() or reject event.showFailure()
event.showSuccess();
} else {
// handle error
}
});
</script>
</body>
</html>