Establecer métodos de pago por suscripción

Aprende a especificar qué métodos de pago están disponibles para una suscripción.

El parámetro de suscripción payment_settings, te permite establecer métodos de pago específicos en suscripciones individuales. Esto permite más flexibilidad que un solo default_payment_method o una configuración de cliente menos granular.

Para habilitar métodos de pago, primero tienes que activarlos en la configuración de tu cuenta en el Dashboard de Stripe.

En algunos casos, puede haber restricciones que impiden usar ciertos métodos de pago para el pago de una suscripción. Por ejemplo, un método de pago puede operar solo en una determinada moneda o tener limitaciones en cuanto al importe del pago. Cuando hay limitaciones que impiden el uso de un método de pago, Stripe no lo selecciona automáticamente. Obtén más información sobre aceptación de métodos de pago.

Seleccionar métodos de pago manualmente

Puedes reemplazar los métodos de pago que se podrán utilizar para pagar una suscripción cambiando la propiedad payment settings.

Si configuraste un método de pago predeterminado en el objeto Customer o en el objeto Subscription, asegúrate de incluirlo en la lista de payment_method_types. De lo contrario, el método no se usará y el pago podría dar error.

Prioridad del método de pago

De forma predeterminada, los clientes pueden pagar la factura de una suscripción con cualquiera de los métodos de pago presentes en la configuración del método de pago predeterminada de Invoice. Esto tiene prioridad respecto de la configuración del cliente anterior default_source.

Si se configuran payment_settings.payment_method_types para una suscripción, tienen prioridad sobre la configuración de factura predeterminada, pero solo para esa suscripción. Los tipos de métodos de pago se especifican en el Setup Intent y las facturas de la suscripción.

Además, puedes especificar el default_payment_method de una suscripción, o la default_source anterior, para priorizar qué método de pago se intentará.

Si habilitas Guardar la información de pago del cliente en la configuración de facturas del Dashboard o el parámetro save_default_payment_method de la Subscription, cualquier método de pago que el cliente use para pagar la factura se convertirá en el nuevo método predeterminado.

Permitir que los clientes actualicen su método de pago

Desde el Dashboard, puedes generar enlaces de un solo uso que les permitan a los clientes actualizar el método de pago de una suscripción de factura automática.

Puedes generar un enlace de actualización desde dos lugares:

En la página Datos de la suscripción, haz clic en el menú Acciones y selecciona Compartir enlace de actualización de pago.
En la página Suscripciones, busca la suscripción y haz clic en su menú de contenido adicional () y, a continuación, selecciona Compartir enlace de actualización de pago.

En el cuadro de diálogo Compartir enlace de actualización de pago, puedes enviar el enlace por correo electrónico directamente al cliente o copiarlo para compartirlo de otra manera. También puedes desactivar todos los enlaces de actualización de pago existentes de la suscripción.

Puedes generar enlaces solo para las suscripciones que tienen la opción de Billing configurada como Auto. El ítem de menú no aparece para las suscripciones con Billing configurado en Send.

Los enlaces de actualización de pago de suscripciones tienen las siguientes restricciones:

Un enlace solo puede actualizar el método de pago en la suscripción asociada, y no puede cambiar el método de pago predeterminado del cliente.
El estado de la suscripción debe ser active, past_due o trialing. No puede estar unpaid ni finalizada.
El nuevo método de pago debe ser una tarjeta.
Cada enlace solo permite que un cliente actualice sus datos de pago una vez.
Si no se utiliza, el enlace caduca a los 30 días.

Errores del método de pago

Los errores del método de pago pueden hacer que la suscripción no se cree. Esto puede ocurrir si:

Seleccionas manualmente un método de pago, pero una restricción, como las monedas aceptadas, impide que lo uses.
No se ha activado un método de pago para tu cuenta

También pueden producirse errores en el momento del pago, y Stripe no puede finalizar la factura. Para obtener más información, consulta la página sobre errores en el método de pago en la facturación.

Opciones de métodos de pago

Algunos métodos de pago tienen opciones adicionales que puedes configurar para personalizar cómo paga el cliente. Para obtener más información, consulta la documentación sobre opciones de métodos de pago.