Rappels
resultCallback
Le rappel de résultat est invoqué lorsque le "payment handle" a été créé avec succès et se trouve dans l'état PAYABLE ou en cas d'erreur lors du passage à la caisse. Il transmet également une instance de l'objet Caisse. En utilisant les fonctions fournies dans l'objet d'instance, le marchand peut contrôler l'expérience au passage à la caisse.
Le resultCallback comporte les éléments suivants.
Paramètre | Type | Requis | Description |
---|---|---|---|
instance | object | Oui | Il s'agit de l'instance de paiements de Paysafe Checkout. |
error | object | Non | Cet objet comporte des informations d'erreur et est présent en cas d'échec de la création d'un "payment handle". |
result | object | Oui | C'est le résultat qui contient le jeton de paiement. |
{return} | undefined | false |
instance
Paramètre | Type | Requis | Description |
---|---|---|---|
isOpen | function | Oui | Vérifie si la superposition est encore ouverte. |
close | function | Oui | Ferme la superposition sans afficher le résultat du paiement. |
showSuccessScreen | function | Oui | Modifie la présentation de la caisse pour en faire un écran de réussite. |
showFailureScreen | function | Oui | Modifie la présentation de la caisse pour en faire un écran d'échec. |
error 
Paramètre | Type | Requis | Description |
---|---|---|---|
message | string | Oui | Fournit une erreur qui peut être affichée aux utilisateurs. |
detailedMessage | string | Oui | Fournit un message d'erreur détaillé qui peut être consigné. |
correlationId | string | Oui | Il s’agit d’un identifiant unique qui peut être fourni à l'équipe d'assistance Paysafe comme référence pour l'invsestigation. |
result
Paramètre | Type | Requis | Description |
---|---|---|---|
paymentHandleToken | string | Oui | Il s'agit du jeton de "payment handle" à inclure dans l'appel à l'API des paiements. |
paymentMethod | string | Oui | Il s’agit du mode de paiement utilisé par le client. |
customerOperation | string | Oui | Il s'agit de l'opération client pour la carte. Les valeurs éventuelles sont :
|
montant | number | Oui | Il s'agit du montant utilisé pour créer le "payment handle". Cela est nécessaire car l'utilisateur peut modifier le montant lors du passage à la caisse. |
Voici un exemple :
function(instance, error, result) {
if (result.token) {
// La carte a été correctement segmentée en unités, utilise result.token pour traiter un paiement.
console.log(result.token);
// ajoute un code AJAX pour envoyer le jeton à votre serveur marchand
instance.showSuccessScreen(« Vos marchandises sont maintenant achetées. Elles devraient être livrées dans les 5 prochains jours ouvrables »);
} else {
// tokenization failed
instance.showFailureScreen(« Le paiement a été refusé. Veuillez réessayer avec le même mode de paiement ou avec une autre mode. »);
}
}
closeCallback
Le rappel de fermeture. Il notifie le script marchand lorsque la caisse est fermée. Les actions suivantes invoquent le closeCallback :
- Lorsque le client ferme la caisse.
- Lorsque le marchand ferme la caisse à l'aide de la méthode instance.close() dans le rappel de résultat après l'appel de paiements.
Le closeCallback comporte les éléments suivants.
Paramètre | Type | Requis | Description |
---|---|---|---|
stage | string | Oui | Phase pendant laquelle la superposition de la caisse est fermée. Les valeurs éventuelles sont : PAYMENT_HANDLE_NOT_CREATED, PAYMENT_HANDLE_CREATED, PAYMENT_HANDLE_REDIRECT, PAYMENT_HANDLE_PAYABLE
|
expired | boolean | Oui | Ceci indique si l'événement a été déclenché après l'expiration du passage à la caisse. |
{return} | undefined | false |
riskCallback 
Applicable uniquement aux cartes, PaySafe Cash, VIPP et Sightline.
Ceci avise le marchand du montant et du mode de paiement lorsque l'utilisateur clique sur le bouton Payer/retrait lors du passage à la caisse. Les actions suivantes invoquent le riskCallback :
Lorsque le client clique sur le bouton Payer/Retrait à la caisse.
Le riskCallback comporte les éléments suivants.
Paramètre | Type | Requis | Description | |
---|---|---|---|---|
montant | string | Oui | Il s'agit du montant que le client souhaite payer. | |
paymentMethod | string | Oui | Il s’agit du mode de paiement utilisé par le client. | |
instance | object | Oui | Il s'agit de l'instance de paiements de Paysafe Checkout. | |
decline | function | Lorsque cette fonction est invoquée, la caisse considère que la vérification du risque a échoué & rend le message que vous transmettez en paramètre dans cette fonction. Veuillez consulter l’exemple. | ||
accept | function | Lorsque cette option est invoquée, la caisse considère que le rappel de vérification de risque est transmis & et procède à la création du "payment handle". Veuillez consulter l’exemple. |