Establecer métodos de pago por 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.

curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_settings[payment_method_types][]"=card \
  -d "payment_settings[payment_method_types][]"=customer_balance

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.

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.