Accéder directement au contenu
Créez un compte
 ou
connecter-vous
Logo de la documentation Stripe
/
Créez un compte
Connectez-vous
AperçuMettre votre intégration à niveau
Paiements en ligne
PrésentationTrouver votre cas d'usageManaged Payments
Moyens de paiement
Interfaces de paiement
Scénarios de paiement
Paiements par TPE
Terminal
Autres produits Stripe

Utiliser Terminal avec Connect

Intégrez Stripe Terminal à votre plateforme Connect.

Copier la page

Stripe Terminal est entièrement compatible avec Connect, ce qui permet à votre plateforme ou place de marché d’accepter les paiements par TPE.

La façon dont Terminal crée des objets API varie selon que vous utilisez des paiements directs ou des paiements indirects. Si vous utilisez des paiements directs, tous les objets de l’API Terminal associés aux paiements relèvent des comptes connectés, tandis que les lecteurs relèvent soit du compte connecté, soit de la plateforme. Si vous utilisez des paiements indirects, tous les objets de l’API Terminal sont créés sur votre compte de plateforme. Dans les deux cas, utilisez l’objet Locations pour grouper les lecteurs à votre convenance.

Remarque

Vos comptes Connect Terminal doivent disposer de la fonctionnalité card_payments pour effectuer des transactions.

Paiements directs

Lecteurs des comptes connectés

Avec cette intégration, toutes les ressources API relèvent du compte connecté, et non de la plateforme. Le compte connecté assume les frais Stripe, les remboursements et les contestations de paiement.

Dans le Dashboard, vous pouvez visualiser vos données Terminal en vous connectant à votre compte connecté.

Créer des emplacements et des lecteurs Server-side

Créez des objets d’API Terminal, par exemple des objets Location ou Reader, qui relèvent du compte connecté responsable du paiement.

Pour créer un objet Location appartenant à un compte connecté, utilisez l’en-tête Stripe-Account.

Command Line
curl https://api.stripe.com/v1/terminal/locations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d display_name=HQ \
  -d "address[line1]"="1272 Valencia Street" \
  -d "address[city]"="San Francisco" \
  -d "address[state]"=CA \
  -d "address[country]"=US \
  -d "address[postal_code]"=94110

Avant de pouvoir connecter votre application à un lecteur intelligent, vous devez enregistrer ce lecteur sur un compte Stripe. Pour enregistrer un lecteur sur un compte connecté, utilisez l’en-tête Stripe-Account.

Command Line
curl https://api.stripe.com/v1/terminal/readers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d registration_code={{READER_REGISTRATION_CODE}} \
  --data-urlencode label="Alice's reader" \
  -d location=
{{LOCATION_ID}}

Créer des tokens de connexion Server-side

Remarque

Lorsque vous utilisez l’authentification OAuth de Connect, le compte connecté doit être autorisé séparément pour le mode production et l’environnement de test, au moyen de l’ID client de l’application correspondant à chaque mode.

Lorsque vous créez un ConnectionToken pour le SDK Terminal, définissez l’en-tête Stripe-Account sur le compte connecté acceptant les paiements. Vous pouvez également fournir un paramètre location afin de contrôler l’accès aux lecteurs. Si vous définissez un emplacement, le ConnectionToken n’est utilisable qu’avec les lecteurs assignés à cet emplacement. Sans emplacement défini, vous pouvez utiliser le ConnectionToken avec tous les lecteurs.

Command Line
curl https://api.stripe.com/v1/terminal/connection_tokens \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d location=
{{LOCATION_ID}}

Créer des PaymentIntents Client-side Server-side

Avec les SDK iOS, Android et React Native, vous pouvez créer un PaymentIntent côté client ou côté serveur. Avec le SDK JavaScript, seule la création côté serveur est prise en charge.

Côté client

