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.
Con ciertas excepciones, si tu plataforma y una cuenta conectada no están en la misma región, debes especificar la cuenta conectada como el comerciante a cargo del cobro utilizando el parámetro on_behalf_of en el Payment Intent.
Vista previa privada
La capacidad de usar cargos a un destino entre regiones sin el parámetro on_
se encuentra en versión preliminar privada para los siguientes escenarios:
- Tu plataforma se encuentra en el Reino Unido o la UE, y tu cuenta conectada está en los EE. UU.
- Tu plataforma se encuentra en los EE. UU. y tu cuenta conectada está en el Reino Unido o la UE.
Para solicitar acceso, comunícate con nosotros.
Recomendamos usar cargos a un destino para las cuentas conectadas que no tienen acceso al Dashboard completo de Stripe.

Integra la interfaz de usuario de pago prediseñada de Stripe a la confirmación de compra de tu aplicación Android con la clase PaymentSheet.
Configura StripeLado del servidorLado del cliente
Primero, necesitas una cuenta de Stripe. Inscríbete ahora.
Lado del servidor
Esta integración necesita puntos de conexión en tu servidor que se comuniquen con la API de Stripe. Usa las bibliotecas oficiales para acceder a la API de Stripe desde tu servidor:
Lado del cliente
El SDK para Android de Stripe es de código abierto y está completamente documentado.
Para instalar el SDK, agrega stripe-android
al bloque dependencies
de tu archivo app/build.gradle:
Nota
Para conocer detalles de la última versión y de versiones anteriores del SDK, consulta la página Versiones en GitHub. Para recibir una notificación cuando se publique una nueva versión, mira las versiones del repositorio.
Configura el SDK con tu clave publicable de Stripe para que pueda hacer solicitudes a la API de Stripe, así como en tu subclase Application
:
Nota
Usa las claves de prueba durante las pruebas y el desarrollo, y tus claves para modo activo cuando publiques tu aplicación.
Agregar un punto de conexiónLado del servidor
Nota
Para mostrar la PaymentSheet antes de crear un PaymentIntent, consulta Recopila datos de pago antes de crear un Intent.
Esta integración usa tres objetos de la API de Stripe:
PaymentIntent: Stripe lo utiliza para representar tu intención de cobrarle a un cliente, haciendo el seguimiento de los intentos de cobro y de los cambios en el estado del pago a lo largo del proceso.
(Opcional) Cliente: Para configurar un método de pago para pagos futuros, debes adjuntarlo a un Cliente. Crea el “Customer Object” cuando tu cliente cree una cuenta en tu empresa. Si tu cliente hace un pago como invitado, puedes crear un “Customer Object” antes del pago y asociarlo con tu propia representación interna de la cuenta del cliente más adelante.
(Opcional) Clave efímera del cliente: la información que contiene el Customer Object es confidencial y no se puede recuperar directamente desde una aplicación. Una clave efímera le otorga al SDK acceso temporal al cliente.
Nota
Si nunca guardas tarjetas en el objeto Customer y no permites que los clientes frecuentes vuelvan a usar tarjetas guardadas, puedes omitir los objetos Customer y Customer Ephemeral Key en tu integración.
Por motivos de seguridad, tu aplicación no puede crear estos objetos. En su lugar, agrega un punto de conexión en tu servidor que haga lo siguiente:
- Recupere el objeto Customer o cree uno nuevo.
- Cree una Ephemeral Key para el objeto Customer.
- Crea una PaymentIntent con el importe, la moneda y el cliente. También puedes incluir opcionalmente el parámetro
automatic_
. Stripe habilita su funcionalidad de forma predeterminada en la última versión de la API.payment_ methods - Devuelve a tu aplicación el secreto de cliente del Payment Intent, el
secret
de la clave efímera, la ID del cliente y tu clave publicable.
Los métodos de pago que se muestran a los clientes durante el proceso de compra también se incluyen en el PaymentIntent. Puedes permitir que Stripe extraiga los métodos de pago de tu configuración del Dashboard o puedes enumerarlos manualmente. Independientemente de la opción que elijas, debes saber que la moneda especificada en el PaymentIntent filtra los métodos de pago que se muestran al cliente. Por ejemplo, si especificas eur
en el PaymentIntent y tienes habilitado OXXO en el Dashboard, OXXO no se mostrará al cliente porque OXXO no admite pagos en eur
.
A menos que tu integración requiera una opción basada en código para ofrecer métodos de pago, Stripe recomienda usar la opción automatizada. Esto se debe a que Stripe evalúa la moneda, las restricciones de los métodos de pago y otros parámetros para determinar la lista de métodos de pago admitidos. Se les da prioridad a los métodos de pago que aumentan la conversión y guardan mayor relación con la moneda y la ubicación del cliente.
Integrar la hoja de pagoLado del cliente
Antes de mostrar el Payment Element móvil, tu página de finalización de compra debe cumplir con los siguientes requisitos:
- Mostrar los productos de la compra y el importe total
- Recopilar cualquier dato de envío requerido usando el Address Element
- Incluye un botón de confirmación de compra para presentar la interfaz de usuario de Stripe
Establecer allowsDelayedPaymentMethods
en true permite aceptar métodos de pago de notificación diferida como cuentas bancarias en EE. UU. Para estos métodos de pago, el estado final del pago no se conoce cuando se completa el PaymentSheet
, sino que se efectúa con éxito o falla más tarde. Si aceptas este tipo de métodos de pago, infórmale al cliente que su pedido está confirmado y solo finalízalo (por ejemplo, envía el producto) cuando el pago se realice correctamente.
Administrar eventos posteriores al pagoLado del servidor
Stripe envía un evento payment_intent.succeeded cuando se completa el pago. Usa la herramienta de webhook del Dashboard o sigue la guía de webhooks para recibir estos eventos y ejecutar acciones como, por ejemplo, enviar un correo electrónico de confirmación del pedido a tu cliente, registrar la venta en una base de datos o iniciar un flujo de 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, y clientes malintencionados podrían manipular la respuesta. Si configuras tu integración para escuchar eventos asincrónicos, podrás aceptar diferentes tipos de métodos de pago con una sola integración.
Además de administrar el evento payment_
, recomendamos administrar estos otros eventos si se cobran pagos con el Payment Element:
Evento | Descripción | Acción |
---|---|---|
payment_intent.succeeded | Se envía cuando un cliente completa correctamente un pago. | Envía al cliente una confirmación del pedido y completa el pedido. |
payment_intent.processing | Se envía cuando un cliente inicia con éxito un pago, pero éste aún no se completó. Este evento se envía normalmente cuando el cliente inicia un débito bancario. Le sigue un evento payment_ o payment_ en el futuro. | Envía al cliente una confirmación del pedido que indique que el pago está pendiente. En caso de productos digitales, quizá te convenga completar el pedido antes de esperar que se complete el pago. |
payment_intent.payment_failed | Enviado cuando un cliente intenta un pago, pero el pago falla. | Si un pago pasa de processing a payment_ , ofrécele al cliente otro intento de pago. |
Probar la integración
Consulta Pruebas para obtener información adicional para probar tu integración.
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.
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.
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_
, 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_
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_
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_
, 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_
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_
hasta después de perder la disputa.