Stripe Connect et l'API Charges

Découvrez comment effectuer des paiements et des transferts pour vos comptes connectés grâce à Connect. La façon dont vous configurez ces options détermine le montant de vos frais Stripe.

Il existe trois manières de créer des paiements pour un compte connecté avec Connect. Pour en savoir plus sur les différents types de paiements Connect, consultez notre documentation relative à ces différentes approches. La façon dont vous configurez ces options détermine le montant des frais Stripe.

Cette page explique uniquement comment effectuer des appels à l’API Charges pour les comptes connectés. Pour en savoir plus sur les appels à d’autres API pour des opérations similaires, veuillez cliquer sur les liens fournis.

Paiements directs

Pour créer un paiement direct pour un compte connecté, créez un objet Charge et ajoutez l’en-tête Stripe-Account avec une valeur de l’ID du compte connecté :

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa

Cet exemple utilise un token de test—tok_visa—mais vous pouvez également tokeniser une carte de test à l’aide de Stripe.js et Elements.

Pour plus d’informations, consultez la page Accepter un paiement.

Encaisser les frais de plateforme sur les paiements directs

Connect vous permet de prélever des frais de plateforme sur les paiements directs. Pour appliquer des frais de plateforme sur un paiement, transmettez une valeur application_fee_amount facultative sous la forme d’un nombre entier positif :

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d application_fee_amount=123

Consultez notre page sur les paiements directs pour en savoir plus sur la disponibilité des transferts, les remboursements, etc.

Paiements indirects

Pour créer un paiement indirect, transmettez l’ID du compte connecté dans l’attribut transfer_data[destination] :

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Cet exemple utilise un token de test—tok_visa—mais vous pouvez également tokeniser une carte de test à l’aide de Stripe.js et Elements.

Pour plus d’informations, consultez la page Accepter un paiement.

Percevoir des frais sur les paiements indirects avec application_fee_amount

Lorsque vous créez des paiements indirects avec un paramètre application_fee_amount, la totalité du montant du paiement est transférée de la plateforme vers le compte transfer_data[destination] tout de suite après la capture du paiement. Le montant des frais application_fee_amount (qui ne peut dépasser le montant du paiement) est ensuite transféré du compte vers la plateforme.

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d application_fee_amount=123 \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Pour faciliter la génération des rapports, un objet Application fee est créé après l’encaissement de la commission de la plateforme. Utilisez la propriété amount sur l’objet Application fee pour la création de rapports. Vous pouvez ensuite accéder à ces objets à partir de l’endpoint Application Fees.

Percevoir des frais sur les paiements indirects avec transfer_data[amount]

Vous pouvez également prélever des frais en utilisant transfer_data[amount].

Le paramètre transfer_data[amount] doit être un nombre entier positif correspondant au montant du paiement effectivement transféré vers transfer_data[destination]. Déduisez les frais de votre plateforme du montant du paiement puis transmettez le résultat obtenu sous le paramètre transfer_data[amount] :

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d "transfer_data[amount]"=877 \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Consultez notre page sur les paiements indirects pour en savoir plus sur la disponibilité des transferts, les remboursements, etc.

Paiements et transferts distincts

Pour créer un paiement et configurer le transfert associé, créez un transfer_group auquel vous affecterez le paiement.

# Create a Charge:
curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "amount"=10000 \
  -d "currency"="usd" \
  -d "source"="tok_visa" \
  -d "transfer_group"="{ORDER10}"

# Create a Transfer to a connected account (later):
curl https://api.stripe.com/v1/transfers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "amount"=7000 \
  -d "currency"="usd" \
  -d "destination"="{{CONNECTED_STRIPE_ACCOUNT_ID}}" \
  -d "transfer_group"="{ORDER10}"

# Create a second Transfer to another connected account (later):
curl https://api.stripe.com/v1/transfers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "amount"=2000 \
  -d "currency"="usd" \
  -d "destination"="{{OTHER_CONNECTED_STRIPE_ACCOUNT_ID}}" \
  -d "transfer_group"="{ORDER10}"

Cet exemple utilise un token de test—tok_visa—mais vous pouvez également tokeniser une carte de test à l’aide de Stripe.js et Elements.

Pour plus d’informations, consultez la page Accepter un paiement.

Utilisation du paramètre on_behalf_of pour les paiements et transferts distincts

Par défaut, pour les paiements et transferts distincts :

• Les paiements sont réglés dans le pays de la plateforme
• La structure des frais appliquée est celle du pays de la plateforme
• Les informations de la plateforme sont affichées sur le relevé de carte bancaire du client

Si vous souhaitez plutôt utiliser le pays du compte connecté et afficher ses informations, vous pouvez utiliser l’argument on_behalf_of.

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d on_behalf_of=
{{CONNECTED_ACCOUNT_ID}}

Consultez la page consacrée à la création de paiements et transferts distincts pour en savoir plus sur la disponibilité des transferts, les remboursements, etc.