DocsTableau de bord

Routage

Créer une version

POST/v1/routing/versionsconnections:write

Needs connections:write. Typed rules only (no code): conditions on amount, currency, capture mode or « no account healthy »; actions refuse with a reason, a named account, the lowest estimated cost, the first admissible account, or any capable account with an alert. Accounts must belong to the space. 400 invalid_rules names the rule. The space keeps three versions, the active one and the newest: a draft that leaves them, never observed, is deleted; active, replaced and observed versions stay.

En-têtes

AuthorizationBearer pos_key_…obligatoire
Clé de serveur, pour tout l’espace. Jamais dans un navigateur.
X-Merchant-IDstringobligatoire
L’espace marchand concerné (mrc_…).

Corps

rulesliste de objectobligatoire

Réponses

200Réussi
400Requête invalide
401Clé absente ou invalide
403Autorisation ou espace refusé
404Ressource introuvable
409Conflit avec une demande existante
429Trop de demandes, réessayez plus tard
503Service momentanément indisponible

Une erreur ne vaut jamais paiement. Le corps donne code, message, request_id et retry_action ; renvoyez la même Idempotency-Key si retry_action le propose.