API Setup Intents
Usa la API Setup Intents para configurar un método de pago para futuros pagos. Es parecido a un pago, pero no se crea ningún cargo. Configura un método de pago para pagos futuros ahora.
El objetivo es guardar y optimizar las credenciales de pago para pagos futuros, es decir, tener el método de pago configurado correctamente para todas las situaciones. Por ejemplo, al configurar una tarjeta, puede ser necesario autenticar al cliente o verificar la validez de la tarjeta con el banco del cliente. Stripe actualiza el objeto SetupIntent
durante todo ese proceso.
Cómo guardar y reutilizar métodos de pago
La API Setup Intents es útil para las empresas que hacen el onboarding de los clientes sin cobrarles de inmediato:
- Una empresa de alquiler de coches que guarda datos de los métodos de pago antes de que el cliente alquile el coche y le cobra en la tarjeta una vez terminado el período del alquiler.
- Un sitio web de micromecenazgo que recopila los datos de las tarjetas para cobrarle al usuario después, solamente si la campaña llega a un determinado importe
- Una empresa de servicios públicos que cobra diferentes importes todos los meses según el consumo, pero que guarda datos de pago SEPA antes del pago del primer mes.
Nota
También puedes configurar los métodos de pago para su uso en el futuro en Checkout.
Empezar
- Guarda tarjetas sin que se haga un pago inicial
- Guardar los datos bancarios para los pagos con adeudo directo SEPA
- Guarda los datos bancarios para pagos con adeudo directo BECS
Cómo obtener permiso para guardar un método de pago
Cumplimiento de la normativa
Al guardar los datos de pago de un cliente, eres responsable de cumplir con todas las leyes, normativas y reglas de red aplicables. Si configuras un método de pago para futuros pagos durante la sesión, como mostrar el método de pago en una página del proceso de compra futura, asegúrate de obtener el consentimiento explícito del cliente para este uso específico. Por ejemplo, incluye una casilla de verificación “Guardar mi método de pago para usarlo en el futuro” para obtener el consentimiento. Si necesitas diferenciar entre los métodos de pago guardados solo para los usos sin conexión y los métodos de pago que puedes presentar a tu cliente para futuras compras durante la sesión, puedes utilizar el parámetro allow_redisplay en el objeto PaymentMethod.
Si configuras un método de pago para pagos futuros fuera de la sesión, necesitas autorización. Crear un acuerdo (a veces denominado mandate) por adelantado te permite hacer el cobro sin que el cliente esté utilizando activamente tu sitio web o aplicación.
En tu sitio web, agrega condiciones que indiquen cómo prevés procesar los pagos y deja que tus clientes elijan. Como mínimo, cerciórate de que las condiciones cubran los siguientes puntos:
- El permiso del cliente para que puedas iniciar un pago o una serie de pagos en su nombre
- La frecuencia prevista de los pagos (es decir, únicos o recurrentes)
- Cómo se determinará el importe a pagar
Consulta el texto de mandato recomendado para guardar tarjetas o guardar datos bancarios SEPA.
Para clientes afectados por la autenticación reforzada de clientes (SCA), este acuerdo ayuda a que los pagos se efectúen sin interrupciones. Cuando configuras tu integración para guardar una tarjeta correctamente, Stripe marca los pagos sucesivos efectuados fuera de la sesión como transaccones iniciadas por el comerciante (MIT) para que el cliente no tenga que volver a conectarse para la autenticación. Las transacciones iniciadas por el comerciante exigen que exista un acuerdo entre tú y el cliente.
Cómo mejorar la tasa de éxito especificando el uso
El parámetro consumo le indica a Stripe cómo prevés utilizar los datos del método de pago posteriormente. Para algunos métodos de pago, Stripe puede usar tus ajustes de usage
para elegir el flujo con menos fricciones para el cliente. Esta optimización se ha diseñado para aumentar la cantidad de pagos efectuados con éxito.
Por ejemplo, el uso de tarjetas de crédito y débito sujetas a la normativa europea de autenticación reforzada de clientes (SCA) puede implicar que el cliente deba autenticar la tarjeta durante el proceso de guardado. Si se establece usage
en off_session
, es posible autenticar una tarjeta de crédito o débito por pagos fuera de la sesión sin que el cliente deba volver a conectarse para reautenticarla. A pesar de que genera una fricción inicial durante el flujo de configuración, establecer usage
en off_session
sirve para reducir la intervención del cliente en los pagos efectuados con posterioridad fuera de la sesión.
Sin embargo, si prevés que solo utilizarás la tarjeta cuando el cliente esté en la página de pago, establece usage
en on_session
, lo que le permite saber al banco que planeas usar la tarjeta cuando el cliente esté disponible para autenticarla, con lo cual puedes posponer la autenticación de los datos de la tarjeta hasta ese momento y evitar fricciones en el comienzo.
Cómo quieres usar la tarjeta | valor de enumeración de consumo para utilizar |
---|---|
Pagos durante la sesión solamente | on_session |
Pagos fuera de la sesión solamente | off_session (predeterminado) |
Pagos durante la sesión y fuera de la sesión | off_session (predeterminado) |
Ten en cuenta que usage
es una optimización. Sigues teniendo la posibilidad de usar la configuración de la tarjeta de pagos durante la sesión para efectuar pagos fuera de la sesión, pero es más probable que el banco rechace el pago efectuado fuera de la sesión y exija que el cliente autentique la tarjeta. En cualquier caso, se requerirá una autenticación posterior, por lo que debes diseñar un proceso de recuperación en tu aplicación. Cuando un pago de tarjeta fuera de la sesión requiera autenticación, solicítale al cliente que vuelva a conectarse para efectivizar el pago.
Si no se especifica, el valor predeterminado de usage
es off_session
. Consulta cómo crear un SetupIntent en tu servidor y cómo especificar usage
:
Nota
Sigue la guía de esta página para asegurarte de que tu integración pueda gestionar tarjetas que necesitan la autenticación reforzada de clientes (SCA). Marcar correctamente las transacciones le permite a Stripe hacer reclamaciones por exenciones a la SCA exactas en tu nombre a fin de minimizar la necesidad de autenticación en cada pago.