Répartitions

Page générée depuis la spécification OpenAPI que la passerelle sert (GET /v1/openapi.json). Ne la modifiez pas à la main : elle est réécrite à chaque build.

Méthode	Chemin	Description
GET	/v1/payments/{id}/splits	Les parts d'un encaissement
POST	/v1/payments/{id}/splits	Répartir un encaissement

GET /v1/payments/{id}/splits

Les parts d'un encaissement

Les parts déjà attribuées, avec leur état de règlement.

Paramètres

Nom	Emplacement	Requis	Description
id	path	oui

Réponses

• 200 — OK
• 401 — Clé API manquante ou rejetée
• 403 — La clé ne porte pas le scope requis, ou le compte n'est pas actif
• 404 — Aucun encaissement de cet identifiant
• 429 — Budget de requêtes de la clé épuisé (300/min) — honorer Retry-After

POST /v1/payments/{id}/splits

Répartir un encaissement

Attribue des parts d'un encaissement réussi à d'autres comptes de la plateforme — le geste d'une marketplace qui reverse à ses vendeurs.

⚠️ LA RÉPARTITION EST INSCRITE DANS LA MÊME TRANSACTION QUE L'ENCAISSEMENT, ce qui rend impossible de répartir plus qu'il n'a été collecté : le parent est revalidé sous verrou et l'ensemble est refusé plutôt qu'une partie. Une marketplace qui répartirait en deux temps aurait à gérer « encaissé mais pas encore réparti » ; cet état n'existe pas ici.

fee_minor est PRÉLEVÉ SUR amount_minor, pas ajouté par-dessus : le bénéficiaire reçoit amount − fee.

Paramètres

Nom	Emplacement	Requis	Description
id	path	oui	L'encaissement à répartir : identifiant, référence, ou votre client_ref.
Idempotency-Key	header	non	Clé d'idempotence propre à CETTE opération.

Réponses

• 201 — Parts créées
• 401 — Clé API manquante ou rejetée
• 403 — La clé ne porte pas le scope requis, ou le compte n'est pas actif
• 404 — Aucun encaissement de cet identifiant pour ce compte
• 422 — Bénéficiaire inconnu ou inactif, bénéficiaire égal à vous-même, opération non encaissée, ou total supérieur au parent
• 429 — Budget de requêtes de la clé épuisé (300/min) — honorer Retry-After