Crea cargos a un destino

Crea cargos en la cuenta de tu plataforma, cobra comisiones y transfiere de inmediato los fondos restantes a tus cuentas conectadas.

Crea cargos a un destino cuando los clientes hacen la transacción con tu plataforma por productos o servicios suministrados por tus cuentas conectadas y transfieres fondos inmediatamente a tus cuentas conectadas. Con este tipo de cargo:

Creas un cargo en la cuenta de tu plataforma.
Determinas si el total o una parte de los fondos se transfiere a la cuenta conectada.
Se debita del saldo de tu cuenta el costo de las comisiones, los reembolsos y los contracargos de Stripe.

Este tipo de cargo es más óptimo para plataformas como Airbnb, una plataforma de alquiler de alojamientos o Lyft, una aplicación de viajes compartidos.

Los cargos a un destino solo son compatibles si tanto tu plataforma como la cuenta conectada están en el mismo país. Para que se admitan entre países, debes especificar el comerciante a cargo del cobro en la cuenta conectada con el parámetro on_behalf_of en el Payment Intent u otros escenarios de transferencias transfronterizas válidas. Recomendamos usar cargos a un destino para las cuentas conectadas que tienen acceso al Dashboard de Express o que no tienen acceso al Dashboard.

Vista previa privada

Puedes usar cargos a un destino, sin el parámetro on_behalf_of, cuando tu plataforma y la cuenta conectada estén en diferentes países de EE. UU., el Reino Unido y la Unión Europea. Para acceso anticipado, comunícate con us.

Web

iOS

Android

React Native

Redirige a los usuarios a una página de pago alojada en Stripe con Stripe Checkout. Comprueba cómo esta integración se compara con los otros tipos de integración de Stripe.

Vista previa de la finalización de compra

Esfuerzo de integración

Baja codificación (low code)

Tipo de integración

Redirigir a la página de pagos alojada en Stripe

Personalización de la interfaz de usuario

Personalización limitada

Probarlo

Primero, inscríbete para obtener una cuenta de Stripe.

Usa nuestras bibliotecas oficiales para acceder a la API de Stripe desde tu aplicación:

Crear una sesión de Checkout
Lado del cliente
Lado del servidor

Una sesión de Checkout controla lo que tu cliente puede ver en el formulario de pago, como las partidas, el importe y la moneda del pedido, y los métodos de pago aceptados. Agrega un botón de confirmación de compra a tu sitio web que llame a un punto de conexión del lado del servidor para crear una sesión de Checkout.

checkout.html
<html>
  <head>
    <title>Checkout</title>
  </head>
  <body>
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Checkout</button>
    </form>
  </body>
</html>

En tu servidor, crea una sesión de Checkout y redirige a tu cliente a la URL que se devuelve en la respuesta.

payment_intent_data[transfer_data][destination] - Este parámetro indica que se trata de un cargo a un destino. Este cargo implica que el cargo se procese en la plataforma y luego los fondos se transfieran de forma inmediata y automática al saldo pendiente de la cuenta conectada.
line_items: este parámetro representa los artículos que compra el cliente. Se muestran los artículos en el formulario de pago integrado.
success_url: Stripe redirige al cliente a la URL de éxito después de que complete un pago y reemplaza la cadena {CHECKOUT_SESSION_ID} con la ID de la sesión de Checkout. Úsalo para recuperar la sesión de Checkout e inspecciona el estado para decidir qué mostrarás a tu cliente. También puedes adjuntar tus propios parámetros de consulta, que se mantendrán durante el proceso de redireccionamiento. Consulta la sección Personalizar el comportamiento de redireccionamiento en una página alojada en Stripe para obtener más información.
payment_intent_data[application_fee_amount]: este parámetro especifica el importe que tu plataforma tomará de la transacción. El importe total del cargo se transfiere de inmediato de la plataforma a la cuenta conectada especificada por transfer_data[destination] después de la captura del cargo. El application_fee_amount se vuelve a transferir a la plataforma y se deduce la comisión de Stripe del importe de la plataforma.

Cuando se procesan cargos a un Destino, Checkout utiliza la configuración de marca de la cuenta de tu plataforma. Consulte personalizar imagen de marca para obtener más información.

Gestionar eventos posteriores al pago
Lado del servidor

Stripe envía un evento checkout.session.completed cuando se completa el pago. Utiliza un webhook para recibir estos eventos y ejecutar acciones, como enviar un correo electrónico de confirmación del pedido a tu cliente, registrar la venta en una base de datos o iniciar el flujo de tareas para un envío.

Escucha estos eventos en lugar de esperar una devolución de llamada del cliente. De su lado, el cliente puede cerrar la ventana del navegador o salir de la aplicación antes de que se ejecute la devolución de llamada. Además, algunos métodos de pago tardan entre 2 y 14 días en confirmar el pago. Si configuras tu integración para escuchar eventos asincrónicos, podrás aceptar varios métodos de pago con una sola integración.

Stripe recomienda administrar todos los siguientes eventos al cobrar pagos con Checkout:

