Soumettre un lot de paiement
POST/api/v1/payment_batches/:id/submit
Remet un lot hosted_consent approved à son canal et répond 202 avec le lot. Un 202 ne signifie jamais que l'argent a circulé : interrogez GET /payment_batches/{id} et ses instructions. submission_status dit ce qu'il est advenu de la remise - awaiting_consent tant que le consentement du payeur est ouvert, unknown lorsque la réponse du canal a été perdue, refused avec le lot failed - et aucun de ces états n'est une annulation. L'URL de consentement n'est jamais retournée ici : POST /payment_batches/{id}/consent_session la publie. expected_version est obligatoire. Un lot sepa_file se remet plutôt par POST /payment_batches/{id}/sepa_export. Soumettre un lot déjà accepté par son canal ne change rien et répond de nouveau 202.
Request
Responses
- 202
- 403
- 404
- 409
- 422
Le lot, remis. Lisez submission_status : un 202 ne signifie jamais que l'argent a circulé.
Le jeton ne détient pas la portée write.
Aucun lot de paiement portant cet identifiant n'est atteignable par les habilitations du jeton.
stale_version : le lot a changé depuis l'expected_version que vous avez envoyée. RIEN N'A ÉTÉ ENVOYÉ ; details porte la version et le lot courants. idempotency_key_reuse, idempotency_request_in_progress et idempotency_key_consumed répondent aussi 409, sans details.
batch_not_submittable : le lot n'est pas approved, porte déjà une tentative de remise, est encore en cours de soumission par une autre requête, ou est un lot sepa_file. validation_failed : l'en-tête Idempotency-Key ou expected_version est absent, expected_version n'est pas un entier, la facture d'une instruction ne peut plus être réservée, ou Scribee a refusé le lot avant tout envoi - un lot incomplet que le canal ne construirait pas, ou une erreur locale de configuration ou de requête sur le canal de paiement. Ce dernier refus laisse le lot failed avec submission_refused_by: "local" ; details.instructions porte un message qui le dit, ainsi que les violations d'un lot incomplet. Rien n'a été envoyé, et aucun résultat bancaire n'est enregistré.