Routage
Créer une expérience
POST/v1/experimentsconnections:write
Autorisation connections:write. Prépare un essai : une part des paiements (1 à 50 %) part sur un autre compte, avec un garde-fou qui l’arrête si ce compte accepte moins bien.
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
namestring, 0 à 80obligatoireconnection_idstringobligatoire- Le compte concerné, obligatoire : son identifiant (con_…) se lit dans GET /v1/connections.
share_percentnumberobligatoireguard_pointsnumberobligatoiremin_sampleintegerobligatoireduration_daysintegerobligatoiremin_amount_minorintegermax_amount_minorintegercapture_mode"automatic" | "manual"- manual : réserver puis capturer plus tard, si le compte le permet.
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.