Evento	Descripción	Próximos pasos
checkout.session.completed	Mediante el envío del formulario de Checkout, el cliente ha autorizado correctamente el pago.	Espera hasta saber si el pago se concreta o no.
checkout.session.async_payment_succeeded	El pago del cliente se efectuó correctamente.	Entrega los bienes o servicios comprados.
checkout.session.async_payment_failed	El pago se rechazó o falló por algún otro motivo.	Ponte en contacto con el cliente por correo electrónico y solicítale que haga un nuevo pedido.

Todos estos eventos incluyen el objeto Checkout Session. Una vez que el pago se efectúa correctamente, el estado del PaymentIntent subyacente cambia de processing a succeeded o a un estado de falla.

Probar la integración

Número de tarjeta	Escenario	Cómo hacer la prueba
	El pago con tarjeta se efectúa correctamente y no requiere autenticación.	Completa el formulario de tarjeta de crédito con el número de tarjeta de crédito y la fecha de vencimiento, el CVC o el código postal.
	El pago con tarjeta requiere autenticación.	Completa el formulario de tarjeta de crédito con el número de tarjeta de crédito y la fecha de vencimiento, el CVC o el código postal.
	La tarjeta es rechazada con un código de rechazo `insufficient_funds`.	Completa el formulario de tarjeta de crédito con el número de tarjeta de crédito y la fecha de vencimiento, el CVC o el código postal.
	La tarjeta UnionPay puede tener entre 13 y 19 dígitos.	Completa el formulario de tarjeta de crédito con el número de tarjeta de crédito y la fecha de vencimiento, el CVC o el código postal.

Consulta Pruebas para obtener información adicional para probar tu integración.

OpcionalHabilitar métodos de pago adicionales

Cobra comisiones

Cuando se procesa un pago, en lugar de transferir el importe total de la transacción a una cuenta conectada, tu plataforma puede decidir tomar una parte del importe de la transacción en forma de comisiones. Puedes establecer el precio de las comisiones de dos maneras diferentes:

Utiliza la herramienta de tarifas de la plataforma para establecer y probar las reglas de comisiones de la plataforma. Esta función que no requiere programación del Dashboard de Stripe solo está disponible actualmente para plataformas responsables de pagar las comisiones de Stripe.
Establece tus reglas de tarifas internamente, especificando las comisiones directamente en un PaymentIntent utilizando el parámetro application_fee_amount o transfer_data[amount]. Las comisiones establecidas con este método anulan la lógica de tarifas especificada en la herramienta de tarifas de la plataforma.

Cuando se crean cargos 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.

Una vez cobrada la comisión de la aplicación, se crea un objeto Application Fee. Puedes ver una lista de las comisiones de la plataforma en el Dashboard, con las comisiones de la plataforma o en Sigma. También puedes usar la propiedad amount en el objeto Application Fee para elaborar informes detallados de comisiones.

Si usas un application_fee_amount, ten en cuenta que:

El application_fee_amount no puede superar el importe total de la transacción.
El application_fee_amount siempre se calcula en la misma moneda que la transacción.
La comisión de la plataforma se liquida en la moneda de cobro de la cuenta conectada. En el caso de los cargos a destino transfronterizos, esto podría diferir de la moneda de cobro de tu plataforma.
Tu plataforma paga la comisión de Stripe después de que se transfiere el application_fee_amount a tu cuenta.
No se aplican comisiones adicionales de Stripe al importe.
Tu plataforma puede usar la medición, notificación y verificación de comisiones de la plataforma incorporadas para conciliar las comisiones cobradas.
En los dashboards o componentes alojados en Stripe, como el componente Datos de pago, tu cuenta conectada puede ver tanto el importe total como el importe de la comisión de la plataforma.

Flujo de fondos

Con el código anterior, el importe total del cargo (USD 10.00) se agrega al saldo pendiente de la cuenta conectada. El application_fee_amount (USD 1.23) se deduce del importe del cargo y se transfiere a tu plataforma. Las comisiones de Stripe (USD 0.59) se deducen del saldo de la cuenta de tu plataforma. El importe de la comisión de la plataforma menos las comisiones de Stripe (USD 1.23 − USD 0.59 = USD 0.64) permanece en el saldo de la cuenta de tu plataforma.

El application_fee_amount estará a disposición de la cuenta de la plataforma conforme a su calendario habitual de transferencias, como si se tratara de fondos de cualquier otro cargo de Stripe.

Personaliza la imagen de marca

Tu plataforma utiliza la configuración de imagen de marca en el Dashboard para personalizar la marca en la página de pagos. Para los cargos a un Destino, Checkout utiliza la configuración de marca de la cuenta de la plataforma. Para los cargos a un destino con on_behalf_of, Checkout utiliza la configuración de imagen de marca de la cuenta conectada.

Las plataformas pueden configurar los ajustes de la imagen de marca de las cuentas conectadas con la API Actualizar cuenta:

icon: aparece junto al nombre de la empresa en el encabezado de la página de Checkout.
logo: se utiliza en lugar del ícono y el nombre de la empresa en el encabezado de la página de Checkout.
primary_color: se utiliza como color de fondo en la página de Checkout.
secondary_color: se utiliza como color del botón en la página de Checkout.

