Ir a contenido
Crea una cuenta
 o
Inicia sesión
Logotipo de Stripe Docs
/
Crear una cuenta
Iniciar sesión

Crear suscripciones con Stripe Billing

Con Connect, puedes crear suscripciones para tus clientes o para cuentas conectadas.

Las empresas de marketplace y Software como Servicio (SaaS) usan Stripe Connect para gestionar los pagos entre ellas, los clientes y las cuentas conectadas. Puedes usar Connect para gestionar pagos o transferencias, y Stripe Billing para respaldar tu modelo de ingresos recurrentes.

Casos de uso

Puedes crear suscripciones para cuentas conectadas, que admiten varios métodos para cobrar pagos. Puedes crear suscripciones para los clientes de tu cuenta conectada mediante cargos directos o a un destino, para que tus clientes finales realicen transacciones directamente con tu plataforma y cobren a tus cuentas conectadas una tarifa por usar tu plataforma.

Los siguientes casos de uso detallan cómo usar Stripe Billing para crear suscripciones de clientes finales a cuentas conectadas, además de cómo facturar a cada uno.

Caso de usoDescripción
Crea suscripciones desde clientes finales hasta cuentas conectadasCrea suscripciones para clientes finales a tus cuentas conectadas, lo que admite varios métodos para cobrar pagos. En este ejemplo, los Precios residen en la cuenta conectada.
Crear suscripciones para facturar a los clientes finales de una plataformaMarketplaces puede ofrecer directamente suscripciones de membresía sin involucrar tu cuenta conectada. En este ejemplo, los Precios residen en la plataforma.
Crea suscripciones para facturar a cuentas conectadasLas plataformas pueden crear suscripciones para sus cuentas conectadas. En este ejemplo, los Precios residen en la plataforma.

Restricciones

El uso de suscripciones con Connect tiene estas restricciones:

  • Tu plataforma no puede actualizar ni cancelar una suscripción no creada por ella.
  • Tu plataforma no puede agregar una application_fee_amount a una factura no creada por ella ni tampoco a una factura que contenga ítems de factura no creados por ella.
  • Only connected accounts with access to the full Stripe Dashboard can manage their customers’ subscriptions. For other connected accounts, the platform must manage their customers’ subscriptions.
  • Las suscripciones no se cancelan de forma automática cuando te desconectas de la plataforma; debes hacerlo manualmente. Puedes usar webhooks para controlar la actividad de las cuentas conectadas.

Crea suscripciones desde el cliente final a la cuenta conectada

Si estás diseñando una plataforma, puedes crear suscripciones para los clientes de tus cuentas conectadas. Tienes la opción de cobrar una comisión por cada pago en tu plataforma.

En este ejemplo, se diseña una plataforma de una editorial en línea que permite que los clientes se suscriban a sus autores favoritos y paguen una cuota mensual para recibir publicaciones de blogs exclusivas de cada autor.

Antes de comenzar

Antes de poder crear suscripciones para tus clientes o cuentas conectadas, debes hacer lo siguiente:

  1. Crea una cuenta conectada para cada persona que reciba dinero en tu plataforma. En nuestro ejemplo de publicación en línea, una cuenta conectada representa a un autor.
  2. Crear un modelo de precios. Para este ejemplo, creamos un de tarifa plana modelo de tarifas para cobrar a los clientes una tarifa de forma recurrente, pero también se admiten tarifas por usuario y por uso.
  3. Crea un cliente con el método de pago previsto por cada persona que se suscriba a una cuenta conectada. En nuestro ejemplo de la editorial en línea, puedes crear un cliente por cada lector que se suscriba a un autor.

Elige entre cargos Direct y cargos a un Destino

Para dividir el pago de un cliente entre la cuenta conectada y tu plataforma, puedes usar tanto cargos Direct como cargos a un Destino.

Con los cargos directos, los clientes no sabrán de la existencia de tu plataforma porque en la descripción de cargo en el extracto bancario no aparecerá el nombre de tu plataforma, sino el nombre del autor. En nuestro ejemplo de la editorial en línea, los lectores interactúan directamente con los autores.

