Le principe
Pour évaluer l'état d'une demande de paiement, d'une transaction ou d'appels web service, le commerçant doit récupérer la valeur du ShortMessage.
Le ShortMessage du message fournit l'état de la transaction et le LongMessage donne une description plus précise avec son code retour.
Le cycle de vie d'une transaction est représenté ci-dessous. l'état de la transaction ShortMessage accepte 4 états définitif : REFUSED, CANCELLED, ERROR, ACCEPTED et 3 états temporaire INPROGRESS, ONHOLD_PARTNER, PENDING_RISK :
Les différents états
Payline propose un regroupement des codes retour et des états est définit comme indiqué ci-dessous :
ShortMessage : | LongMessage : | Description | Exemple |
|---|---|---|---|
| ERROR | Rejet technique "Invalid" ou "Error" | Le paiement a été abandonné suite à une erreur technique non récupérable. Payline procède à une régularisation auprès du moyen de paiement (état final). | 02301 - Transaction Id Invalid |
| ERROR | Problème de format Problème de valeur | Non traitable par Payline, les données envoyées par le commerçants sont erronées. | 02305 - Invalid field Format |
| ERROR | "Internal Server Error" | Erreur du système. | 01199 - GTM Internal Error |
| ACCEPTED | Acceptée | Le paiement est accepté (état final) | 00000 |
| CANCELLED | Annulée | Le paiement a été abandonné (état final) | 02319 - Cancelled by user 03022 - Abandon 3DSecure
|
| REFUSED | Problème de valeur | Erreur de saisie. Les données envoyées par le porteur sont erronées. |
|
| REFUSED | Refus fraude | Le paiement est refusé pour Fraude (état final). | 03xxxx - 3DSecure 04xxxx - LCLF |
| REFUSED | Refus fonctionnel | Refus fonctionnel de type : Not authorized / Not Allowed. | |
| REFUSED | Refus Émetteur/ Partenaire | Refus de l'acquéreur/émetteur/moyen de paiement. | |
| PENDING_RISK | Alerte de risque sur ce paiement | Paiement accepté avec réserve (état temporaire). Le commerçant doit procéder à la validation ou au refus du paiement. | 04001 et 04003 - Fraud suspected.
|
| ONHOLD_PARTNER | En attente de retour du partenaire | Le paiement a été acquitté par le partenaire de paiement et mis en attente pour une prise de décision ultérieure (état temporaire). La décision finale (accepté ou refusé) sera communiquée par le partenaire sans intervention du commerçant. |
|
| INPROGRESS | En attente de retour de l'acheteur | L’acheteur est en cours de saisie (état temporaire) |
Les fonctions
Actuellement les codes retour sont utilisés dans :
- Webservices de l'API Payline
- Fichiers des transactions : Export CSV
- L'ensemble des rapports spécifiques des commerçants
Liste des codes retour
- Return codes - Payline Back (01)
- Return codes - Payline Front (02)
- Return codes - 3DSecure (03)
- Return codes - LCLF (04)
- Return codes - Payment methods (XX)
- Return Codes - Simulator