Partager les moyens de paiement entre plusieurs comptes pour les paiements directs

Pour créer des paiements directs sur plusieurs comptes connectés en utilisant les mêmes informations de paiement enregistrées, privilégiez cette approche. Sinon, utilisez notre guide pour la création de paiements directs.

Sauvegarder les détails du paiement sur votre plateforme

Lorsque vous recueillez les détails du paiement auprès de votre client, configurez-les pour une utilisation ultérieure et enregistrez-les sur votre compte de plateforme. Il vous suffit de configurer chaque moyen de paiement une seule fois.

Créer un client sur votre plateforme

Sur votre compte de plateforme, utilisez l’API Customers pour créer un objet Customer représentant votre client.

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d name="Jenny Rosen"

Créer un SetupIntent sur votre plateforme

Lorsque vous collectez les détails du moyen de paiement du client, utilisez l’API Setup Intents pour créer un Setupintent sur votre plateforme et l’associer au client.

curl https://api.stripe.com/v1/setup_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}}

Si votre plateforme se trouve dans un pays différent de celui de vos comptes connectés, la configuration effectuée sur votre plateforme peut ne pas être suffisante. Par exemple, si votre plateforme se trouve aux États-Unis, le processus de configuration peut ne pas déclencher l’authentification requise pour les paiements directs dans les pays soumis à l’application de la SCA. Pour vous assurer que votre configuration répond aux exigences du pays du compte connecté, il vous faudra peut-être utiliser on_behalf_of pour préciser un compte connecté dans ce pays.

Confirmer le SetupIntent

Envoyez le client_secret du SetupIntent à votre front end et utilisez nos SDK côté client ou nos composants d’interface utilisateur pour collecter les informations relatives au paiement et confirmer le SetupIntent. Par exemple, vous pouvez utiliser le Payment Element pour collecter les informations de paiement et confirmer le SetupIntent.

La confirmation sur le client permet au client de passer en revue tous les flux nécessaires à la configuration de ses informations de paiement pour une utilisation ultérieure, comme l’authentification avec 3D Secure.

Une confirmation réussie crée un PaymentMethod et l’attache au client pour une utilisation ultérieure.

Dupliquer le PaymentMethod et créer des paiements directs sur les comptes connectés

Une fois que vous avez configuré un PaymentMethod pour une utilisation future sur votre plateforme, dupliquez-le sur un compte connecté pour créer un paiement direct.

Dupliquer le PaymentMethod sur les comptes connectés

Utilisez l’API Payment Methods pour dupliquer le PaymentMethod enregistré sur votre compte de plateforme vers chaque compte connecté souhaité, comme l’illustre l’exemple suivant. Indiquez l’ID du compte connecté comme étant le compte Stripe, et transmettez les ID du Client et du PaymentMethod sauvegardés sur votre plateforme.

curl https://api.stripe.com/v1/payment_methods \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d customer=
{{PLATFORM_CUSTOMER_ID}} \
  -d payment_method=
{{PAYMENT_METHOD_ID}}

Le PaymentMethod dupliqué constitue un objet indépendant doté d’un identifiant unique. Il n’est pas lié au PaymentMethod de votre plateforme et n’est pas synchronisé avec lui. Cependant, le PaymentMethod dupliqué hérite de la configuration effectuée sur votre compte de plateforme, vous n’avez donc pas besoin de le configurer à nouveau sur le compte connecté.

Créer et confirmer un PaymentIntent sur un compte connecté

Utilisez l’API Payment Intents pour créer et confirmer un PaymentIntent sur un compte connecté à l’aide du PaymentMethod dupliqué :

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d payment_method=
{{PAYMENT_METHOD_ID}} \
  -d currency=USD \
  -d amount=1099 \
  -d off_session=true \
  -d confirm=true

La création d’un paiement avec le PaymentMethod dupliqué le consomme, car il n’est pas rattaché à un client. Cependant, la consommation de ce dernier n’affecte pas le PaymentMethod d’origine enregistré sur votre plateforme. Vous ne pouvez pas réutiliser la duplication consommée, mais vous pouvez dupliquer à nouveau le PaymentMethod de la plateforme et utiliser la nouvelle duplication pour un autre paiement.

Configurer des paiements récurrents sur un compte connecté

Pour utiliser un PaymentMethod dupliqué pour des paiements directs récurrents sur un compte connecté, vous devez créer un objet Customer sur le compte connecté et lui attacher le PaymentMethod dupliqué. Ensuite, au lieu de créer des PaymentIntents, créez un abonnement à l’aide du PaymentMethod dupliqué et du Customer associé.

Traiter les mises à jour des clients et des paiements

Si vous ne percevez pas de paiements récurrents, il vous suffit de mettre à jour le client et le PaymentMethod sur votre compte de plateforme. Vous dupliquez le PaymentMethod pour chaque paiement direct, ce qui vous permet de toujours utiliser la version la plus récente. Le client n’existe que sur votre compte de plateforme, vous n’avez donc pas besoin de synchroniser les informations du client sur plusieurs comptes.

Si vous collectez des paiements récurrents et que vous mettez à jour le client ou le PaymentMethod sur votre compte de plateforme, vous êtes responsable de la mise à jour des objets correspondants enregistrés sur tous les comptes connectés. Si vous mettez à jour le PaymentMethod d’origine sur votre plateforme, dupliquez-le à nouveau et attachez la nouvelle duplication au client et à l’abonnement sur le compte connecté. Répétez le processus pour chaque compte connecté qui enregistre une duplication pour les paiements récurrents.