Se recomiendan los cargos directos para las cuentas conectadas con acceso al Dashboard completo de Stripe, que incluye las cuentas Standard.

Si quieres que tu plataforma sea la responsable de las comisiones de Stripe, los rembolsos y los contracargos, usa cargos a un Destino. En nuestro ejemplo de la editorial en línea, los clientes se suscriben a tu plataforma de publicación, en lugar de a autores específicos.

Se recomiendan los cargos de destino para las cuentas conectadas con acceso al panel de Express o las cuentas conectadas sin acceso al Dashboard alojado en Stripe, que incluye las cuentas Express y Custom.

Para obtener más información sobre los diferentes tipos de cargos de Connect, consulta Tipos de cargos.

Usa cargos Direct para crear una suscripción

Para crear una suscripción con Cargos asociados a la cuenta conectada, crea una suscripción mientras estás autenticado como la cuenta conectada. Asegúrate de definir el cliente con un método de pago predeterminado y el Precio en la cuenta conectada. Para usar un cliente sin un método de pago predeterminado, establece payment_behavior: "default_incomplete". Más información sobre el comportamiento de pago.

Expande latest_invoice.confirmation_secret para incluir el Payment Element, que se necesita para confirmar el pago. Obtén más información sobre los Payment Elements.

Para ver un ejemplo de cómo implementar el flujo de creación de la suscripción y de pago, de principio a fin, en tu aplicación, consulta la guía de integración de suscripciones.

Command Line
curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d "items[0][price]"=
{{PRICE_ID}}
 \
  -d "expand[0]"="latest_invoice.confirmation_secret"

Usa cargos a un Destino para crear una suscripción

Para crear una suscripción con Cargos asociados a la plataforma y crear automáticamente transferencias a una cuenta conectada, haz una llamada para crear la suscripción y especifica el ID de la cuenta conectada como el transfer_data[destination] value.

Expande latest_invoice.confirmation_secret para incluir el Payment Element, que se necesita para confirmar el pago. Obtén más información sobre los Payment Elements.

Tienes la opción de especificar application_fee_percent. Obtén más información sobre cómo cobrar comisiones.

Command Line
curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d "items[0][price]"=
{{PRICE_ID}}
 \
  -d "expand[0]"="latest_invoice.confirmation_secret" \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Pasos adicionales antes de crear una suscripción

Para crear un cargo a un destino, define el cliente y el precio en la cuenta de la plataforma. Debes haber creado una cuenta conectada en la plataforma. El cliente debe existir dentro de la cuenta de plataforma. Cuando se utilizan cargos a un destino, la plataforma es el comerciante registrado.

Crea suscripciones para cobrar a los clientes finales de una plataforma

Puedes usar Stripe Billing para crear suscripciones con el fin de que tus clientes finales realicen transacciones directo con tu plataforma sin tener que involucrar a las cuentas conectadas.

En este ejemplo, se diseña un marketplace que permite que los clientes realicen pedidos a restaurantes. El marketplace les ofrece a los clientes una suscripción mensual prémium que no cobra comisiones de envío. Los clientes que se suscriben al plan prémium pagan directo en el marketplace y no se suscriben a ningún servicio de entregas ni restaurante en particular.

Antes de comenzar

Antes de crear suscripciones para tus clientes, debes hacer lo siguiente:

  1. Crear un modelo de precios. Para este ejemplo, creamos un de tarifa plana modelo de tarifas para cobrar a los clientes una tarifa de forma recurrente, pero también se admiten tarifas por usuario y por uso.
  2. Crea un registro de cliente para cada cliente que quieras facturar.

También puedes crear una cuenta conectada para cada usuario que reciba dinero de tu plataforma. En nuestro ejemplo de entrega a domicilio por pedido, una cuenta conectada es un restaurante o un servicio de entrega. Sin embargo, este paso no es necesario para que los clientes se suscriban directamente a tu plataforma.

