Stripe Connect y la API Charges
API heredada
El contenido de esta sección se refiere a una funcionalidad de Legacy. Usa la API PaymentIntents.
The Charges API doesn’t support the following features, many of which are required for credit card compliance:
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 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:
This example uses a test token—tok_visa—but you could tokenize a test card using Stripe.js and Elements instead.
Consulta Aceptar un pago para conocer más detalles.
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
:
Consulta cargos Direct para obtener información sobre la disponibilidad de envíos de fondos, reembolsos, etc.
Cargos a un Destino
Para crear cargos a un Destino, especifica el ID de la cuenta conectada en el atributo transfer_data[destination]
:
This example uses a test token—tok_visa—but you could tokenize a test card using Stripe.js and Elements instead.
Consulta Aceptar un pago para conocer más detalles.
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.
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]
:
Consulta cargos a un destino para obtener información sobre la disponibilidad de envíos de fondos, 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
.
This example uses a test token—tok_visa—but you could tokenize a test card using Stripe.js and Elements instead.
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
.
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 envíos de fondos, reembolsos, etc.