Virements internes
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/transfers |
Lister les virements internes |
POST |
/v1/transfers |
Virement interne |
GET |
/v1/transfers/{id} |
Consulter un virement interne |
GET /v1/transfers
Lister les virements internes
Même pagination que les encaissements.
Paramètres
| Nom | Emplacement | Requis | Description |
|---|---|---|---|
page |
query | non | Page, à partir de 1. |
per_page |
query | non | Taille de page, 100 au maximum. |
Réponses
200— OK401— Clé API manquante ou rejetée403— La clé ne porte pas le scope requis, ou le compte n'est pas actif429— Budget de requêtes de la clé épuisé (300/min) — honorer Retry-After
POST /v1/transfers
Virement interne
Déplace des fonds vers un autre compte de la plateforme, sans rail externe : aucun frais de rail, aucun appel sortant, une écriture au grand livre. Scope can_payout et l'option internal_transfers activée sur le compte.
Paramètres
| Nom | Emplacement | Requis | Description |
|---|---|---|---|
Idempotency-Key |
header | non | Clé d'idempotence propre à CETTE opération. Rejouer la même clé avec la même charge utile retourne l'originale ; la rejouer avec une charge utile différente est refusé (409). |
Réponses
201— Virement créé401— Clé API manquante ou rejetée403— La clé ne porte pas le scope requis, ou le compte n'est pas actif409— Clé d'idempotence rejouée avec une charge utile différente422— Requête recevable mais refusée : champ manquant, corridor fermé, solde insuffisant429— Budget de requêtes de la clé épuisé (300/min) — honorer Retry-After
GET /v1/transfers/{id}
Consulter un virement interne
La même vue masquée que GET /v1/payments/{id}.
Paramètres
| Nom | Emplacement | Requis | Description |
|---|---|---|---|
id |
path | oui | Identifiant interne, référence de l'opération, ou votre propre client_ref. |
Réponses
200— OK401— Clé API manquante ou rejetée403— La clé ne porte pas le scope requis, ou le compte n'est pas actif429— Budget de requêtes de la clé épuisé (300/min) — honorer Retry-After