Lorsque vous créez un PaymentIntent côté client pour les paiements directs, il n’est pas nécessaire de préciser des paramètres supplémentaires pour le PaymentIntent : il vous suffit de définir l’en-tête Stripe-Account sur le compte connecté qui accepte les paiements lorsque vous créez un ConnectionToken. Les SDK client créent le PaymentIntent sur le même compte connecté auquel appartient le ConnectionToken. Pour en savoir plus, veuillez consulter la page Créer des PaymentIntents côté client.

Côté serveur

Le SDK JavaScript exige que le PaymentIntent soit créé sur votre serveur. Pour les autres SDK client, créez le PaymentIntent sur votre serveur si les informations requises pour démarrer un paiement ne sont pas facilement accessibles dans votre application. Pour en savoir plus, veuillez consulter la page Créer des PaymentIntents côté serveur.

Afin de créer un PaymentIntent côté serveur pour les paiements directs, définissez l’en-tête Stripe-Account sur le compte connecté.

Command Line
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]"=card_present \
  -d capture_method=manual

La plateforme est propriétaire des lecteurs

Remarque

Contactez-nous si vous souhaitez utiliser des paiements directs et que la plateforme possède et gère les lecteurs. Cette fonction en version bêta privée est actuellement disponible pour les lecteurs intelligents reposant sur une intégration pilotée par serveur. Cette intégration ne fonctionne qu’avec les comptes connectés que vous contrôlez via une plateforme unique.

Avec cette intégration, les ressources de gestion des appareils, comme les objets Location et Reader, appartiennent au compte de plateforme, tandis que les ressources de paiement telles que les PaymentIntents appartiennent au compte connecté. Cela permet à un seul lecteur géré par la plateforme de traiter les paiements de plusieurs comptes connectés différents. Le compte connecté assume le coût des frais Stripe, des remboursements et des contestations de paiement.

Dans le Dashboard, vous pouvez visualiser directement vos données de gestion des appareils Terminal lorsque vous êtes connecté(e) à votre compte de plateforme. Pour consulter les données de paiement, vous devez vous connecter en tant que compte connecté.

Créer des emplacements et des lecteurs

Le meilleur moyen de regrouper les objets Reader par compte connecté consiste à les assigner à des objets Locations. Sur votre compte de plateforme, créez un objet Location pour un compte connecté en utilisant un nom d’affichage permettant d’identifier le compte.

Command Line
curl https://api.stripe.com/v1/terminal/locations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d display_name=HQ \
  -d "address[line1]"="1272 Valencia Street" \
  -d "address[city]"="San Francisco" \
  -d "address[state]"=CA \
  -d "address[country]"=US \
  -d "address[postal_code]"=94110

Avant de pouvoir connecter votre application à un lecteur intelligent, vous devez enregistrer ce lecteur sur votre compte de plateforme.

Command Line
curl https://api.stripe.com/v1/terminal/readers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d registration_code={{READER_REGISTRATION_CODE}} \
  --data-urlencode label="Alice's reader" \
  -d location=
{{LOCATION_ID}}

Créer des PaymentIntents

Lorsque vous créez un PaymentIntent pour des paiements directs, l’en-tête Stripe-Account doit faire référence au compte connecté.

Remarque

La plateforme ne peut traiter les PaymentIntents ultérieurement que si vous les créez pour des comptes connectés que vous contrôlez par l’intermédiaire d’une plateforme unique.

Command Line
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]"=card_present \
  -d capture_method=manual

Traiter les PaymentIntents

La plateforme peut traiter le PaymentIntent du compte connecté avec le lecteur de la plateforme.

Remarque

Le PaymentIntent ne peut être traité que si vous le créez en utilisant l’en-tête Stripe-Account.

Command Line
curl https://api.stripe.com/v1/terminal/readers/
{{READER_ID}}
/process_payment_intent \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d payment_intent=
{{PAYMENT_INTENT_ID}}

Paiements indirects

Pour les paiements indirects, les ressources API, telles que les PaymentIntents et les objets Location appartiennent à votre compte de plateforme. Chaque paiement crée automatiquement un transfert vers un compte connecté.

Dans le Dashboard, vous pouvez visualiser vos données Terminal directement en vous connectant à votre compte de plateforme.

Créer des emplacements et des lecteurs Server-side

