Stripe Connect y la API Charges

Descubre cómo Connect te permite realizar cargos y emitir envíos de fondos para cuentas conectadas. La forma en que configuras estas opciones determina tus comisiones de Stripe.

Connect admite tres enfoques para crear pagos en una cuenta conectada. Para obtener más información sobre los diferentes tipos de cargos con Connect, consulta la documentación sobre cómo elegir un enfoque. Las comisiones de Stripe se determinan según cómo configures estas opciones.

En esta página, solo se explica cómo hacer llamadas a la API Charges para cuentas conectadas. Consulta las páginas vinculadas para obtener más información sobre llamadas a otras API para operaciones relacionadas.

Cargos directos

Para crear un cargo directo en la cuenta conectada, crea un objeto Charge y añade el encabezado Stripe-Account con un valor del ID de la cuenta conectada:

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

Este ejemplo usa un token de prueba, tok_visa, pero podrías tokenizar una tarjeta de prueba usando Stripe.js y Elements en su lugar.

Consulta Aceptar un pago para conocer más detalles.

Cobra las comisiones de la aplicación sobre cargos directos

Con Connect, tu plataforma puede cobrar una comisión de la aplicación sobre los cargos directos. Para fijar esta comisión, especifica un número entero positivo como valor opcional de application_fee_amount:

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d application_fee_amount=123

Consulta Cargos directos para obtener información sobre la disponibilidad de transferencias, reembolsos, etc.

Cargos indirectos

Para crear cargos indirectos, especifica el ID de la cuenta conectada en el atributo transfer_data[destination]:

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Este ejemplo usa un token de prueba, tok_visa, pero podrías tokenizar una tarjeta de prueba usando Stripe.js y Elements en su lugar.

Consulta Aceptar un pago para conocer más detalles.

Cobra comisiones sobre cargos indirectos con application_fee_amount

Cuando se crea un cargo indirecto con application_fee_amount, el importe total del cargo se transfiere de inmediato de la plataforma a la cuenta transfer_data[destination] después de la captura del cargo. El application_fee_amount (que no puede superar el importe total del cargo) se transfiere de nuevo a la plataforma.

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d application_fee_amount=123 \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Para facilitar la elaboración de informes, se crea un objeto Application Fee después de cobrarse la comisión de la aplicación. Utiliza la propiedad amount en el objeto Application Fee para elaborar informes. También puedes acceder a estos objetos mediante el punto de conexión de comisiones de la aplicación.

Cobra comisiones sobre cargos indirectos con transfer_data[amount]

También puedes aceptar una comisión mediante transfer_data[amount].

transfer_data[amount] es un número entero positivo que refleja el importe del cargo que se transfiere a transfer_data[destination]. Resta las comisiones de tu plataforma al importe del cargo, y luego especifica el resultado del cálculo como transfer_data[amount]:

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d "transfer_data[amount]"=877 \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Consulta Cargos indirectos para obtener información sobre la disponibilidad de transferencias, reembolsos, etc.

Cargos y envíos de fondos separados

Para crear un cargo y configurar el envío de fondos asociado, crea un transfer_group y asigna el cargo al transfer_group.

# Create a Charge:
curl https://api.stripe.com/v1/charges \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "amount"=10000 \
  -d "currency"="usd" \
  -d "source"="tok_visa" \
  -d "transfer_group"="{ORDER10}"

# Create a Transfer to a connected account (later):
curl https://api.stripe.com/v1/transfers \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "amount"=7000 \
  -d "currency"="usd" \
  -d "destination"="{{CONNECTED_STRIPE_ACCOUNT_ID}}" \
  -d "transfer_group"="{ORDER10}"

# Create a second Transfer to another connected account (later):
curl https://api.stripe.com/v1/transfers \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "amount"=2000 \
  -d "currency"="usd" \
  -d "destination"="{{OTHER_CONNECTED_STRIPE_ACCOUNT_ID}}" \
  -d "transfer_group"="{ORDER10}"

Este ejemplo usa un token de prueba, tok_visa, pero podrías tokenizar una tarjeta de prueba usando Stripe.js y Elements en su lugar.

Consulta Aceptar un pago para obtener más información.

Cómo usar el argumento on_behalf_of con cargos y envíos de fondos separados

Con cargos y envíos de fondos separados, los valores predeterminados son:

• Los cargos se cobran en el país de la plataforma
• Se utiliza la estructura de comisiones del país de la plataforma
• La información de la plataforma se muestra en el extracto de la tarjeta de crédito del cliente

Si prefieres usar el país de la cuenta conectada y mostrar su información, usa el argumento on_behalf_of.

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d on_behalf_of=
{{CONNECTED_ACCOUNT_ID}}

Consulta Cómo crear cargos y envíos de fondos separados para obtener información sobre la disponibilidad de los envíos de fondos, los reembolsos, etc.