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.
- 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.
- 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 En attente de remise
Le marchand a demandé la création d'un paiement différé ou bien d'un paiement par alias ou récurrent.
Spécificité pour les paiement par alias et les paiements récurrents. Ce statut est temporaire et n'indique pas que la transaction sera acceptée.Au moment de la remise, la transaction se trouve dans l’onglet "Transactions remisées" du Back Office Marchand avec le statut "remise en cours" . Elle est en cours de validation auprès de Paypal.
- Si Paypal accepte la transaction, le statut final est CAPTURED, visible dans l'onglet "Transactions remisées" du Back Office Marchand avec le statut "présenté".
- Si Paypal refuse la transaction, le statut final est CAPTURE_FAILED, visible dans l'onglet "Transactions remisées" du Back Office Marchand avec le statut "dysfonctionnement".
Pour être notifié, le marchand doit impérativement 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 EXPIRED. Le statut Expiré est définitif.
CANCELLED Annulé
Le paiement a été annulé par le marchand.
CAPTURED Présenté
Le marchand a demandé la création d'un paiement immédiat.
La transaction est remise en banque.
CAPTURE_FAILED 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 suivant pour obtenir plus de détail sur le refus du paiement.
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.
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 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 passera automatiquement à À valider
ou Refusé (en fonction du résultat de l'autorisation qui sera réalisée). - 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.
- 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.
- 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. - 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.