Crear una suscripción

Para crear una suscripción en la que tu plataforma reciba los fondos, sin que el dinero vaya a las cuentas conectadas, sigue la guía de suscripciones y crea una suscripción con Stripe Billing.

Crear cargos y envíos de fondos separados

Si luego quieres transferir manualmente una parte de los fondos que recibe tu plataforma a tus cuentas conectadas, usa cargos y envíos de fondos separados para transferir fondos a una cuenta conectada (o más). En nuestro ejemplo de entregas de restaurante por pedido, puedes usar cargos y envíos de fondo separados para transferir una comisión de afiliado a un repartidor o a un restaurante que refiere al cliente a suscribirse al servicio de entregas prémium.

Crea suscripciones para cobrar a las cuentas conectadas

Puedes usar Stripe Billing para crear suscripciones con el fin de cobrarles a tus cuentas conectadas una comisión por usar tu plataforma.

En este ejemplo, se diseña una plataforma de software de gestión de gimnasios que permite que estos establecimientos paguen una cuota mensual por el uso del programa, que les permite gestionar la programación y asignación de las clases. La cuota de la suscripción la paga la empresa (en este caso, el gimnasio), no los clientes.

El software de gestión de gimnasios también facilita los pagos únicos del cliente al gimnasio por cada clase en la que se anota. La suscripción mensual se da entre la cuenta conectada y la plataforma, por lo que el cliente no está involucrado en la transacción.

En el diagrama anterior, el gimnasio es la cuenta conectada y la persona que va al gimnasio es el cliente final.

Antes de comenzar

Antes de crear suscripciones para tus clientes o cuentas conectadas, debes hacer lo siguiente:

  1. Crea una cuenta conectada para cada usuario que reciba dinero en tu plataforma. En este ejemplo, la cuenta conectada es la empresa de gimnasios.
  2. Crear un modelo de precios. Para este ejemplo, creamos un de tarifa plana modelo de tarifas para cobrar a los clientes una tarifa de forma recurrente, pero también se admiten tarifas por usuario y por uso.
  3. Crea un cliente en la plataforma con el método de pago previsto para cada cuenta conectada que quieras facturar. En el ejemplo del software de gestión de gimnasios, creas un cliente para cada empresa de gimnasios:

Crear un objeto Customer que represente la cuenta conectada

Si tus cuentas conectadas usan Stripe para procesar pagos para sus clientes finales, es posible que ya hayan creado un objeto Customer para cada cliente final.

Para crear correctamente una suscripción para la cuenta conectada con el fin de pagar una comisión recurrente a la plataforma, debes crear un objeto Customer distinto que represente la cuenta conectada.

En el ejemplo del gimnasio, la empresa usa Stripe para procesar pagos únicos de los clientes. Ya se creó un objeto Customer para cada cliente, pero necesitas uno nuevo que represente al gimnasio. Crea un solo objeto Customer para representar a cada entidad comercial; no crees objetos para cada propietario, gerente u operador de la empresa.

Crear una suscripción para la cuenta conectada

Para crear una suscripción en la que tu plataforma reciba los fondos de tus cuentas conectadas, sigue la guía de suscripciones y crea una suscripción con Stripe Billing. El objeto Customer involucrado en la transacción representa la cuenta conectada, no el cliente final. En nuestro ejemplo del gimnasio, el CUSTOMER_ID representa a la empresa de gimnasios, no al cliente.

Habilita la integración para recibir notificaciones de eventos

Stripe crea notificaciones de eventos cuando se producen cambios en tu cuenta, por ejemplo, cuando un pago recurrente se realiza correctamente o cuando falla una transferencia. Para recibir estas notificaciones y usarlas a fin de automatizar tu integración, configura un punto de conexión de webhook. Por ejemplo, puedes dar acceso a tu servicio cuando recibas el evento invoice.paid.

Notificaciones de eventos para integraciones de Connect y suscripciones

