Code wiki

Pour bénéficier des dernières fonctionnalités offertes par Paypal, une évolution interne à Payline a été mise en oeuvre. Elle est disponible en homologation et progressivement appliquée à nos clients effectuant des paiements via Paypal en production.

Cette évolution n'implique aucune modification de vos appels à l'API Payline afin d'effectuer un paiement Paypal, mais se traduit par deux nouveautés en retour :

Les transactions effectuées avec le moyen de paiement Paypal sont systématiquement préfixées par PPL, par exemple PPL1709071551258462. L'identifiant interne à Paypal est disponible via le champ G_PAYPAL_TRANSACTION_PAYPAL_ID du fichier des transactions Payline (reporting par fichier).
De nouveaux codes retour sont introduits (voir tableau ci-dessous).

code	shortMessage	longMessage	Commentaire
02013	ERROR	Transaction refused	Écart possible entre Payline et Paypal. Payline effectue les opérations nécessaires à la régularisation de la situation (opération automatique ou manuelle suivant le partenaire)
02015	ERROR	Transaction delegated to partner	La transaction est gérée par Paypal. Payline n’aura pas d’info quant à son traitement.
02016	ONHOLD_PARTNER	Transaction pending by the partner	La transaction est en analyse chez Paypal. Payline informera le commerçant lors de l’évolution de celle-ci.
02017	PENDING_RISK	Transaction pending	Une action commerçant est attendue chez Paypal afin de débloquer la transaction

En complément de ces nouveaux codes retours, de nouveaux sous-états (correspondants au shortMessage renvoyé par l'API) sont introduits.
Une transaction associée aux codes retour 02013, 02015 et 02017 se verront attribuer ces sous-états en fonction des échanges Payline/Paypal.

Sous-état	Signification
TO_BE_REVERSED	La transaction doit être annulée/redressée en automatique
REVERSED	La transaction a été annulée/redressée
TO_BE_REVERSED_IN_FALLBACK_MODE	La transaction doit être annulée/redressée en mode manuel
EXTERNAL_HANDLING	La demande d’annulation/redressement a été effectuée, le résultat ne sera pas connu de Payline

L'historique des sous-états attribués à une transaction sont consultables dans l'écran de détail du centre d'administration, ou via l'API (objet statusHistoryList renvoyé par getTransactionDetails)