Crea cargos y envíos de fondos separados
Crea cargos en la cuenta de tu plataforma y transfiere fondos a varias cuentas conectadas.
Crea cargos y envíos de fondos separados para transferir fondos de un pago a varias cuentas conectadas, o cuando no se conozca a un usuario específico en el momento del pago. El cargo en la cuenta de tu plataforma se desasocia de las transferencias a tus cuentas conectadas. Con este tipo de cargo, puedes hacer lo siguiente:
- Creas un cargo en la cuenta de tu plataforma y también transfieres fondos a tus cuentas conectadas. El pago aparece como un cargo en tu cuenta y también hay transferencias a cuentas conectadas (por un importe determinado por ti), que se extraen del saldo de tu cuenta.
- Puedes transferir fondos a varias cuentas conectadas.
- Se debita del saldo de tu cuenta el costo de las comisiones, los reembolsos y los contracargos de Stripe.
Este tipo de cargo es óptimo para los marketplaces que tienen que dividir los pagos entre varias partes, por ejemplo DoorDash, que es una plataforma de entrega para restaurantes.
Stripe acepta cargos y transferencias separados en las siguientes regiones:
En la mayoría de los casos, tu plataforma y todas las cuentas conectadas deben ser de la misma región. Si intentas transferir fondos a través de una frontera no permitida, se producirá un error. Para obtener información sobre el soporte entre regiones, consulta transferencias transfronterizas. Debes usar los envíos de fondos únicamente en combinación con los casos de uso permitidos para cargos, recargas y comisiones. Recomendamos usar cargos y envíos de fondos separados 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_, 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.
Redirige a los clientes a una página de pagos alojada en Stripe con Stripe Checkout. Comprueba cómo esta integración se compara con los otros tipos de integración de Stripe.
Esfuerzo de integración
Tipo de integración
Redirigir a la página de pagos alojada en Stripe
Personalización de la interfaz de usuario
Primero, inscríbete para obtener una cuenta de Stripe.
Usa nuestras bibliotecas oficiales para acceder a la API de Stripe desde tu aplicación:
Crea una sesión de CheckoutLado del clienteLado 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, así como los métodos de pago aceptados. Agrega un botón de pago en tu sitio web que llame a un punto de conexión del lado del servidor para crear una sesión de Checkout.
<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 Checkout Session y redirige a tu cliente a la URL que se devuelve en la respuesta.
line_: este atributo representa los artículos que compra el cliente. Los artículos se muestran en la página de pago alojada por Stripe.items payment_: utiliza una cadena única comointent_ data[transfer_ group] transfer_para identificar objetos asociados entre sí. Cuando Stripe crea automáticamente un cargo para un PaymentIntent con un valorgroup transfer_, asigna el mismo valor algroup transfer_del cargo.group success_: Stripe redirige al cliente a la URL de confirmación después de que efectiviza un pago, y reemplaza la cadenaurl {CHECKOUT_con la ID de la Checkout Session. Úsala para recuperar la Checkout Session e inspeccionar el estado para decidir qué mostrarás a tu cliente. También puede adjuntar sus propios parámetros de consulta, que se mantendrán durante el proceso de redireccionamiento. Consulta Personaliza el comportamiento de redireccionamiento con una página alojada en Stripe para obtener más información.SESSION_ ID}
Gestionar eventos posteriores al pagoLado 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.
Crear un envío de fondosLado del servidor
En tu servidor, envía fondos desde tu cuenta a una cuenta conectada creando un envío de fondos y especificando el transfer_ utilizado.
Los importes de transferencia y cargo no tienen que coincidir. Puedes dividir un solo cargo entre varias transferencias o incluir varios cargos en una sola transferencia. En el siguiente ejemplo se crea una transferencia adicional asociada con el mismo transfer_.
Opciones de envíos de fondo
Puedes asignar cualquier valor a la cadena transfer_, pero debes representar una sola acción comercial. También puedes realizar una transferencia sin un cargo asociado ni un transfer_, por ejemplo, cuando debes pagar a un proveedor pero no hay un pago de cliente asociado.
Nota
El transfer_ solo identifica los objetos asociados. No afecta a ninguna funcionalidad estándar. Para evitar que se ejecute una transferencia antes de que estén disponibles los fondos del cargo asociado, usa el atributo source_ de la transferencia.
De forma predeterminada, una solicitud de envío de fondos falla cuando el monto excede el saldo disponible de la cuenta de la plataforma Stripe no reintenta automáticamente las solicitudes de envío de fondos fallidas.
Puedes evitar que se produzcan errores en las solicitudes de envío de fondos asociados a cargos. Cuando especificas el cargo asociado como source_transaction del envío de fondos, la solicitud de envío de fondos se efectúa automáticamente. Sin embargo, no ejecutamos dicho envío hasta que los fondos de ese cargo estén disponibles en la cuenta de la plataforma.
Nota
Si utilizas cargos y envíos de fondos separados, tenlo en cuenta al planificar tu calendario de transferencias. Las transferencias automáticas pueden interferir con las transferencias que no tienen una source_ definida.
Probar la integración
Consulta Pruebas para obtener información adicional para probar tu integración.
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_ en el ID de una cuenta conectada para que esa cuenta sea el comerciante a cargo del cobro. Cuando se usa on_:
- 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_, la plataforma es la empresa registrada para el pago.
Precaución
El parámetro on_ 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_ u otras funcionalidades de pago.
Cobra comisiones
Cuando se utilizan cargos y transferencias separados, la plataforma puede cobrar comisiones sobre un cargo al reducir la cantidad que transfiere a las cuentas de destino. Por ejemplo, considera una transacción de servicio de entrega a domicilio en un restaurante que implique pagos al restaurante y al socio de la App:
- El cliente paga un cargo de 100 USD.
- Stripe cobra una comisión de 3.20 USD y agrega los 96.80 USD restantes al saldo pendiente de la cuenta de la plataforma.
- La plataforma transfiere 70 USD a la cuenta conectada del restaurante y 20 USD a la cuenta conectada del conductor.
- Una comisión de plataforma de 6.80 USD permanece en la cuenta de la plataforma.
Para obtener información sobre cómo procesar pagos en múltiples monedas con Connect, consulta cómo trabajar con múltiples monedas.
Disponibilidad de los envíos de fondos
El comportamiento predeterminado es transferir fondos desde el saldo disponible de la cuenta de la plataforma. Si intentas transferir un monto que exceda el saldo disponible, falla y aparece un mensaje de error. Para evitar este problema, al crear una transferencia, vincula la partida a un cargo existente especificando el ID del cargo como parámetro source_. Con un source_, la solicitud de transferencia devuelve el saldo correcto independientemente de tu saldo disponible si el cargo relacionado aún no se ha acreditado. Sin embargo, los fondos no estarán disponibles en la cuenta de destino hasta que los fondos del cargo asociado estén disponibles para transferirlos desde la cuenta de la plataforma.
Nota
Si una transferencia falla debido a que el dinero en el saldo de tu plataforma no es suficiente, el hecho de agregar fondos no provocará automáticamente que se vuelva a intentar la acción fallida. Después de agregar fondos, debes repetir el envío o la transferencia que falló.
Si el cargo de origen tiene un valor transfer_, Stripe asigna el mismo valor al transfer_ de la transferencia. De no ser así, Stripe genera una cadena con el formato group_ más el ID del PaymentIntent asociado, por ejemplo: group_. Asigna esa cadena como el transfer_ tanto para el cargo como para la transferencia.
Nota
Debes especificar el source_ al crear un envío de fondos. No puedes actualizar ese atributo más adelante.
Puedes obtener la identificación del cargo del PaymentIntent:
- Obtén el atributo latest_charge del PaymentIntent. Este atributo es el ID del cargo más reciente asociado al PaymentIntent.
- Solicita una lista de cargos, donde se especifique el
payment_en la solicitud. Este método devuelve los datos completos de todos los cargos asociados con el PaymentIntent.intent
Cuando se usa este parámetro:
- El importe del envío de fondos no debe superar el importe del cargo de origen
- Puedes crear varios envíos de fondos con la misma
source_siempre que la suma de los envíos no supere el cargo de origentransaction - El envío de fondos asume el estado pendiente del cargo asociado, es decir, si los fondos del cargo están disponibles en N días, el pago recibido a través del envío de fondos por la cuenta de Stripe de destino también estará disponible en N días.
- Stripe crea automáticamente un
transfer_para tigroup - La moneda de la transacción de saldo asociada con el cargo debe coincidir con la moneda de la transferencia
Los métodos de pago asincrónicos, como ACH, pueden fallar después de realizar una solicitud de envío de fondos posterior. Para estos pagos, evita usar source_. En su lugar, espera a que se active un evento charge.succeeded antes de transferir los fondos. Si tienes que usar source_ con estos pagos, debes implementar una funcionalidad para gestionar los errores de pagos.
Cuando falla un pago utilizado como source_, se transfieren fondos del saldo de la cuenta de tu plataforma a la cuenta conectada para cubrir el pago. Para recuperar estos fondos, revierte la transferencia asociada con el source_ fallido.
Emite reembolsos
Puedes reembolsar cargos creados en tu plataforma usando su clave secreta. Sin embargo, el reembolso de un cargo no influye en ningún envío de fondos asociado. Tu plataforma es la que debe conciliar los importes adeudados reduciendo los importes de los envíos de fondos posteriores o revirtiendo los envíos de fondos.
Revertir envíos de fondos
Connect admite la posibilidad de revertir transferencias efectuadas a cuentas conectadas, ya sea en parte o en su totalidad (estableciendo un valor para amount). Usa las revocaciones de envíos de fondos solo para reembolsos o disputas relacionadas con el cargo, o para corregir errores en el envío de fondos.
Las revocaciones de envíos de fondos agregan el importe especificado (o el total) nuevamente al saldo de la plataforma, reduciendo el saldo disponible de la cuenta conectada según corresponda. Un envío de fondos se puede revertir solo si el saldo disponible de la cuenta conectada es mayor que el importe de la revocación o si tiene reservas conectadas habilitadas.
Si la revocación de la transferencia requiere una conversión de monedas y el monto revocado resultaría en un saldo de cero después de la conversión, se arrojará un error.
Deshabilitar los reembolsos de una cuenta conectada no bloqueará la capacidad de procesar anulaciones de transferencias.