> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Buy Now Pay Later (Solo Chile)

> >-

Puedes aceptar el método Buy Now Pay Later (pagos en cuotas sin tarjeta de crédito) de clientes en Chile usando la API de Checkout Session. Los clientes tendrán la opción de pagar en cuotas suscribiéndose al cobro automático en su banco de cada cuota relacionada con el pago.

Nuestro producto Buy Now Pay Later es en alianza con [Banca.me](https://www.banca.me/).

## Crea un pago Buy Now Pay Later

Usando tu Secret Key, crea un `Checkout Session` en tu servidor con un `amount`, `currency` (solo CLP para pagos en cuotas), `success_url`, `cancel_url` y `payment_methods: ["instalments_payment"]`:

```curl theme={null}
curl --request POST \
     --url https://api.fintoc.com/v1/checkout_sessions \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "amount": 100000,
  "currency": "CLP",
  "cancel_url": "https://merchant.com/987654321",
  "success_url": "https://merchant.com/success",
  "customer_email": "customer@example.com",
  "metadata": {
    "order": "123456"
  },
  "payment_methods": ["installments_payment"]
}'
```

| Parámetro         | Ejemplo                          | Explicación                                                                                                                                                                                                                                                                                                                          |
| :---------------- | :------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `amount`          | `100000`                         | Monto de dinero que debe pagarse. Se representa como un entero sin decimales en la unidad más pequeña posible de la moneda que estás usando.<br /><br />**Por el momento, el monto mínimo es CLP 20.000 y el máximo es CLP 400.000.** Sin embargo, podemos evaluar tu caso de uso específico si tienes un ticket promedio más alto." |
| `currency`        | `CLP`                            | Moneda que se usa para el pago. Actualmente solo soportamos CLP para pagos en cuotas.                                                                                                                                                                                                                                                |
| `cancel_url`      | `https://merchant.com/987654321` | URL para redirigir al usuario en caso de que decida cancelar el pago y volver a tu sitio.                                                                                                                                                                                                                                            |
| `success_url`     | `https://merchant.com/success`   | URL para redirigir al usuario en caso de pago exitoso.                                                                                                                                                                                                                                                                               |
| `customer_email`  | `customer@example.com`           | Un email del cliente vinculado a la Checkout Session.<br /><br />**Es un campo requerido** para el método `installments_payment`.                                                                                                                                                                                                    |
| `payment_methods` | `["installments_payment"]`       | Métodos de pago disponibles para el cliente. `instalments_payment` representa el método Buy Now Pay Later y debe ser el único método establecido.<br />**Actualmente no es posible incluir más de un método de pago.**                                                                                                               |
| `metadata`        | `{ "order": "#987654321"   }`    | Conjunto opcional de pares clave-valor que puedes adjuntar a un objeto. Esto puede ser útil para almacenar información adicional sobre el objeto en un formato estructurado.                                                                                                                                                         |

<Info>
  **El pago en cuotas solo está disponible vía el flujo de Redirect Page**

  Para aceptar pagos en cuotas debes usar la integración vía una [Redirect Page](/es/v2023-11-15/docs/payments/redirect-page) donde redirigirás a los usuarios a una página de pago alojada por Fintoc.

  Después de completar el pago, serán redirigidos automáticamente de vuelta a tu sitio al `success_url` o `cancel_url`, según el resultado del pago.
</Info>

## Respuesta al crear una Checkout Session para un pago en cuotas

Después de hacer la solicitud, Fintoc responderá con la Checkout Session con el estado `created` incluyendo la `redirect_url` que usarás para redirigir a tu usuario a completar el pago:

```json theme={null}
{
  id: "cs_li5531onlFDi235",
  created_at: "2025-02-15T15:22:11.474Z",
  object: "checkout_session",
  expires_at: "2025-02-15T15:37:11.474Z",
  mode: "live",
  status: "created",
  metadata: {
    "order": "123456"
  },
  payment_methods: ["installments_payment"],
  currency: "CLP",
  amount: 100000,
  cancel_url: "https://merchant.com/987654321",
  success_url: "https://merchant.com/success",
  redirect_url: "https://pay.fintoc.com/payment?checkout_sesion=cs_li5531onlFDi235"
}

```

| Parámetro      | Ejemplo                                                              | Explicación                                       |
| :------------- | :------------------------------------------------------------------- | :------------------------------------------------ |
| `redirect_url` | `https://pay.fintoc.com/payment?checkout_session=cs_li5531onlFDi235` | URL para redirigir al usuario a completar el pago |

## Maneja los eventos posteriores al pago

Una vez que una Checkout Session finaliza, manejas el resultado del pago en tu frontend y completas el pago en tu backend. Para tu frontend usarás el `success_url` y `cancel_url`, y para tu backend usarás los eventos enviados por webhooks.

Fintoc envía un evento `checkout_session.finished` cuando el pago se completa. [Sigue la guía de webhooks](/es/v2023-11-15/docs/resources/webhooks-walkthrough) para recibir estos eventos y ejecutar acciones, como enviar un correo de confirmación de orden a tu cliente, registrar la venta en una base de datos o iniciar un flujo de envío.

Debes manejar los siguientes eventos:

| Evento                      | Descripción                                                                    | Acción                                           |
| :-------------------------- | :----------------------------------------------------------------------------- | :----------------------------------------------- |
| `checkout_session.finished` | Enviado cuando un pago asociado a una Checkout Session alcanza un estado final | Completa la orden según el estado final del pago |
| `checkout_session.expired`  | Enviado cuando una sesión expira                                               | Ofrece al cliente otro intento de pago.          |

<br />

## Prueba tu integración

Para simular un pago Buy Now Pay Later exitoso o fallido, puedes usar uno de los siguientes números de RUT durante el proceso de pago:

| **Número de RUT**                                             | **Resultado final**                                        |
| ------------------------------------------------------------- | ---------------------------------------------------------- |
| Cualquier número, excepto 11111111-1, 44444444-4 o 22222222-2 | ✅ Exitoso                                                  |
| 11111111-1                                                    | ❌ Fallido porque no hay oferta de crédito disponible       |
| 44444444-4                                                    | ❌ Fallido por un crédito activo                            |
| 22222222-2                                                    | ❌ Fallido durante el paso de firma del contrato de crédito |

En modo de prueba, el proceso de pago no incluye el paso de suscripción al PAC. Por lo que al acceder al `redirect_url`, los pasos serán:

1. Ingresar número de RUT
2. Ver y seleccionar una oferta de plan de cuotas: en modo de prueba, solo estará disponible una opción de cuota: un pago único de 103.103 CLP, independientemente del monto especificado al crear la Checkout Session.
3. Confirmar número móvil mediante código SMS. En modo de prueba puedes ingresar cualquier número móvil para proceder, y puedes usar los siguientes códigos:
   1. Cualquier código excepto 123456 para proceder al siguiente paso.
   2. 123456 para simular una falla en este paso.
4. Firmar el contrato de crédito: recibirás un código en el `customer_email` que estableciste al crear la Checkout Session. Usa este código para proceder a un pago exitoso.
5. Pago exitoso: serás redirigido al `success_url` y recibirás el evento `checkout_session.finished`.

## Guía de UX para el checkout

Para asegurar una buena experiencia y comprensión para tus usuarios, agrega el botón Buy Now Pay Later en tu checkout usando las imágenes a continuación según tu configuración:

|                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Descripción                                                      | HTML                                                                                  |
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------- | :------------------------------------------------------------------------------------ |
| <img src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/17bae8e8816db69bd877063cd00399f76f844e928122a56a9c004365ed5f77b1-bnpl_bancame_fintoc_combo_cl_light.svg?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=f47250edaaa7f5dbb9dad0233f338d63" alt="" width="389" height="40" data-path="images/17bae8e8816db69bd877063cd00399f76f844e928122a56a9c004365ed5f77b1-bnpl_bancame_fintoc_combo_cl_light.svg" /> | Botón claro para usar con el texto "Paga en cuotas sin Tarjeta"  | `<img src="https://assets.fintoc.com/?img_name=bnpl_bancame_fintoc_combo_cl_light">`  |
| <img src="https://mintcdn.com/fintoc-49b8bee8/SkvJJ-DZ5D4yC6tQ/images/eef6f427a77ff194e937374d567ec5e1da3c21685251c5ae360772c9b631e17f-bnpl_banca.me_fintoc_combo_cl_dark.svg?fit=max&auto=format&n=SkvJJ-DZ5D4yC6tQ&q=85&s=843e52997e6e3657546a8c9edc4a4965" alt="" width="388" height="40" data-path="images/eef6f427a77ff194e937374d567ec5e1da3c21685251c5ae360772c9b631e17f-bnpl_banca.me_fintoc_combo_cl_dark.svg" /> | Botón oscuro para usar con el texto "Paga en cuotas sin Tarjeta" | `<img src="<https://assets.fintoc.com/?img_name=bnpl_bancame_fintoc_combo_cl_dark>">` |
| <img src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/8d52ee81db5137549174d3bac6ff2e7a3af594531c9cb3f6b74d98625c73714b-bancame_fintoc_light.svg?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=13c1e2aa1a5b541a47a37171de1d7bd7" alt="" width="121" height="40" data-path="images/8d52ee81db5137549174d3bac6ff2e7a3af594531c9cb3f6b74d98625c73714b-bancame_fintoc_light.svg" />                                                                                                                 | Logos claros para usar con la imagen de texto + logos de bancos  | `<img src="https://assets.fintoc.com/?img_name=bancame_fintoc_light">`                |
| <img src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/b169eac9b4e51b5e9ca676b2e3e0de0edd466da1934eea83dbde341b5ac64f19-bancame_fintoc_dark.svg?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=7aabafb0908543e7d707ad2026c44120" alt="" width="120" height="39" data-path="images/b169eac9b4e51b5e9ca676b2e3e0de0edd466da1934eea83dbde341b5ac64f19-bancame_fintoc_dark.svg" />                                                                                                                         | Logos oscuros para usar con la imagen de texto + logos de bancos | `<img src="https://assets.fintoc.com/?img_name=bancame_fintoc_dark">`                 |
| <img src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/0b5270387120f15d40535dd93a832582ad73a08652f388737be1296515c5e179-bnpl_fintoc_combo_cl_light.svg?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=0bb797d662848bf6ff58ec443de3e576" alt="" width="249" height="87" data-path="images/0b5270387120f15d40535dd93a832582ad73a08652f388737be1296515c5e179-bnpl_fintoc_combo_cl_light.svg" />                                                                 | Texto claro + logos de bancos para usar con los logos            | `<img src="https://assets.fintoc.com/?img_name=bnpl_fintoc_combo_cl_light">`          |
| <img src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/368c60ba72d3fa0b09935231a3c6fc138ff9c5e4767897668425e88fdd985d09-bnpl_fintoc_combo_cl_dark1.svg?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=1b53c79227f1f2d898c0f41ca4c6b2bc" alt="" width="249" height="87" data-path="images/368c60ba72d3fa0b09935231a3c6fc138ff9c5e4767897668425e88fdd985d09-bnpl_fintoc_combo_cl_dark1.svg" />                                                                 | Texto oscuro + logos de bancos para usar con los logos           | `<img src="https://assets.fintoc.com/?img_name=bnpl_fintoc_combo_cl_dark">`           |

<Info>
  **Asegúrate de ocultar la opción Buy Now, Pay Later para montos por debajo del mínimo.**

  Dado que el monto mínimo para pagos en cuotas es CLP 20.000, debes asegurarte de que el botón Buy Now, Pay Later no se muestre en el checkout para órdenes por debajo de este umbral. Esto ayuda a evitar una mala experiencia de usuario y una posible caída en las tasas de conversión.
</Info>