Détail du paiement marchand

Résumé

Cette page résume la version anglaise ; certaines étapes n’y figurent pas. Version complète : la page en anglais.

Consultez GET /v1/payments/{id}/detail et /detail/events avec une clé serveur disposant de payments:read. Pour une équipe, utilisez /portal/merchants/{merchant}/payments/{id}/detail et /detail/events, une identité marchand authentifiée par mot de passe et code OTP, ainsi que la version courante X-Futa-Membership-Version. Chaque requête contrôle l’accès actuel et le quota du marchand. Gardez les identifiants côté serveur.

Ces routes du profil sandbox fournissent uniquement des preuves synthétiques. Les montants sont des chaînes décimales en unités mineures ; utilisez BigInt pour les calculs. Les frais marchands synthétiques sont nuls. Le montant encaissé repose sur le crédit comptable du paiement ; les remboursements terminés et réservés restent distincts. net_after_refunds déduit les remboursements terminés ; ce montant n’est pas un solde disponible pour le règlement. batch_id reste nul car les lots agrégés ne permettent pas d’attribuer un règlement à chaque paiement. Un identifiant NOT_RETAINED n’a pas été conservé et ne doit pas être reconstitué.

Le journal contient au plus 25 événements par page, dans l’ordre des séquences. Transmettez next_cursor à /detail/events?cursor={uuid} jusqu’à sa valeur nulle. Un curseur ne peut être utilisé que pour son paiement. Une page vide après le dernier événement est valide. Le détail et le journal représentent des instantanés distincts ; leur séquence peut donc différer. Ces lectures ne déclenchent aucun paiement et ne modifient pas le reçu de création.

Aucun corps, encodage, paramètre supplémentaire ou en-tête d’autorité fourni par l’appelant n’est accepté, hormis la version d’équipe. Les réponses et erreurs sont privées (no-store). Codes : 403 pour un accès insuffisant, 404 pour un paiement ou curseur absent ou étranger, 409 pour une version d’équipe périmée, 429 pour le quota, 503 pour une preuve indisponible ou une réponse amont invalide. Une indisponibilité ne signifie pas que le paiement a échoué. Rien ne relance la requête à votre place. L’interface du portail, les opérateurs réels, les frais commerciaux et l’attribution des règlements restent des étapes distinctes.