Stripe Connect y la API Charges

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

Connect admite tres enfoques para crear pagos en una cuenta conectada. Para mayor información sobre los diferentes tipos de cargos con Connect, consulta la documentación referida a 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 Direct

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

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

En este ejemplo, se utiliza un token de prueba, tok_visa, pero puedes tokenizar una tarjeta de prueba con Stripe.js y Elements.

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

Cobrar las comisiones de la aplicación sobre cargos Direct

Con Connect, tu plataforma puede cobrar una comisión de la aplicación sobre los cargos Direct. 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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d application_fee_amount=123

Consulta cargos Direct para obtener información sobre la disponibilidad de envíos de fondos, rembolsos, etc.

Cargos a un Destino

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

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

En este ejemplo, se utiliza un token de prueba, tok_visa, pero puedes tokenizar una tarjeta de prueba con Stripe.js y Elements.

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

Cobra comisiones sobre cargos a un Destino con application_fee_amount

Cuando se crea un cargo a un Destino 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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 del cobro de 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 usando el punto de conexión de comisiones de la aplicación.

Cobrar comisiones sobre cargos a un Destino con transfer_data[amount]

También puedes aceptar una comisión usando 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 del 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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d "transfer_data[amount]"=877 \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Consulta cargos a un Destino para obtener información sobre la disponibilidad de envíos de fondos, rembolsos, 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_BQokikJOvBiI2HlWgH4olfQ2
: \
  -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_BQokikJOvBiI2HlWgH4olfQ2
: \
  -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_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "amount"=2000 \
  -d "currency"="usd" \
  -d "destination"="{{OTHER_CONNECTED_STRIPE_ACCOUNT_ID}}" \
  -d "transfer_group"="{ORDER10}"

En este ejemplo, se utiliza un token de prueba, tok_visa, pero puedes tokenizar una tarjeta de prueba con Stripe.js y Elements.

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, en cambio, quieres 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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 más información sobre disponibilidad de envíos de fondos, rembolsos, etc.