Traiter les données spécifiques à la réponse d'un paiement via un wallet
Les données retournées dans la
réponse peuvent être spécifiques au contrat acquéreur déclaré sur la boutique.
L'url de notification instantanée contiendra notamment les informations ci-dessous :
- Identifiez le mode (TEST ou PRODUCTION) dans lequel a été créé la transaction en analysant la valeur du champ vads_ctx_mode.
-
Identifiez la commande en récupérant la valeur du champ vads_order_id si vous l'avez transmis
dans le formulaire de paiement. Sinon, récupérez la valeur du champ vads_trans_id.
En cas de rejeu de l'IPN, vérifiez que le statut de la commande n'a pas déja été mis à jour.
-
Identifiez le résultat du paiement en
récupérant la valeur du champ vads_trans_status.
La valeur retournée dans le champ vads_trans_status est spécifique au contrat acquéreur de la boutique.
Valeur Description AUTHORISED La transaction est acceptée et sera remise en banque automatiquement à la date prévue.
CAPTURED Présenté
La transaction est remise en banque.
ABANDONED Paiement abandonné par l’acheteur.
La transaction n’est pas créée et n’est donc pas visible dans le Back Office Expert.
CANCELLED Annulé
Annulation par l'acheteur, l'acquéreur ou par la plateforme.
REFUSED Refusé
AUTHORISED_TO_VALIDATE À valider et autoriser
EXPIRED Expiré
La date d'expiration de la demande d'autorisation est atteinte et le marchand n’a pas validé la transaction. Le porteur ne sera donc pas débité.
Pour plus de détails, se référer au Guide d'implémentation API Formulaire disponible sur notre site documentaire.
-
Enregistrez le type de carte utilisé pour le paiement en
récupérant la valeur du champ vads_card_brand.
Tableau 1. Exemples de valeurs du champvads_card_brand Valeur du champ vads_card_brand Description CB Paiement effectué avec une carte bancaire CB. MASTERCARD Paiement effectué avec une carte Mastercard. VISA Paiement effectué avec une carte Visa. ... ... -
Vous pouvez enregistrer le type de wallet qui a servi pour le
paiement en récupérant la valeur du champ vads_wallet.
Valeur du champ vads_wallet Type de wallet PAYPAL Paypal live PAYPAL_SBX Paypal Sandbox Le champ vads_wallet est présent uniquement lorsqu'un wallet est utilisé pour le paiement. -
Contrôler le montant et la devise utilisée. Pour cela,
récupérez les valeurs des champs suivants :
Nom du champ Description vads_amount Montant du paiement dans sa plus petite unité monétaire. vads_currency Code de la devise utilisée pour le paiement. -
Contrôler la valeur du champ vads_result pour connaître l'état de la
transaction.
Les valeurs possibles sont décrites dans le tableau suivant. Elles sont toujours les mêmes quelque soit le moyen de paiement. En cas d'échec, vous pouvez également consulter la valeur de vads_auth_result pour obtenir des informations complémentaires sur le motif de l'échec.
Valeur Description 00 Action réalisée avec succès. 02 Le marchand doit contacter la banque du porteur. Déprécié. 05 Action refusée. 17 Annulation de l'acheteur 30 Erreur de format de la requête. A mettre en rapport avec la valorisation du champ vads_extra_result. 96 Erreur technique. -
Contrôlez la valeur du champ vads_auth_result pour connaître le résultat de la demande
d'autorisation.
Cette information est également disponible dans le Back Office Expert. Pour la visualiser, affichez le détail d'une transaction. Dans les informations liées à l'autorisation, le détail du retour est affiché (code et libellé).Le code retour associé au champ vads_auth_result est en fonction du moyen de paiement utilisé et du réseau auquel il appartient.
- Enregistrez le numéro du contrat associé à la transaction en récupérant la valeur du champ vads_contract_used.
-
Récupérez toutes les informations concernant le détail de la
commande, le détail de l'acheteur et le détail de la livraison.
Ces données sont présentes dans la réponse que si elles ont été envoyées dans le formulaire de paiement.Leur valeur est identique à celle soumise dans le formulaire.
- Procédez à la mise à jour de la commande.