Estas son las notificaciones de eventos que suelen usar las integraciones de Connect.

Eventotipo data.objectDescripción
account.application.deauthorizedapplicationOcurre cuando una cuenta conectada se desconecta de tu plataforma. Puedes usarlo para activar la limpieza en tu servidor. Disponible para cuentas conectadas con acceso al Dashboard de Stripe, que incluye cuentas Standard.
account.external_account.updatedAUna cuenta externa, como card o bank_accountTiene lugar cuando se actualiza una cuenta bancaria o tarjeta de débito asociada a una cuenta conectada, lo que puede influir en las transferencias a cuentas bancarias. Disponible para las cuentas conectadas que tu plataforma controla, que incluye cuentas Custom y Express, y cuentas Standard con controles de plataforma habilitados.
account.updatedaccountTe permite monitorear los cambios en los requisitos de la cuenta conectada y los cambios de estado. Disponible para todas las cuentas conectadas.
balance.availablebalanceOcurre cuando se actualiza tu saldo de Stripe. Por ejemplo, cuando los fondos que agregaste desde tu cuenta bancaria estén disponibles para transferir a tu cuenta conectada.
payment_intent.succeededpayment_intentTiene lugar cuando un intento de pago se convierte en un cargo efectuado correctamente. Disponible para todos los pagos, incluidos los cargos a un destino y Direct.
payout.failedpayoutTiene lugar cuando falla una transferencia. Cuando una transferencia falla, se deshabilita la cuenta externa involucrada y no se pueden procesar transferencias automáticas ni manuales hasta que no se actualiza la cuenta externa.
person.updatedpersonOcurre cuando se actualiza una Person asociada con Account. Si usas la API Persons para gestionar los requisitos, recibe notificaciones de este evento para monitorear los cambios en los requisitos y los cambios de estado para particulares. Disponible para las cuentas conectadas que tu plataforma controla, que incluye cuentas Custom y Express, y cuentas Standard con controles de plataforma habilitados.

Estas son las notificaciones de eventos que suelen usar las integraciones de suscripciones.

customer.createdSe envía cuando se crea correctamente un objeto Customer.
customer.subscription.createdSe envía cuando se crea la suscripción. El status de la suscripción puede ser incomplete si se exige la autenticación del cliente para completar el pago o si estableces payment_behavior en default_incomplete. Consulta el comportamiento del pago de la suscripción para obtener más información.
customer.subscription.deletedSe envía cuando se termina la suscripción de un cliente.
customer.subscription.pausedSe envía cuando el status de una suscripción cambia a paused. Por ejemplo, se envía cuando una suscripción está configurada para pausarse cuando una prueba gratuita finaliza sin un método de pago. La facturación no se producirá hasta que se reanude la suscripción. No enviamos este evento si el cobro del pago está pausado porque las facturas se siguen creando durante ese período.
customer.subscription.resumedSe envía cuando se reanuda una suscripción que anteriormente estaba en estado paused. Esto no se aplica cuando el cobro del pago no está en pausa.
customer.subscription.trial_will_endSe envía tres días antes de que finalice el período de prueba. Si el periodo de prueba es menor de tres días, este evento se activa.
customer.subscription.updatedSe envía cuando se inicia o cambia una suscripción. Por ejemplo, este evento se activa cuando se renueva una suscripción, se agrega un cupón, se aplica un descuento, se agrega una partida de factura o se cambia de plan.
entitlements.active_entitlement_summary.updatedSe envía cuando se actualizan los derechos activos de un cliente. Cuando recibas este evento, puedes proporcionar o anular el acceso a las funciones de tu producto. Lee más sobre integración con derechos.
invoice.createdSe envía cuando se crea una factura para una suscripción renovada o una nueva. Si Stripe no recibe una respuesta correcta al evento invoice.created, la finalización de todas las facturas con cobro automático se retrasará hasta 72 horas. Obtén más información sobre cómo finalizar facturas.
invoice.finalizedSe envía cuando una factura se finaliza correctamente y está lista para pagarse.
invoice.finalization_failedNo se pudo finalizar la factura. Lee la guía y aprende a gestionar los fallos de finalización de facturas. Obtén más información sobre la finalización de facturas en la guía resumida sobre facturas.
  • Inspecciona el last_finalization_error del objeto Invoice para determinar la causa del error.
  • Si usas Stripe Tax, revisa el campo automatic_tax del objeto Invoice.
  • Si automatic_tax[status]=requires_location_inputs, la factura no puede finalizarse y los pagos no se pueden cobrar. Notifica al cliente y recopila la ubicación del cliente requerida.
  • Si automatic_tax[status]=failed, reintenta la solicitud más tarde.
