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 de la cuenta de Stripe del lado del servidor

Para realizar llamadas API del lado del servidor para cuentas conectadas, usa el Stripe-Account con el identificador de cuenta, que comienza con el prefijo acct_. Aquí tienes cuatro ejemplos con la clave secreta de la API de tu plataforma y el identificador de Cuenta de la cuenta 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

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

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

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  --data-urlencode email="person@example.com"

Agregar la ID de la cuenta conectada a una solicitud 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_TYooMQauvdEDq54NiTphI7jx', {
  stripeAccount: 
{{CONNECTED_ACCOUNT_ID}},
});

Usa componentes integrados de Connect

En lugar de integrarte directamente con las API de Stripe, puedes usar los componentes integrados de Connect para proporcionar funcionalidades de Stripe a tus cuentas conectadas en la interfaz de usuario (IU) de tu plataforma. Estos componentes requieren menos código para implementar y manejar todas las llamadas API internamente.

Por ejemplo, para mostrar los datos de pago a tus cuentas conectadas, integra el componente Payments en la interfaz de usuario (IU) de tu plataforma y eliminar la necesidad de realizar llamadas separadas a la API de cobro, Payment Intents, reembolsos, y disputas.

Para obtener una lista completa de los componentes integrados disponibles, consulta componentes soportados.