Stripe Connect y la API Charges
API heredada
El contenido de esta sección se refiere a una función de Legacy. Usa la API de PaymentIntents.
La API Charges no admite las siguientes funciones, muchas de las cuales son necesarias para cumplir con la normativa de las tarjetas de crédito:
Descubre cómo efectuar cargos y envíos de fondos para cuentas conectadas con Connect. Las comisiones de Stripe se determinan según cómo configures estas opciones.
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:
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 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
:
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]
:
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 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.
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]
:
Consulta Cargos indirectos para obtener información sobre la disponibilidad de transferencias, reembolsos, etc.
Cargos y envíos de fondos separados
Precaución
Solamente puedes utilizar cargos y envíos de fondos separados si tu plataforma y la cuenta conectada están en la misma región. Por ejemplo, si tu cuenta de plataforma está en Europa, la cuenta conectada también debe estar en Europa.
Para crear un cargo y configurar el envío de fondos asociado, crea un transfer_group
y asigna el cargo al transfer_group
.
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 prefieres usar el país de la cuenta conectada y mostrar su información, usa el argumento on_behalf_of
.
Precaución
Solo puedes utilizar on_behalf_of
con cargos y envíos de fondos separados para cuentas conectadas con la funcionalidad card_payments.
Consulta Cómo crear cargos y envíos de fondos separados para obtener información sobre la disponibilidad de las transferencias, los reembolsos, etc.