Plateformes Connect utilisant l'API Payment Methods
Les propriétaires de la plateforme Connect peuvent utiliser des moyens de paiement supplémentaires pris en charge par l’API Payment Methods. Pour en savoir plus sur la création de paiements pour les utilisateurs connectés et sur l’approche qui vous convient le mieux, consultez notre documentation sur les paiements et frais Connect.
Vous pouvez utiliser l’API Payment Methods avec Connect de différentes manières si vous choisissez les paiements directs.
Utilisation de l’API Payment Methods avec les paiements directs
Pour utiliser les paiements directs, vous devez créer des PaymentMethods sur les comptes connectés. Pour utiliser ce type de paiements, vous devez activer le moyen de paiement que vous comptez utiliser sur le compte connecté.
Créer et associer un PaymentMethod lors de la confirmation d’un PaymentIntent
Nous recommandons d’enregistrer les informations liées au moyen de paiement lors de la confirmation du Payment Intent si vous utilisez l’API Payment Methods avec Connect. Pour en savoir plus sur ce processus, consultez Enregistrer une carte bancaire lors du paiement.
Initialisez l’objet Stripe avec Stripe.js et définissez l’ID du compte connecté sur stripeAccount
. Utilisez l’option setup_future_usage
lors de la confirmation du PaymentIntent. Les informations de paiements sont ainsi enregistrées automatiquement et le client pourra les réutiliser au cours de ses prochains paiements avec ce compte connecté.
Consultez PaymentIntents avec Stripe.js pour en savoir plus sur la confirmation de chaque type de moyen de paiement.
var stripe = Stripe(
, { stripeAccount:'pk_test_TYooMQauvdEDq54NiTphI7jx', }); (async () => { const {paymentIntent, error} = await stripe.confirmCardPayment( '{{PAYMENT_INTENT_CLIENT_SECRET}}', { payment_method: { card: card, billing_details: { name: 'Jenny Rosen' } }, setup_future_usage: 'off_session', } ); })();'{{CONNECTED_ACCOUNT_ID}}'
Si vous confirmez PaymentIntents à partir du serveur, vous pouvez utiliser l’authentification utilisant l’en-tête du compte Stripe avec toutes les bibliothèques que nous prenons en charge. Pour en savoir plus, consultez Confirmer un PaymentIntent.
Création de PaymentMethods directement sur le compte connecté
Vous pouvez aussi créer un PaymentMethod directement sur un compte connecté en utilisant createPaymentMethod
. Initialisez l’objet Stripe avec Stripe.js et définissez l’ID du compte connecté sur stripeAccount
.
// Set the connected Stripe Account on which the PaymentMethod should be created const stripe = Stripe(
, { stripeAccount:'pk_test_TYooMQauvdEDq54NiTphI7jx', }); (async () => { const {paymentMethod, error} = await stripe.createPaymentMethod({ type: 'card', card: cardElement, billing_details: { name: 'Jenny Rosen', }, }); // Handle error or paymentMethod })();'{{CONNECTED_ACCOUNT_ID}}'
Si vous créez des PaymentMethods à partir du serveur vous pouvez utiliser l’authentification utilisant l’en-tête du compte Stripe avec toutes les bibliothèques que nous prenons en charge.
Duplication de PaymentMethods
Vous pouvez également créer des PaymentMethods sur votre plateforme et les dupliquer sur un compte connecté pour créer des paiements directs. À l’heure actuelle, la fonction de duplication est uniquement disponible pour les PaymentMethods dont le paramètre type
est défini sur card
ou us_bank_account
.
Après avoir créé un PaymentMethod et l’avoir associé à un client, vous pouvez dupliquer ce PaymentMethod sur un compte connecté en utilisant l’ID du compte connecté comme en-tête Stripe-Account
. En savoir plus sur l’API Payment Methods.
Si vous souhaitez réutiliser des PaymentMethods sur un compte connecté, associez-les aux clients avant de les utiliser avec PaymentIntents pour créer des paiements. Pour des raisons de sécurité, vous devez fournir l’ID du client dans la demande lors de la duplication des PaymentMethods associés aux clients.
Il est possible de dupliquer les PaymentMethods sur des comptes connectés sans les avoir précédemment associés à des clients. Cependant, notez que le PaymentMethod initial sera consommé, étant donné que les PaymentMethods non associés à des clients ne peuvent être utilisés qu’une fois.