Connexions
Changer les clés
POST/v1/connections/{id}/keysconnections:write
Requires connections:write and the second factor when the account has one. The new keys are checked with the provider and must read the connection’s own account (409 other_account otherwise) and be of its environment's mode (409 keys_environment_mismatch otherwise); they replace the sealed keys in one step, payments in flight continue. A deactivated connection stays deactivated. Stripe: the notification address is registered again with the new keys.
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_…).
Paramètres
iddans le cheminobligatoire
Réponses
- 200Réussi
- 400Requête invalide
- 401Clé absente ou invalide
- 403Autorisation ou espace refusé
- 404Ressource introuvable
- 409Conflit avec une demande existante
- 422Impossible à traiter
- 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.