Search Overlay

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ètreTypeRequisDescription
instanceobjectOuiIl s'agit de l'instance de paiements de Paysafe Checkout.
errorobjectNonCet objet comporte des informations d'erreur et est présent en cas d'échec de la création d'un "payment handle".
resultobjectOuiC'est le résultat qui contient le jeton de paiement.
{return}undefinedfalse

instance

ParamètreTypeRequisDescription
isOpenfunctionOuiVérifie si la superposition est encore ouverte.
closefunctionOuiFerme la superposition sans afficher le résultat du paiement.
showSuccessScreenfunctionOuiModifie la présentation de la caisse pour en faire un écran de réussite.
showFailureScreenfunctionOuiModifie la présentation de la caisse pour en faire un écran d'échec.

error

ParamètreTypeRequisDescription
messagestringOuiFournit une erreur qui peut être affichée aux utilisateurs.
detailedMessagestringOuiFournit un message d'erreur détaillé qui peut être consigné.
correlationIdstringOuiIl s’agit d’un identifiant unique qui peut être fourni à l'équipe d'assistance Paysafe comme référence pour l'invsestigation.

result

ParamètreTypeRequisDescription
paymentHandleTokenstringOuiIl s'agit du jeton de "payment handle" à inclure dans l'appel à l'API des paiements.
paymentMethodstringOuiIl s’agit du mode de paiement utilisé par le client.
customerOperationstringOui

Il s'agit de l'opération client pour la carte. Les valeurs éventuelles sont :

  • ADD
  • EDIT
  • DELETE
montantnumberOuiIl 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ètreTypeRequisDescription
stagestringOui

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

  • PAYMENT_HANDLE_NOT_CREATED: La caisse n'a pas ouvert de session avec Paysafe ou PSP.
  • PAYMENT_HANDLE_CREATED: La caisse ouvre une session avec Paysafe/PSP et obtient les informations nécessaires pour effectuer un paiement.
  • PAYMENT_HANDLE_REDIRECT: La caisse a redirigé avec succès le client vers la page hébergée par le PSP et attend le rappel de la page hébergée. Ceci ne s'applique qu'aux flux où le client est redirigé vers une autre page. Indique que le paiement est en cours dans la page redirigée. PAYMENT_HANDLE_PAYABLE: Le client a effectué le paiement, et soit le client ferme la caisse après avoir vu l'écran de réussite/d'échec (ceci peut être initié par le script du marchand dans le rappel de résultat en utilisant les méthodes instance.showSuccessScreen()/instance.showFailureScreen(), soit le script du marchand ferme la Caisse après l'appel de paiement depuis le rappel de résultat en appelant la méthode instance.close().
expiredbooleanOuiCeci indique si l'événement a été déclenché après l'expiration du passage à la caisse.
{return}undefinedfalse

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 TypeRequisDescription
montant stringOuiIl s'agit du montant que le client souhaite payer.
paymentMethod stringOuiIl s’agit du mode de paiement utilisé par le client.
instance objectOuiIl s'agit de l'instance de paiements de Paysafe Checkout.
 declinefunction 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.
 acceptfunction 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.