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

Para ajudar no desempenho e na confiabilidade, a Stripe estabeleceu limites de taxa e alocações para endpoints de API.

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

Para fazer chamadas de API no lado do servidor para contas conectadas, use o cabeçalho Stripe-Account com o identificador da conta, que começa com o prefixo acct_. Veja a seguir quatro exemplos usando a chave secreta de API da sua plataforma e o identificador da Conta da conta conectada:

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

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_BQokikJOvBiI2HlWgH4olfQ2
:"

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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  --data-urlencode email="person@example.com"

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_TYooMQauvdEDq54NiTphI7jx', {
  stripeAccount: 
{{CONNECTED_ACCOUNT_ID}},
});