Aller au contenu principal
Sur cette page

Les captures partielles multiples (MPC) vous permettent d'autoriser un montant une seule fois et de le capturer dans plusieurs requêtes. Utilisez-le lorsque la finalisation se produit par étapes, par exemple lors de la confirmation de billets, de l'expédition de produits ou de la réalisation d'étapes de service.

Le MPC est configuré par connexion au processeur. La connexion doit prendre en charge l'autorisation et la capture, et DEUNA doit activer le mode de fonctionnement approprié pour cette connexion.

Pour utiliser le MPC, intégrez-vous avec Créer des paiements V2 et créez le paiement en utilisant l'autorisation plutôt que la capture automatique.

Choisissez un mode de fonctionnement#

ModeLors de la communication avec le processeurSeuil géré par DEUNAfinal_capture Comportement
En ligneChaque demande de paiement est immédiatement envoyée au processeur.NonIgnorée par le flux MPC en ligne. La séquence se termine lorsque le montant total capturé atteint le montant autorisé ou selon les règles du processeur.
Hors ligneLes demandes non finales sont mises en mémoire tampon. DEUNA envoie un montant total capturé une fois la séquence terminée.OuiTermine la séquence et envoie le montant total capturé.

Le mode en ligne est approprié uniquement lorsque la connexion au processeur prend en charge nativement plusieurs captures. Le mode hors ligne est le mode de compatibilité géré par DEUNA et peut également être sélectionné pour un processeur avec MPC natif lorsque les besoins de l'entreprise nécessitent le regroupement.

Cycle de vie du MPC hors ligne#

  1. Le paiement est authorized.
  2. Chaque demande non finale est validée par rapport au montant autorisé restant et est stockée sans appeler le processeur.
  3. Pendant que plusieurs montants sont mis en mémoire tampon, le paiement est partial_capturing.
  4. DEUNA termine la séquence lorsque l'une des conditions suivantes se produit :
    • Le montant total demandé atteint le montant autorisé.
    • Une demande inclut "final_capture": true.
    • Le seuil de capture enregistré est atteint.
  5. DEUNA envoie le montant total capturé au processeur en tant qu'une seule opération de paiement.
  6. Si le montant total confirmé est égal au montant autorisé, le paiement devient captured. Si le montant total confirmé est inférieur, il devient partial_captured.

La fermeture d'une séquence en dessous du montant autorisé marque la séquence de capture DEUNA comme finale. Les demandes de capture ultérieures sont rejetées. Veuillez vous renseigner auprès de votre responsable technique DEUNA (TAM) sur la manière dont le reste de l'autorisation est libéré par le processeur sélectionné.

Fermer la séquence via l'API

Envoyer final_capture sous forme de booléen JSON, et non de chaîne :

JSON
{
  "amount": 100,
  "final_capture": true
}

Le amount est le montant de cette demande de remboursement. En mode hors ligne, DEUNA l'ajoute aux montants de remboursement précédemment mis en mémoire avant d'envoyer la demande consolidée au processeur.

Limites de coupe et de temps pour les remboursements#

La limite de coupe et de temps pour les remboursements hors ligne a les règles suivantes :

  • Configurez un nombre entier de 1 à 45 jours calendaires.
  • DEUNA enregistre la date limite absolue dans capture_cutoff_at . Pour le paiement, utilisez cet horodatage, lorsqu’il est renvoyé, comme source de vérité au lieu de calculer l’échéance localement.
  • Dans les flux d'autorisation qui définissent le moment de fin de l'autorisation, la mesure commence au début de l'autorisation. Si aucun moment de fin n'a encore été défini, le flux de capture le définit lors de la première tentative de capture non finale.
  • La date limite correspond à la fin de la journée calendrier cible, et non à un nombre précis d'heures après la demande.
  • Les captures partielles ultérieures ne prolongent ni ne réinitialisent la date limite enregistrée.
  • La modification de la configuration de connexion ne remet pas à zéro une date d'échéance déjà enregistrée pour un paiement existant.
  • Lorsque le seuil prédéfini est atteint, le paiement devient éligible pour que le processus de clôture du flux soit exécuté par le travailleur associé. Le traitement n'est pas garanti à la dernière seconde de la journée, il ne faut donc pas compter sur une période de grâce pour un autre marchand.

Le traitement MPC en ligne n'a pas de limite de capture imposée par DEUNA. Les périodes de validité et les limites de capture du processeur restent en vigueur.

Règles concernant le montant et la séquence#

  • Le montant total de la capture ne peut pas dépasser le montant autorisé, après toute annulation qui affecte le solde disponible.
  • L'atteinte du montant total autorisé permet de finaliser automatiquement la demande. final_capture Ce champ n'est pas requis dans ce cas.
  • Une capture hors ligne finale inférieure au montant autorisé nécessite la connexion au processeur pour prendre en charge la capture partielle.
  • Après une dernière opération de capture, DEUNA ne prendra pas une autre capture pour cette séquence.
  • DEUNA ne limite pas le nombre de requêtes pour les captures hors ligne. Les règles concernant le montant, le seuil, la connexion et le processeur sont les limites effectives.

Calculez toujours les remboursements à partir des montants confirmés. Une capture hors ligne ne représente pas l'argent collecté auprès du processeur.

Gestion des statuts et des erreurs#

StatutSignification dans un flux MPCAction du commerçant
authorizedLes fonds sont réservés et aucune capture partielle n'est actuellement en attente.Soumettez les captures éligibles avant que l'autorisation n'expire.
partial_capturingUn ou plusieurs montants de capture sont en attente ou en mémoire tampon.Gardez les montants en attente et confirmés séparés ; ne considérez pas le montant en mémoire tampon comme étant collecté.
capturingLe montant total accumulé est capturé.Attendez le résultat définitif.
partial_capturedUn montant inférieur à l'autorisation a été confirmé par le processeur.Enregistrez le montant confirmé. Ne créez pas une nouvelle capture si la séquence est terminée.
capturedLe montant total autorisé a été capturé.Enregistrez la fin de la capture.

Un délai d'attente ou une requête asynchrone acceptée ne prouvent pas que la capture a réussi ou échoué. Récupérez le paiement et traitez les webhooks DEUNA jusqu'à ce qu'un statut confirmé soit disponible. Une capture en ligne échouée conserve l'état de paiement précédemment confirmé, tandis que l'opération échouée reste visible dans l'historique de la transaction.

Pour le tableau de transition complet, voir Flux de travail et statuts de paiement. Pour les requêtes concurrentes, voir Capture et remboursement simultanés.

Configurer MPC#

Travaillez avec votre représentant technique DEUNA pour configurer la connexion :

ParamètreEn ligneHors ligne
État de la fonctionnalitéObligatoireObligatoire
Mode de fonctionnementonlineoffline
Seuil de captureNon utilisé par DEUNAObligatoire ; 1–45 jours calendaires
Capacité du processeurCapture partielle et multiple nativeSupport de capture ; la capture partielle est également requise lorsque le montant total final peut être inférieur à l'autorisation

Dans l'interface d'administration, utilisez les détails de la commande pour surveiller les demandes de capture, le montant accumulé, le montant autorisé restant et la limite de coupure enregistrée, si disponible. L'activation, les identifiants et les limites du processeur peuvent varier selon le pays et la connexion.