Saltar al contenido principal
Para confirmar que tu integración funciona correctamente, simula pagos sin mover dinero usando valores especiales en modo test. Las cuentas de test te permiten simular varios escenarios:
  • Pagos exitosos y fallidos por método de pago
  • Reembolsar un pago
Cada vez que trabajes con una cuenta de test, usa API Keys de test en todas las llamadas a la API.

Pagos por transferencia bancaria

Para pagos por transferencia bancaria, en modo test usas credenciales de test distintas para simular el flujo de pago y los tipos de error para cada tipo de Autenticación Multifactor (MFA):

Tipos de MFA disponibles

Estos son los distintos MFA que tenemos disponibles dentro del modo test:
  • Dispositivo de seguridad: dispositivo electrónico que los bancos entregan a sus clientes para autorizar transacciones. Generalmente muestran un número que cambia después de cierto tiempo.
  • Aplicación móvil: los bancos ofrecen autorizar transacciones a través de sus apps móviles. En este caso, el usuario debe autorizar la transacción desde su smartphone y detectaremos que la transacción fue autorizada automáticamente.
  • SMS: el banco envía un código (generalmente un código numérico) al teléfono del usuario para que pueda usarse para autorizar la transacción.
  • Tarjeta de coordenadas: tarjeta que los bancos entregan a sus clientes con una tabla con números. El usuario debe ingresar los números ubicados en las coordenadas que pide el banco. Puedes leer más sobre tarjetas de coordenadas aquí.

Valores especiales de test

Fintoc proporciona valores especiales de test para Chile y México. Cada país tiene su propio flujo de autorización de pago, y con el modo test de Fintoc puedes probar cada flujo de autorización que tu usuario podría seguir.

Chile 🇨🇱

En Chile, un pago tiene entre dos y tres pasos dependiendo del banco:
  1. El usuario inicia sesión en su cuenta bancaria.
  2. En algunos bancos y casos específicos, el usuario necesita autorizar un nuevo contacto antes de autorizar el pago.
  3. El usuario autoriza el pago.
Fintoc proporciona valores especiales de test para cada uno de esos pasos.

Credenciales de test

Puedes usar las siguientes credenciales de test para iniciar sesión en una cuenta bancaria.

MFA para simular un nuevo contacto

El usuario podría necesitar agregar la cuenta del destinatario antes de confirmar la transacción. Si quieres que el widget pida algún tipo de MFA que simule que el usuario necesita agregar la cuenta destinataria de la Checkout Session como un nuevo contacto, debes usar dígitos finales específicos para el atributo amount de la Checkout Session. Por ejemplo, si creas una Checkout Session con un monto de 15001, se le pedirá al usuario que autorice el nuevo contacto usando su dispositivo de seguridad. Puedes ver la lista de combinaciones de dígitos específicos que indican qué tipo de MFA corresponde a qué últimos dígitos del monto y qué código ingresar. Ingresar un código diferente resultará en una falla de la autorización: Si el monto de la Checkout Session no termina con ninguno de los dígitos anteriores, no se le requerirá MFA al usuario para crear un nuevo contacto e irá directamente a confirmar la transferencia bancaria.

MFA para confirmar la operación

Para elegir qué método de autorización usar mientras estás en modo test para confirmar el pago, debes seleccionar un número de cuenta bancaria de origen específico durante el flujo de pago. El ambiente de modo test siempre mostrará las mismas cuentas. Aquí hay una lista de los números de cuenta bancaria del modo test y qué tipo de MFA corresponde a cada uno, junto con el código correcto a ingresar. La cuenta 5233138811 falla con error_reason new_contact_amount_limit_reached, un error de límite de monto para nuevos contactos. Consulta Payment Intent Error Reason para la lista completa de razones.

Simular un pago en estado pendiente

También puedes simular un estado de pago pendiente eligiendo cuentas bancarias de origen específicas de test. Esto te permite validar cómo tu sistema maneja las transacciones que no se confirman inmediatamente.

Simular métodos de pago alternativos

Puedes probar el flujo de pago para Métodos de Pago Alternativos para transferencias bancarias en Chile siguiendo los pasos en la guía específica. Los métodos disponibles son:
  • Banco Estado (Botón Compraquí)
  • Banco de Chile (Botón Banco de Chile)
  • Banco Santander (Botón Santander)
  • Mach

México 🇲🇽

En México, un pago tiene solo dos pasos:
  1. El usuario ingresa su número de teléfono para iniciar el pago.
  2. El usuario autoriza el pago en la aplicación móvil de su banco.
Para simular un pago exitoso o fallido, puedes usar uno de los siguientes números de celular cuando el widget te lo pida.

Pagos con tarjeta

Para simular un pago con tarjeta exitoso o fallido, puedes usar una de las siguientes credenciales de tarjeta durante el proceso de pago:

Probar webhooks

Para probar webhooks, debes realizar acciones en modo test que envíen eventos legítimos a tu endpoint. Por ejemplo, para disparar el evento checkout_session.finished, puedes usar una cuenta de test que produzca un pago exitoso.

Probar reembolsos

Usando el modo test puedes simular reembolsos exitosos y fallidos. La única diferencia con el modo live es que en modo live los reembolsos tardan de 1 a 2 días hábiles en procesarse, mientras que en modo test, dependiendo del monto del reembolso, los reembolsos se procesan casi inmediatamente. Puedes usar el monto del reembolso para simular un reembolso exitoso o fallido. Puedes simular un reembolso total creando una checkout session con el monto que quieras probar.
Webhooks de reembolsoEn modo test recibes los mismos webhooks que recibirías en modo live.