Aller au contenu principal
Sur cette page

Les méthodes de paiement alternatives (APM) peuvent nécessiter un redirigement, un changement d'application, un code QR, un code promo, une approbation bancaire ou une confirmation ultérieure du prestataire. Consultez la valeur actuelle de payment.data.status; si le paiement se trouve dans une réponse de commande, consultez order.payment.data.status.

Utilisez cette page pour le chemin spécifique à l'APM. Pour chaque définition d'état et chaque transition directe autorisée, consultez Workflow et statuts de paiement.

Flux APM standard#

La plupart des APM commencent par pending. Certains confirment immédiatement ; d'autres restent en attente pendant que le client agit, puis affichent processing alors que DEUNA attend la confirmation du prestataire.

Diagramme de flux
Customer completesactionImmediate confirmationConfirmedDeclinedDeclinedCancelledCancelledPayment window closes1pendingAwait customer orprovider2processingProvider confirmation3processedPayment confirmed4deniedAttempt unsuccessful5cancelledFinancial resolutionrequired6expiredCompletion windowclosed
Révision ou attenteRésultatException ou arrêt
ÉtatSignificationAction du commerçant
pendingL'action du client, le routage ou la confirmation du prestataire sont toujours en cours.Présentez next_action ou les instructions de la méthode et bloquez l'exécution.
processingLa méthode attend un résultat du prestataire en arrière-plan.Attendez ou récupérez le paiement définitif ; ne réessayez pas trop tôt.
processedLe paiement APM est terminé.Appliquez la politique d'exécution et conservez les références du prestataire.
deniedCette tentative a échoué.Ne pas exécuter ; conservez la raison et évaluez si une nouvelle tentative est autorisée.
cancelledLe mode de paiement ou le marchand a annulé le paiement.Vérifiez si des fonds antérieurs doivent être remboursés ou annulés avant de fermer la commande.
expiredLa fenêtre de complétion autorisée est expirée.Enregistrez la complétion de la transaction et créez un nouveau paiement pour une nouvelle tentative du client.

URL de retour du client#

Suivez le chemin spécifique à la méthode next_action fourni par DEUNA. Un retour via navigateur, une application ou une page de succès visible par le client ne prouve pas que le paiement a été effectué. Vérifiez payment.data.status après que DEUNA ait reçu et traité le résultat du prestataire.

Si le client abandonne le redirigement ou ferme le navigateur, maintenez le paiement comme non réglé jusqu'à ce que DEUNA signale un résultat. Ne tirez pas de conclusions denied, cancelled, ou expired à partir du comportement de l'interface utilisateur.

Périodes de complétion#

Le temps autorisé pour la complétion d'un paiement est spécifique à la méthode et à la configuration. La date d'expiration des coupons, la validité des QR codes, les délais de session bancaire et les fenêtres de traitement des prestataires ne sont pas interchangeables.

Ne calculez pas le statut final du paiement à partir du temps du navigateur ou d'un minuteur local. Maintenez le paiement bloqué et attendez que DEUNA signale le résultat. processed, denied, cancelled, ou expiredSi votre expérience utilisateur affiche un compte à rebours, traitez-le comme une indication de présentation, sauf si le contrat de la méthode le rend explicitement obligatoire.

APMs compatibles avec l'autorisation#

Certaines connexions APM prennent en charge l'autorisation et la capture. Ces méthodes peuvent exposer authorizing, authorized, capturing, captured, ou des états de capture partielle au lieu du chemin standard d'achat uniquement.

Lorsqu'un APM utilise l'autorisation, suivez les Instructions pour la capture et l'annulation de transactions par carte. Pour les états de paiement partagés, veuillez confirmer la prise en charge de la méthode et du processeur avec votre responsable technique DEUNA (TAM). Ne déduisez pas la prise en charge des opérations de capture ou d'annulation à partir de la présence d'un état dans l'état machine global.

Annulation et remboursements#

cancelled ne représente pas nécessairement l'état financier final. Si des fonds ont été collectés, le paiement peut continuer. refunded; si une autorisation était présente, il peut continuer voided.

Après une processed Les paiements et les remboursements peuvent être traités par partial_refunding, partial_refunded, refundinget refunded lorsque cela est pris en charge par la connexion APM. Voir RPM — Remboursements partiels multiples Pour les modes pris en charge, les limites de temps, la gestion de la concurrence et le comportement du solde restant.

Liste de contrôle d'intégration#

  1. Le traitement des commandes est mis en pause pendant le paiement. pending ou processing.
  2. Suivez l'action suivante sans considérer le retour du client comme une confirmation de paiement.
  3. Conservez les références du fournisseur et les montants confirmés avec chaque mise à jour.
  4. Gérez les notifications tardives et répétées du fournisseur de manière idempotente.
  5. Récupérez le paiement autoritaire après un délai du client ou en l'absence de retour.
  6. Utilisez la référence de transition validée Pour les chemins de retours, de remboursement et de réconciliation qui ne sont pas présentés dans le flux normal.