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. Keys are filed in the environment of their mode (D25): Stripe's say theirs, PayPal's are read by its sandbox, then by PayPal itself; real keys need the space's production open with its terms (409 production_not_open); new keys for a connection keep its mode (409 keys_environment_mismatch); PayPal (D22): the REST app's client ID and secret; PayHaze adds its notification address on the app itself (10 events) and keeps the webhook ID the signatures name; PayPal is then offered beside the card in the checkout, outside the rotation. Adyen and Checkout.com connect in test only. Sandbox mode only.
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
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.