Especifica el comerciante a cargo del cobro

El comerciante a cargo del cobro depende de las funcionalidades activas en una cuenta y de cómo se crea el cargo. El comerciante a cargo del cobro determina de quién es la información utilizada para efectuar el cargo. Esto incluye la descripción del cargo (ya sea de la plataforma o de la cuenta conectada) que aparecerá para ese cargo en el extracto bancario o de tarjeta de crédito del cliente.

Si especificas el comerciante a cargo del cobro, puedes ser más explícito sobre quién es el destinatario del cargo. Por ejemplo, algunas plataformas prefieren ser el comerciante a cargo del cobro porque el usuario final interactúa directamente con ellas, como es el caso de las plataformas on-demand. No obstante, algunas plataformas tienen cuentas conectadas que interactúan directamente con los consumidores finales (por ejemplo, las tiendas físicas de una plataforma de e-commerce). En estos casos, es más lógico que el comerciante a cargo del cobro sea la cuenta conectada.

Puedes establecer el parámetro on_behalf_of en el ID de una cuenta conectada para que esa cuenta sea el comerciante a cargo del cobro. Cuando se usa on_behalf_of:

Los cargos se liquidan en el país y la moneda de cobro de la cuenta conectada.
Se utiliza la estructura de comisiones del país de la cuenta conectada.
La descripción del cargo en el extracto bancario de la cuenta conectada se muestra en el extracto de la tarjeta de crédito del cliente.
Si la cuenta conectada está en un país diferente al de la plataforma, la dirección y el número de teléfono de la cuenta conectada se muestran en el extracto de la tarjeta de crédito del cliente.
La cantidad de días durante la que se retiene el saldo pendiente antes de pagar depende de la configuración del delay_days en la cuenta conectada.

Si se omite on_behalf_of, la plataforma es la empresa registrada para el pago.

Precaución

El parámetro on_behalf_of solo se admite para cuentas conectadas con una funcionalidad de pagos como card_payments. Las cuentas regidas por el Contrato de servicios del destinatario no pueden solicitar card_payments u otras funcionalidades de pago.

Emitir reembolsos

Si usas la API Payment Intents, los reembolsos deben emitirse por el último cargo creado.

Los cargos creados en la cuenta de la plataforma se pueden rembolsar usando la clave secreta de la cuenta de la plataforma. Cuando se rembolsa un cargo con un transfer_data[destination], de manera predeterminada, la cuenta de destino conserva los fondos transferidos y deja que la cuenta de la plataforma cubra el saldo negativo del rembolso. Para retirar los fondos de la cuenta conectada para cubrir el rembolso, establece el parámetro reverse_transfer en true al crear el rembolso:

De forma predeterminada, se rembolsa el cargo total, pero puedes crear un rembolso parcial definiendo el valor de amount con un número entero positivo.

Si el rembolso implica que se devuelve el total del cargo, se revierte el total de la transferencia. De lo contrario, se revierte un importe proporcional de la transferencia.

Reembolsar comisiones de la plataforma

Cuando se reembolsa un cargo con una comisión de la plataforma, de manera predeterminada, la cuenta de la plataforma conserva los fondos de la comisión. Para volver a enviar los fondos de la comisión de la plataforma a la cuenta conectada, establece el parámetro refund_application_fee en true al crear el reembolso:

Ten en cuenta que si rembolsas la comisión de la aplicación para un cargo a un Destino, también debes revertir la transferencia. Si el rembolso implica que se devuelve el total del cargo, también se rembolsa el total de la comisión. De lo contrario, se rembolsa un importe proporcional de la comisión.

Como alternativa, puedes especificar un valor false para refund_application_fee y reembolsar la comisión de la plataforma por separado a través de la API.

Reembolsos fallidos

Si un reembolso falla, o lo cancelas, el monto del reembolso fallido regresa al saldo de Stripe de tu cuenta de plataforma. Crea un envío de fondos para transferir los fondos a la cuenta conectada, según sea necesario.

Gestionar disputas

En el caso de los cargos de destino, con o sin on_behalf_of, Stripe debita los montos de las disputas y las comisiones de tu cuenta de la plataforma.

Te recomendamos configurar un webhook para recibir notificaciones de los eventos creados por la disputa. Cuando eso sucede, puedes intentar recuperar los fondos de la cuenta conectada revirtiendo la transferencia a través del Dashboard o creando una revocación de transferencia.

Si la cuenta conectada tiene un saldo negativo, Stripe intenta debitar de su cuenta externa si debit_negative_balances se establece en true.

Si impugnas la disputa y esta se resuelve a tu favor, puedes volver a transferir los fondos que revertiste previamente a la cuenta conectada. Si tu plataforma tiene un saldo insuficiente, la transferencia falla. Para evitar errores por saldo insuficiente, agrega fondos a tu saldo de Stripe.

Errores habituales

La retransferencia de una revocación anterior está sujeta a restricciones de transferencia transfronteriza, lo que significa que es posible que no tengas medios para pagar tu cuenta conectada. Por el contrario, espera para recuperar transferencias de pagos transfronterizas disputadas por cargos a un destino con on_behalf_of hasta después de perder la disputa.