Connexions
Connecter avec vos clés
POST/v1/provider-connections/{provider}connections:write
Requires connections:write and a recent second factor. PayHaze checks the keys with the provider before anything is stored, then seals them (never returned, never logged). Stripe: the account is read with the merchant's own secret key; the notification secret may be sent later by calling again with all three values, and the notification address is /v1/provider-webhooks/stripe/{connection id}. Calling again for the same account replaces its keys and reactivates it. Sandbox mode only.
En-têtes
AuthorizationBearer pos_test_…obligatoire- Clé de serveur. Jamais dans un navigateur.
X-Merchant-IDstringobligatoire- L’espace marchand concerné (mrc_…).
X-Environment"test"obligatoire- Seule valeur acceptée tant que la production n’est pas ouverte.
Paramètres
providerdans le cheminobligatoire
Réponses
- 201Créé
- 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.