Cómo hacer llamadas de API para cuentas conectadas

Puedes hacer llamadas de API para tus cuentas conectadas:

• Del lado del servidor con el encabezado Stripe-Account y el ID de la cuenta conectada, por solicitud
• Del lado del cliente pasando el ID de la cuenta conectada como argumento a la biblioteca del cliente

A fin de mejorar el rendimiento y la confiabilidad, Stripe estableció límites de frecuencia y asignaciones para los puntos de conexión de la API.

Cómo agregar el encabezado Stripe-Account del lado del servidor

Para las llamadas API del lado del servidor, puedes hacer solicitudes como cuentas conectadas usando el encabezado Stripe-Account con el identificador de cuenta de Stripe (comienza con el prefijo acct_) del usuario de tu plataforma. Este es un ejemplo que muestra cómo Crear un PaymentIntent con la clave secreta de la API de tu plataforma y el identificador Account de tu usuario.

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

En la última versión de la API, especificar el parámetro automatic_payment_methods es opcional porque Stripe habilita su funcionalidad de forma predeterminada.

El método del encabezado Stripe-Account está implícito en las solicitudes de la API que incluyan la ID de la cuenta de Stripe en la URL. Este es un ejemplo que muestra cómo Recuperar una cuenta con el identificador de Account de tu usuario en la URL.

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

Todas las bibliotecas del lado del servidor de Stripe admiten este enfoque por solicitud:

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

Cómo agregar el ID de la cuenta conectada a la aplicación del lado del cliente

Las bibliotecas del lado del cliente establecen el ID de la cuenta conectada como argumento en la aplicación del cliente:

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