DocsTableau de bord

Connexions

Choisir les moyens de paiement

PUT/v1/connections/{id}/payment-methodsconnections:write

Requires connections:write. The methods the merchant switches off for this connection (Link by default). New payments exclude them at Stripe; Stripe cannot exclude Apple Pay, Google Pay and Link from a payment, so the checkout hides them (and hides both wallets when cards are off). Unknown names, or every method off, are refused (400 invalid_methods). Journaled as connection.methods_changed when the choice changes.

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

Corps

excluded_methodsliste de "card" | "apple_pay" | "google_pay" | "link" | "sepa_debit" | "ideal" | "bancontact" | "klarna"obligatoire

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.