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éjà é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
    AUTHORISED

    Validé

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

    La transaction est acceptée et sera remise en banque automatiquement à la date prévue.

    AUTHORISED_TO_VALIDATE Revue manuelle

    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.

    CANCELLED

    Annulé

    Le paiement a été annulé par le marchand.

    CAPTURED

    Validé

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

    La transaction est remise en banque.

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

    REFUSED

    Refusé

    La transaction est refusée.

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

    UNDER_VERIFICATION

    En cours

    PayPal retient la transaction pour suspicion de fraude.

    La transaction prendra alors l'un des statuts suivants: AUTHORISED ou REFUSED.

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

    WAITING_AUTHORISATION Autorisation en attente

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

    WAITING_AUTHORISATION_TO_VALIDATE Revue manuelle, autorisation en attente

    Le paiement est en attente de validation de la part du marchand.

    A J-3 avant la date de remise, et sans validation de la part du marchand, le statut passera automatiquement à Revue manuelle

    ou Refusé (en fonction du résultat de l'autorisation qui sera réalisée).
  3. Si le paiement est refusé, vous pouvez vérifier si le motif de l'erreur est détaillé dans le champ vads_payment_error.
    Valeur Description
    75 L'opération a été refusée par PayPal.
    88 Remboursement impossible : le remboursement des transactions est interdit par PayPal au-delà de 60 jours.
    173 Erreur sur le service Express Checkout de PayPal.

    Cause possible: Restricted Account.

    Si votre compte PayPal est restreint, connectez-vous à votre Gestionnaire de litiges sur le site de PayPal.

  4. Récupérez la référence du paiement transmise dans le champ vads_trans_id.
  5. Récupérez la référence de la transaction PayPal transmise dans le champ vads_ext_trans_id.
  6. Récupérez la valeur du champ vads_trans_date pour identifier la date du paiement.
  7. Récupérez 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 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.
  8. Récupérez le moyen de paiement utilisé pour le paiement en analysant le champ vads_card_brand.
  9. 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.
  10. 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.

  11. Procédez à la mise à jour de la commande.