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 uma inscrição 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}},
});

Use componentes integrados do Connect

Em vez de integrar diretamente com as APIs do Stripe, você pode usar Componentes integrados do Connect para fornecer funções do Stripe às suas contas conectadas na IU da sua plataforma. Esses componentes exigem menos código para implementar e lidar com todas as chamadas da API internamente.

Por exemplo, para exibir dados de pagamentos das suas contas conectadas, integre o componente Pagamentos na interface do usuário da sua plataforma. Isso elimina a necessidade de fazer chamadas separadas para as APIs Cobranças, PaymentIntents, Reembolsos e Contestações.

Veja uma lista completa dos componentes integrados disponíveis em Componentes aceitos.