# API Setup Intents

Obtén más información sobre el uso de la API Setup Intents para guardar métodos de pago.

Usa la *Setup Intents API* (The Setup Intents API lets you build dynamic flows for collecting payment method details for future payments. It tracks the lifecycle of a payment setup flow and can trigger additional authentication steps if required by law or by the payment method) para configurar un método de pago para futuros pagos. Funciona como un pago, pero sin crear un cargo. [Configura un método de pago para futuros pagos ahora](https://docs.stripe.com/payments/save-and-reuse.md).

El objetivo es guardar y optimizar las credenciales de pago para pagos futuros, es decir, tener el método de pago configurado correctamente para todos los escenarios. Por ejemplo, al configurar una tarjeta, puede ser necesario autenticar al cliente o verificar la validez de la tarjeta ante el banco del cliente. Stripe actualiza el objeto `SetupIntent` a lo largo de ese proceso.

## Cómo guardar y reutilizar métodos de pago

La API Setup Intents es útil para las empresas que integran a los clientes sin cobrarles de inmediato:

- Una empresa de alquiler de autos que recopila los datos de los métodos de pago antes de que el cliente alquile el auto y efectúa el cargo a la tarjeta cuando finaliza el período de alquiler.
- Un sitio web de crowdfunding que recopila los datos de la tarjeta para cobrarle al usuario después, solamente si la campaña llega a una determinada suma
- Una empresa de servicios públicos que cobra diferentes importes todos los meses según el consumo, pero que recopila datos de pago SEPA antes del pago del primer mes.

> También puedes configurar métodos de pago para usarlos en el futuro cuando realices el cobro durante el [proceso de compra](https://docs.stripe.com/payments/save-and-reuse.md?platform=checkout).

#### Empezar

- [Guarda tarjetas sin realizar un pago inicial](https://docs.stripe.com/payments/save-and-reuse.md)
- [Guarda los datos bancarios para los pagos con débito directo SEPA](https://docs.stripe.com/payments/sepa-debit/set-up-payment.md)
- [Guarda los datos bancarios para pagos con débito directo BECS](https://docs.stripe.com/payments/au-becs-debit/set-up-payment.md)

## Obtén permiso para guardar un método de pago

Eres responsable del cumplimiento de todas las leyes, normativas y reglas de red aplicables al guardar los datos de pago de un cliente.

### Uso futuro durante la sesión

Si configuras un método de pago para futuros pagos *durante la sesión* (A payment is described as on-session if it occurs while the customer is actively in your checkout flow and able to authenticate the payment method), como mostrar el método de pago en una página de proceso de compra futura, debes obtener explícitamente el consentimiento del cliente para este uso específico. Por ejemplo, incluye una casilla de verificación «Guardar mi método de pago para uso futuro» para obtener dicho consentimiento.

Si necesitas diferenciar entre métodos de pago guardados solo para usos fuera de línea y métodos de pago que puedes presentar a tu cliente para futuras compras *durante la sesión* (A payment is described as on-session if it occurs while the customer is actively in your checkout flow and able to authenticate the payment method), puedes utilizar el parámetro [allow_redisplay](https://docs.stripe.com/api/payment_methods/object.md#payment_method_object-allow_redisplay) en el objeto PaymentMethod.

### Uso futuro fuera de la sesión

Si configuras un método de pago para efectuar pagos futuros *fuera de la sesión* (A payment is described as off-session if it occurs without the direct involvement of the customer, using previously-collected payment information), necesitas autorización. Si dispones de un acuerdo (a veces denominado *mandato*) por adelantado, podrás hacer el cobro sin que el cliente esté utilizando activamente tu sitio web o aplicación.

Agrega condiciones a tu sitio web o aplicación que indiquen cómo pretendes 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 recomendado para la orden de [guardar tarjetas](https://docs.stripe.com/payments/save-and-reuse.md?platform=web&ui=elements#collect-payment-details) o [guardar datos bancarios con SEPA](https://docs.stripe.com/payments/sepa-debit/set-up-payment.md).

En el caso de los clientes afectados por la *Autenticación reforzada de clientes (SCA)* (Strong Customer Authentication (SCA) is a regulatory requirement in effect as of September 14, 2019, that impacts many European online payments. It requires customers to use two-factor authentication like 3D Secure to verify their purchase), 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 *transacciones iniciadas por el comerciante* (A payment made off-session with a properly authenticated saved card, can qualify as merchant-initiated transaction and be exempt from SCA) (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.

## Especifica el uso para aumentar la tasa de éxito

El parámetro [usage](https://docs.stripe.com/api/setup_intents/object.md#setup_intent_object-usage) 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 el parámetro `usage` para elegir el flujo con menos inconvenientes para el cliente. Esta optimización se diseñó 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)* (Strong Customer Authentication (SCA) is a regulatory requirement in effect as of September 14, 2019, that impacts many European online payments. It requires customers to use two-factor authentication like 3D Secure to verify their purchase) 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 autenticarla nuevamente. 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 futuros que efectúe 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`. Esto 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 pretendes usar la tarjeta                                                                                                                                                           | valor de enumeración de usage para usar |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
| Pagos *durante la sesión* (A payment is described as on-session if it occurs while the customer is actively in your checkout flow and able to authenticate the payment method) solamente | `on_session`                            |
| Pagos *fuera de la sesión* (A payment is described as off-session if it occurs without the direct involvement of the customer, using previously-collected payment information) solamente | `off_session` (predeterminado)          |
| Pagos durante la sesión y fuera de la sesión                                                                                                                                             | `off_session` (predeterminado)          |

`Usage` es una optimización. Se puede usar una tarjeta configurada para pagos durante la sesión para efectuar pagos fuera de la sesión, pero es más probable que los bancos rechacen el pago fuera de la sesión y soliciten la autenticación al cliente. En cualquier caso, es posible que aún se requiera una autenticación posterior, por lo que debes [diseñar un proceso de recuperación](https://docs.stripe.com/billing/revenue-recovery.md) en la app. Cuando un pago con tarjeta fuera de la sesión requiera autenticación, solicítale al cliente que vuelva a conectarse para completar 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 el valor de `usage`:

```curl
curl https://api.stripe.com/v1/setup_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d usage=on_session
```

> 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* (Strong Customer Authentication (SCA) is a regulatory requirement in effect as of September 14, 2019, that impacts many European online payments. It requires customers to use two-factor authentication like 3D Secure to verify their purchase). Marcar correctamente las transacciones le permite a Stripe hacer reclamos por exenciones a la SCA en tu nombre a fin de minimizar la necesidad de autenticación en cada pago.