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.

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 --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. 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. 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. 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.

El pago en cuotas solo está disponible vía el flujo de Redirect PagePara aceptar pagos en cuotas debes usar la integración vía una 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.

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:

{
  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 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.

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:

Ingresar número de RUT
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.
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.
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.
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
	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">`
	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>">`
	Logos claros para usar con la imagen de texto + logos de bancos	`<img src="https://assets.fintoc.com/?img_name=bancame_fintoc_light">`
	Logos oscuros para usar con la imagen de texto + logos de bancos	`<img src="https://assets.fintoc.com/?img_name=bancame_fintoc_dark">`
	Texto claro + logos de bancos para usar con los logos	`<img src="https://assets.fintoc.com/?img_name=bnpl_fintoc_combo_cl_light">`
	Texto oscuro + logos de bancos para usar con los logos	`<img src="https://assets.fintoc.com/?img_name=bnpl_fintoc_combo_cl_dark">`

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.

Inicio

Recursos

Pagos

Transferencias

Domiciliación bancaria

Movimientos

Buy Now Pay Later (Solo Chile)

Crea un pago Buy Now Pay Later

Respuesta al crear una Checkout Session para un pago en cuotas

Maneja los eventos posteriores al pago

Prueba tu integración

Guía de UX para el checkout

​Crea un pago Buy Now Pay Later

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

​Maneja los eventos posteriores al pago

​Prueba tu integración

​Guía de UX para el checkout

Crea un pago Buy Now Pay Later

Respuesta al crear una Checkout Session para un pago en cuotas

Maneja los eventos posteriores al pago

Prueba tu integración

Guía de UX para el checkout