Fazer chamadas de API para contas conectadas

Você pode fazer chamadas de API para contas conectadas:

• No lado do servidor, com o cabeçalho Stripe-Account e o ID da conta conectada, por solicitação
• Do lado do cliente, passando o ID da conta conectada como um argumento para a biblioteca do cliente

To help with performance and reliability, Stripe has established rate limits and allocations for API endpoints.

Adicionar o cabeçalho Stripe-Account no lado do servidor

Para chamadas de API do lado do servidor, você pode fazer solicitações como contas conectadas usando o cabeçalho especial Stripe-Account com o identificador de conta da Stripe (ele começa com o prefixo acct_) do usuário da sua plataforma. Aqui temos um exemplo que mostra como criar um PaymentIntent com a chave secreta de API da sua plataforma e o identificador da conta do seu usuário.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_09l3shTSTKHYCzzZZsiLl2vA
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d amount=1000 \
  -d currency=usd \
  -d "automatic_payment_methods[enabled]"=true

Na versão mais recente da API, especificar o parâmetro automatic_payment_methods é opcional porque a Stripe habilita sua funcionalidade por padrão.

A abordagem do cabeçalho Stripe-Account está implícita em qualquer solicitação de API que inclua o ID da conta Stripe no URL. Veja um exemplo que mostra como recuperar uma conta com o identificador da conta do usuário no URL.

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_09l3shTSTKHYCzzZZsiLl2vA
:"

Todas as bibliotecas no lado do servidor da Stripe aceitam essa abordagem por solicitação:

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_09l3shTSTKHYCzzZZsiLl2vA
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  --data-urlencode email="[email protected]"

Adicionar o ID da conta conectada a um aplicativo no lado do cliente

As bibliotecas no lado do cliente definem o ID da conta conectada como um argumento do aplicativo do cliente:

var stripe = Stripe(
'pk_test_46zswMCbz39W2KAqKj43vDRu', {
  stripeAccount: 
{{CONNECTED_ACCOUNT_ID}},
});