Le meilleur moyen de regrouper les objets Reader par compte connecté consiste à les assigner à des objets Locations. Sur votre compte de plateforme, créez un objet Location pour un compte connecté en utilisant un nom d’affichage permettant d’identifier le compte.

Command Line
curl https://api.stripe.com/v1/terminal/locations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d display_name=HQ \
  -d "address[line1]"="1272 Valencia Street" \
  -d "address[city]"="San Francisco" \
  -d "address[state]"=CA \
  -d "address[country]"=US \
  -d "address[postal_code]"=94110

Avant de pouvoir connecter votre application à un lecteur intelligent, vous devez enregistrer ce lecteur sur votre compte de plateforme.

Command Line
curl https://api.stripe.com/v1/terminal/readers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d registration_code={{READER_REGISTRATION_CODE}} \
  --data-urlencode label="Alice's reader" \
  -d location=
{{LOCATION_ID}}

Créer des tokens de connexion Server-side

Lorsque vous créez un ConnectionTokenpour le SDK Terminal, utilisez la clé secrète du compte de votre plateforme. Ne définissez pas l’en-tête Stripe-Account. Fournissez un paramètre location afin de contrôler l’accès aux lecteurs. Si vous définissez un emplacement, le ConnectionToken n’est utilisable qu’avec les lecteurs assignés à cet emplacement. Sans emplacement défini, vous pouvez utiliser le ConnectionToken avec tous les lecteurs.

Command Line
curl https://api.stripe.com/v1/terminal/connection_tokens \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d location=
{{LOCATION_ID}}

Créer des PaymentIntents Client-side Server-side

Pour créer un PaymentIntent avec des paiements indirects, fournissez les paramètres on_behalf_of, transfer_data[destination] et application_fee_amount.

Le paramètre on_behalf_of correspond à l’ID du compte connecté qui devient l’entité de règlement pour le paiement. Pour les transactions Terminal, ce paramètre doit être défini dans les cas où le pays de la plateforme n’est pas le même que celui du compte Connect. Lorsque le paramètre on_behalf_of est défini, Stripe effectue automatiquement les actions suivantes :

  • Règle les paiements dans le pays du compte spécifié, ce qui limite les refus de paiement et évite les conversions de devises.
  • Utilise la structure des frais appliquée pour le pays du compte connecté.
  • Indique l’adresse et le numéro de téléphone du compte connecté sur le relevé de carte bancaire du client, au lieu de l’adresse et du numéro de téléphone de la plateforme (uniquement si le compte et la plateforme se trouvent dans des pays différents).

Pour le paramètre transfer_data[destination], précisez l’ID du compte connecté destinataire du transfert.

Enfin, vous pouvez prélever une commission pour votre plateforme en renseignant le paramètre application_fee_amount.

Côté client

Avec les SDK iOS, Android et React Native, vous pouvez créer un PaymentIntent côté client et fournir les paramètres onBehalfOf, transferDataDestination et applicationFeeAmount.

Remarque

Client-side PaymentIntent creation is possible with the other SDKs. If you’re using the JavaScript SDK for Stripe Terminal, create a PaymentIntent server-side.

Côté serveur

Le SDK JavaScript exige que le PaymentIntent soit créé sur votre serveur. Pour les autres SDK client, créez le PaymentIntent sur votre serveur si les informations requises pour démarrer un paiement ne sont pas facilement accessibles dans votre application. Pour en savoir plus, veuillez consulter la page Créer des PaymentIntents côté serveur.

Command Line
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]"=card_present \
  -d capture_method=manual \
  -d application_fee_amount=200 \
  -d on_behalf_of=
{{CONNECTED_ACCOUNT_ID}}
 \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Voir aussi

Cette page vous a-t-elle été utile ?
OuiNon
Besoin d'aide ? Contactez le service Support.
Rejoignez notre programme d'accès anticipé.
Consultez notre log des modifications.
Des questions ? Contactez l'équipe commerciale.
LLM ? Lire llms.txt.
Propulsé par Markdoc