Routage

Choisir le mode

PUT/v1/routing/policyconnections:write

Needs connections:write and a fresh second factor. custom needs an active version. when_full=fallback needs an active fallback account of the space.

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

mode"automatic" | "custom"obligatoire
when_full"refuse" | "fallback"obligatoire
fallback_connection_idstringobligatoire

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.

Requête

curl -X PUT "$PAYMENT_OS_API/v1/routing/policy" \
  -H "Authorization: Bearer $PAYMENT_OS_KEY" \
  -H "X-Merchant-ID: $MERCHANT_ID" \
  -d '{ "mode": "automatic", "when_full": "refuse", "fallback_connection_id": "…" }'