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 :

  1. Identifiez le mode (TEST ou PRODUCTION) dans lequel a été créé la transaction en analysant la valeur du champ vads_ctx_mode.
  2. 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.
  3. 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.

  4. 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.
    ... ...
  5. 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.
  6. 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.
  7. 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.
  8. 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.
  9. Enregistrez le numéro du contrat associé à la transaction en récupérant la valeur du champ vads_contract_used.
  10. 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.
  11. Procédez à la mise à jour de la commande.