Traiter les données de la réponse
Exemple d'analyse lors du traitement des données de la réponse.
- Identifiez la commande en récupérant la valeur du champ
vads_order_id. Vérifiez que le statut de la commande n'a pas déjà été mis à jour.
- Récupérez le résultat du paiement transmis dans le champ
vads_trans_status. Sa valeur permet de définir le statut de la commande.
VALEUR DESCRIPTION AUTHORISED "En attente de remise"
Le marchand a demandé la création d'un paiement (différé, récurrent ou par alias). le paiement est en cours de validation auprès de Paypal.
Ce statut est temporaire et n'indique pas que la transaction sera acceptée.
Si Paypal accepte la transaction, le statut final ("Présenté" / CAPTURED) sera visible dans l'onglet "Transactions remisées" du Back Office Marchand à la date de remise.
Si Paypal refuse la transaction, le statut final ("Refusé" / REFUSED) est visible dans l'onglet "Transactions en cours" du Back Office Marchand .
Pour être notifié, le marchand doit configurer la règle de notification "URL de notification sur modification par batch" (voir chapitre Configurer la notification sur modification par batch).
AUTHORISED_TO_VALIDATE "À valider" 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 Expiré. Ce statut est définitif.
CANCELLED "Annulé" Le paiement a été annulé par le marchand.
CAPTURED "Présenté"
La transaction est remise en banque.
CAPTURE_FAILED "Dysfonctionnement" La remise de la transaction a échoué.
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 Analyser le résultat de la demande d'autorisation pour obtenir plus de détail sur le motif du refus.
UNDER_VERIFICATION "Vérification en cours"
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.
A l’issue de la vérification, la transaction prendra le statut "En attente de remise" ou "Refusé".
Une notification sera envoyée au marchand pour l'avertir du changement de statut (voir :Configurer la notification sur modification par batch).
WAITING_AUTHORISATION "En attente d'autorisation" Le marchand a demandé la création d'un paiement différé à plus de 3 jours.
WAITING_AUTHORISATION_TO_VALIDATE "À valider et autoriser" 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 passe automatiquement à "À valider" ou "Refusé" (en fonction du résultat de la demande d'autorisation).
- Dans le cas d'un paiement 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 total ou partiel est possible dans les 180 jours suivant la date de paiement initiale. 173 Erreur sur le service Express Checkout de PayPal. Cause possible : Restricted Account.
Si votre compte PayPal est restreint, contactez votre gestionnaire de litiges chez PayPal.
- Récupérez le champ vads_trans_uuid contenant la référence unique de la transaction générée par le serveur de paiement.
- Récupérez la référence de la transaction PayPal transmise dans le champ vads_ext_trans_id.
- Récupérez la valeur du champ vads_trans_date pour identifier la date du paiement.
- Dans les champs suivants, récupérez le montant et 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éel du paiement disponible dans le champ 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. - Récupérez les données du moyen de paiement utilisé pour le
paiement en analysant les champs suivants :
Nom du champ Description vads_card_brand Moyen de paiement. Valorisé à PAYPAL. vads_acquirer_network Réseau acquéreur. Valorisé à : - PAYPAL : pour un paiement de production
- PAYPAL_SB : pour un paiement de test
- 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.
- 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.
- ELIGIBLE
- Procédez à la mise à jour de la commande.