invoice.paidSe envía cuando la factura se paga correctamente. Puedes brindar acceso a tu producto cuando recibas este evento y el status de la suscripción sea active.
invoice.payment_action_requiredSe envía cuando la factura requiere la autenticación del cliente. Aprende a gestionar la suscripción cuando la factura requiere intervención.

invoice.payment_failed

Falló el pago de una factura. El estado del PaymentIntent cambia a requires_action, mientras que el de la suscripción sigue siendo incomplete solo en la primera factura. Si falla un pago, puedes tomar varias medidas:

invoice.upcomingSe envía unos días antes de la renovación de la suscripción. La cantidad de días se basa en el número establecido en Próximos eventos de renovación en el Dashboard. Para las suscripciones existentes, el cambio del número de días entrará en vigencia en el siguiente período de facturación. De ser necesario, aún puedes agregar más partidas de factura.
invoice.updatedSe envía tanto cuando un pago falla como cuando se efectúa correctamente. Si sucede esto último, el atributo paid se establece en true y el status será paid. Si el pago falla, paid se establece en false y el status permanecerá open. Los pagos fallidos también activan el evento invoice.payment_failed.
payment_intent.createdSe envía cuando se crea una PaymentIntent.
payment_intent.succeededSe envía cuando un PaymentIntent ha completado correctamente un pago.
subscription_schedule.abortedSe envía cuando se cancela un calendario de suscripciones porque el retraso en el pago canceló la suscripción relacionada.
subscription_schedule.canceledSe envía cuando se cancela un calendario de suscripciones, lo que también cancela las suscripciones asociadas activas.
subscription_schedule.completedSe envía cuando se completan todas las fases de un calendario de suscripciones.
subscription_schedule.createdSe envía cuando se crea un nuevo calendario de suscripciones.
subscription_schedule.expiringSe envía siete días antes de que expire el calendario de suscripción.
subscription_schedule.releasedSe envía cuando se lanza un calendario de suscripción, o cuando se pausa y desvincula dicho calendario de la suscripción. La suscripción permanece.
subscription_schedule.updatedSe envía cuando se actualiza un calendario de suscripciones.

Prueba la integración

Después de crear tu suscripción, prueba exhaustivamente tu integración antes de exponerla a los clientes o usarla para cualquier actividad en vivo. Obtén más información sobre cómo probar Stripe Billing.

Opciones adicionales

Después de crear tu suscripción, puedes especificar un application_fee_percent, configurar el portal de clientes, cobrarle a tu cliente usando el parámetro on_behalf_of y monitorear las suscripciones con webhooks, además de otras opciones.

Cobrar comisiones sobre suscripciones

Usar cupones

Usar períodos de prueba

Configurar el portal de clientes

Controlar las suscripciones con webhooks

Determinar que la cuenta conectada sea el comerciante a cargo del cobro con on_behalf_of

Conoce el comportamiento de desconexión

Integra el cálculo y cobro de impuestos

Consulta también

¿Te fue útil esta página?
SíNo
¿Necesitas ayuda? Ponte en contacto con soporte.
Únete a nuestro programa de acceso anticipado.
Echa un vistazo a nuestro registro de cambios.
¿Tienes alguna pregunta? Contacto.
¿LLM? Lee llms.txt.
Con tecnología de Markdoc