Traiter les données de la réponse

Ci-dessous un exemple d'analyse pour vous guider pas à pas lors du traitement des données de la réponse.

  1. Identifiez la commande en récupérant la valeur du champ vads_order_id si vous l'avez transmise dans le formulaire de paiement.
    Vérifiez que le statut de la commande n'a pas déja été mis à jour.
  2. Récupérez le résultat du paiement transmis dans le champ vads_trans_status.
    Sa valeur vous permet de définir le statut de la commande.
    VALEUR DESCRIPTION
    CAPTURED

    Présenté

    Le marchand a demandé la création d'un paiement immédiat.

    La transaction est remise en banque.

    AUTHORISED

    En attente de remise

    Le marchand a demandé la création d'un paiement différé.

    La transaction est remise en banque.

    REFUSED

    Refusé

    La transaction est refusée.

    Consultez le chapitre suivant pour obtenir plus de détail sur le refus du paiement.

    WAITING_AUTHORISATION En attente d'autorisation

    Le marchand a demandé la création d'un paiement différé à plus de 3 jours.

    AUTHORISED_TO_VALIDATE À valider et autoriser

    La transaction, créée en validation manuelle, est autorisée. Le marchand doit valider manuellement la transaction afin qu'elle soit remise en banque.

    La transaction peut être validée tant que la date d'expiration de la demande d'autorisation n’est pas dépassée. Si cette date est dépassée alors le paiement prend le statut EXPIRED. Le statut Expiré est définitif.

    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é.

    UNDER_VERIFICATION

    Vérification en cours

    Pour les transactions PayPal, cette valeur signifie que PayPal retient la transaction pour suspicion de fraude.

    Le paiement restera dans l’onglet Transactions en cours jusqu'à ce que les vérifications soient achevées. La transaction prendra alors l'un des statuts suivants: AUTHORISED ou CANCELED.

    Une notification sera envoyée au marchand pour l'avertir du changement de statut (Notification sur modification par batch).

  3. Récupérez la référence du paiement transmise dans le champ vads_trans_id.
  4. Récupérez la valeur du champ vads_trans_date pour identifier la date du paiement.
  5. Récupérez le montant et la devise utilisée. Pour cela, récupérez les valeurs des champs suivants:
    Tableau 1. Analyse du montant et de la devise utilisée
    Nom du champ Description
    vads_amount Montant du paiement dans sa plus petite unité monétaire.
    vads_currency Code numérique de la devise utilisée pour le paiement.
    vads_change_rate Taux de change utilisé pour calculer le montant réél du paiement (voir vads_effective_amount).
    vads_effective_amount Montant du paiement dans la devise réellement utilisée pour effectuer la remise en banque.
    vads_effective_currency Code numérique de la devise dans laquelle la remise en banque sera effectuée.
  6. Récupérez le moyen de paiement utilisé pour le paiement en analysant le champ vads_card_brand.
  7. 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.
  8. Sauvegardez la valeur du champ vads_authent_paypal_protection_eligibility pour connaître le type de protection en vigueur pour la transaction.
    Trois valeurs possibles :
    • ELIGIBLE
      Le marchand est protégé par le règlement sur la Protection des Marchands PayPal pour les paiements non autorisés et les objets non reçus.
    • PARTIALLY_ELIGIBLE
      Le marchand est protégé par le règlement sur la Protection des Marchands PayPal pour les objets non reçus.
    • INELIGIBLE
      Le marchand n'est pas protégé par le règlement sur la Protection des Marchands PayPal.
  9. Procédez à la mise à jour de la commande.