MPC - Captures partielles multiples
Configurez et utilisez plusieurs captures partielles natives du processeur ou gérées par DEUNA, y compris les règles de limite et le comportement de capture final.
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#
| Mode | Lors de la communication avec le processeur | Seuil géré par DEUNA | final_capture Comportement |
|---|---|---|---|
| En ligne | Chaque demande de paiement est immédiatement envoyée au processeur. | Non | Ignoré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 ligne | Les demandes non finales sont mises en mémoire tampon. DEUNA envoie un montant total capturé une fois la séquence terminée. | Oui | Termine 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#
- Le paiement est
authorized. - Chaque demande non finale est validée par rapport au montant autorisé restant et est stockée sans appeler le processeur.
- Pendant que plusieurs montants sont mis en mémoire tampon, le paiement est
partial_capturing. - 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.
- DEUNA envoie le montant total capturé au processeur en tant qu'une seule opération de paiement.
- Si le montant total confirmé est égal au montant autorisé, le paiement devient
captured. Si le montant total confirmé est inférieur, il devientpartial_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 :
{
"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_captureCe 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#
| Statut | Signification dans un flux MPC | Action du commerçant |
|---|---|---|
authorized | Les 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_capturing | Un 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é. |
capturing | Le montant total accumulé est capturé. | Attendez le résultat définitif. |
partial_captured | Un 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. |
captured | Le 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ètre | En ligne | Hors ligne |
|---|---|---|
| État de la fonctionnalité | Obligatoire | Obligatoire |
| Mode de fonctionnement | online | offline |
| Seuil de capture | Non utilisé par DEUNA | Obligatoire ; 1–45 jours calendaires |
| Capacité du processeur | Capture partielle et multiple native | Support 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.