Configurations multiples pour vos comptes Connect
Utilisez cette fonctionnalité si votre plateforme utilise des moyens de paiement dynamiques et prend en charge la configuration de différents types de moyens de paiement pour différents types de transactions (par exemple, abonnements ou paiements ponctuels) ou pour différents montants de facture (par exemple, les factures supérieures à un certain montant peuvent être réglées avec un moyen de paiement différé).
Créer une nouvelle configuration de moyen de paiement sur votre Dashboard
Accédez aux paramètres des moyens de paiement de vos comptes connectés sur le Dashboard Stripe. C’est ici que vous contrôlez les configurations « parentes » au niveau de votre plateforme. Vos comptes connectés reçoivent pour chaque parent une configuration « enfant » personnalisable dans le cadre des contraintes que vous avez définies ci-dessous.
Au départ, vous disposez d’une configuration parente par défaut. Pour créer une configuration supplémentaire, cliquez sur Ajouter une nouvelle configuration, puis donnez-lui un nom.
Définir l'état par défaut au niveau de la plateforme
Vous pouvez appliquer le paramètre par défaut de chaque moyen de paiement à votre nouvelle configuration parente et contrôler les personnalisations que vos comptes connectés peuvent apporter. Utilisez la liste déroulante pour sélectionner le paramètre souhaité :
- Activé par défaut active le moyen de paiement par défaut. Les comptes connectés peuvent l’activer et le désactiver à leur guise.
- Désactivé par défaut désactive le moyen de paiement par défaut. Les comptes connectés peuvent l’activer et le désactiver à leur guise.
- Bloqué désactive le moyen de paiement pour tous les comptes connectés. Les comptes connectés ne pourront pas l’activer.
Autoriser la personnalisation de vos comptes connectés
Les comptes connectés Standard peuvent accéder au Dashboard pour activer ou désactiver les moyens de paiement définis sur On by default
ou Off by default
. Vos comptes connectés ont accès à la nouvelle configuration enfant créée dans leurs paramètres des moyens de paiement. Vos comptes connectés peuvent utiliser le menu déroulant en haut de la page pour choisir une configuration à modifier.
Si vous souhaitez que vos comptes connectés puissent personnaliser les paramètres de leurs moyens de paiement à partir du Dashboard de votre plateforme plutôt que du Dashboard Stripe, ou si certains de vos comptes connectés n’ont pas accès au Dashboard Stripe, vous pouvez intégrer l’API Payment Method Configurations.
Utilisez l’API Payment Method Configurations avec l’ID d’un compte connecté et l’ID de la configuration enfant pour consulter l’état actuel d’un moyen de paiement pour un compte connecté donné sur cette configuration.
{ "object": "list", "data": [ { "id":
, "object": "payment_method_configuration", "name": "My Custom Configuration", "active": true, "is_default": true, "livemode": false, "parent":"{{PAYMENT_METHOD_CONFIGURATION_ID}}", "acss_debit": { "available": false, "display_preference": { "overridable": true, "preference": "off", "value": "off" } }, "affirm": { "available": false, "display_preference": { "overridable": true, "preference": "off", "value": "off" } }, "afterpay_clearpay": { "available": false, "display_preference": { "overridable": true, "preference": "off", "value": "off" } }, ... additional payment methods } ], "has_more": false, "url": "/v1/payment_method_configurations" }"{{PAYMENT_METHOD_CONFIGURATION_ID}}"
Si l’opération réussit, la liste renvoyée affiche chaque moyen de paiement avec deux paramètres précisant la disponibilité et les préférences d’affichage.
available
est la combinaison des valeurs de fonctionnalité (active
,inactive
,pending
ouunrequested
) et dedisplay_preference
.Vous pouvez utiliser le champ
available
pour déterminer si un client voit s’afficher un moyen de paiement donné au moment du paiement. Siavailable
est défini surtrue
, la fonctionnalité de ce moyen de paiement est active etdisplay_preference
est activé. Siavailable
est défini surfalse
, soit la fonctionnalité n’est pas active, soit la valeurdisplay_preference
est désactivée, et les clients ne la verront pas au moment du paiement. Pour simplifier votre intégration et tirer parti d’autres fonctionnalités, utilisez les moyens de paiement gérés depuis le Dashboard. Le paramètre sera alors lu automatiquement, et les bons moyens de paiements seront proposés au client lors du paiement.display_preference
comporte trois éléments :overridable
,preference
etvalue
.overridable
indique si la préférence du compte connecté doit remplacer celle par défaut ci-dessus. Ce paramètre n’est pas modifiable.preference
, disponible en écriture, contient la préférence du compte connecté.value
affiche la valeur effective dedisplay_preference
. Ce paramètre n’est pas modifiable.
Note
Seuls les moyens de paiement pertinents au regard du pays du compte connecté s’affichent dans la réponse de l’API et peuvent être configurés. Consulter les pays pris en charge.
Lorsqu’un compte connecté active ou désactive un moyen de paiement, vous pouvez mettre à jour l’attribut preference
de display_preference
. Celui-ci enregistre la préférence du propriétaire du compte connecté pour ce moyen de paiement et sert à déterminer si les acheteurs voient ce moyen de paiement.
{ "id":
, "object": "payment_method_configuration", "name": "My Custom Configuration", "active": true, "is_default": true, "livemode": false, "acss_debit": { "available": false, "display_preference": { "overridable": true, "preference": "off", "value": "off" } }, "affirm": { "available": true, "display_preference": { "overridable": true, "preference": "on", "value": "on" } }, "afterpay_clearpay": { "available": false, "display_preference": { "overridable": true, "preference": "off", "value": "off" } }, ... additional payment methods }"{{PAYMENT_METHOD_CONFIGURATION_ID}}"
Lorsque vos comptes connectés activent des moyens de paiement via l’API, Stripe classe de manière intelligente les moyens de paiement en fonction de l’emplacement de l’acheteur, de la taille de la commande et d’autres facteurs, afin de toujours afficher en premier les moyens de paiement offrant les meilleurs taux de conversion.
Afficher les moyens de paiement disponibles au moment du paiement
Lors du rendu de votre tunnel de paiement, transmettez l’ID de la configuration parente pour utiliser votre nouvelle configuration. Stripe recherche automatiquement la configuration enfant du compte connecté associé et utilise ses paramètres personnalisés.
Si vous créez un PaymentIntent avant d’afficher le Payment Element que vous utilisez, vous pouvez transmettre l’ID parent à votre PaymentIntent.
Si vous utilisez le Payment Element avec le chemin d’intégration avec création différée des Intents, vous pouvez transmettre l’ID parent aux options de session de vos Elements.
const options = { mode: 'payment', amount: 1099, currency: 'usd', payment_method_configuration:
}'{{PAYMENT_METHOD_CONFIGURATION_ID}}'
Si vous créez une session Checkout, vous pouvez transmettre l’ID parent à vos options de session Checkout.
(Facultatif) : Apple Pay, Google Pay et Link
Certains moyens de paiement tels qu’Apple Pay, Google Pay ou Link ne sont pas considérés comme étant des types de moyens de paiement distincts sur un PaymentIntent et ne peuvent être confirmés qu’au moyen d’une carte. Avec l’API Payment Method Configurations, vous pouvez laisser le choix aux propriétaires de comptes connectés d’utiliser ou non ces moyens de paiements spécifiques, et empêcher qu’ils n’apparaissent dans l’interface utilisateur.