Para confirmar que tu integración funciona correctamente, simula suscripciones y cargos sin mover dinero usando valores especiales en modo de prueba. Los valores especiales de prueba te permiten simular varios escenarios:

Suscripciones y cargos exitosos
Errores en suscripciones por datos inválidos o autorización fallida del usuario
Cargos fallidos

Siempre que trabajes con una cuenta de prueba, utiliza las API Keys de prueba en todas las llamadas a la API.

Tipos de MFA disponibles

Estos son los distintos MFA que tenemos disponibles en el modo de prueba:

Dispositivo de seguridad: dispositivo electrónico que los bancos entregan a sus clientes para autorizar transacciones. Generalmente muestran un número que cambia cada 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 automáticamente que la transacción fue autorizada.
SMS: el banco envía un código (generalmente 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 de números. El usuario debe ingresar los números ubicados en las coordenadas solicitadas por el banco. Puedes leer más sobre las tarjetas de coordenadas aquí.

Simular suscripciones

Fintoc proporciona valores especiales de prueba solo para Chile, ya que es el único país compatible con este producto. Con el modo de prueba de Suscripciones, puedes probar cada flujo de autorización que tu usuario podría seguir.

Chile 🇨🇱

En Chile, una suscripción tiene dos pasos:

El usuario inicia sesión en su cuenta bancaria.
El usuario autoriza la suscripción.

Fintoc proporciona valores especiales de prueba para cada uno de esos pasos.

Credenciales de prueba

Puedes utilizar las siguientes credenciales de prueba para iniciar sesión en una cuenta bancaria.

Usuario	Contraseña
41614850-3	jonsnow
40427672-7	jonsnow
41579263-8	jonsnow

MFA para autorizar la suscripción

Para elegir qué método de autorización utilizar en el modo de prueba al confirmar la suscripción, debes seleccionar un número de cuenta bancaria de origen específico durante el flujo de suscripción. El entorno del modo de prueba siempre mostrará las mismas cuentas. A continuación encontrarás una lista de los números de cuenta bancaria del modo de prueba y qué tipo de MFA corresponde a cada uno, junto con el código correcto a ingresar.

Número de cuenta	Tipo de MFA	Código correcto
813990168	Dispositivo de seguridad	`000000`
422159212	Aplicación móvil - Éxito	`N/A`
5233137377	Aplicación móvil - Fallo	`N/A`
170086177	SMS	`0000`
746326042	Tarjeta de coordenadas	`['00', '00', '00']`

Probar errores

Para probar el manejo de errores en Suscripciones en modo de prueba, el Sandbox proporciona cuentas de deudor ficticias y deterministas. Cuando creas una suscripción y seleccionas alguna de las cuentas a continuación, la suscripción fallará con el código de error correspondiente:

“La cuenta terminada en XXXX” se refiere a los últimos 4 dígitos del número de cuenta del deudor que se muestra en el Sandbox.
Estos comportamientos ocurren solo en modo de prueba y nunca generan un cargo ni crean un mandato real.

Disparador de error (selecciona esta cuenta de deudor / acción)	Código de error resultante	Qué ocurre
Cuenta de deudor terminada en 9999	`internal_error`	Simula una falla inesperada del lado del servidor. Manéjalo como un error genérico reintentable.
Cuenta de deudor terminada en 8888	`request_timeout`	Simula un timeout de red/procesamiento en la solicitud. Tu cliente debe implementar idempotencia y reintentos.
Cuenta de deudor terminada en 7777	`authorization_timeout`	Simula un flujo de autorización que nunca se completa dentro de la ventana permitida. Trátalo como un timeout en el paso de autorización.
Cualquier cuenta con MFA (code/OTP) usando un OTP distinto a 000000	`authorization_failed`	Simula un intento de MFA incorrecto o fallido durante la autorización.
Inicia una autorización y espera 10 minutos sin completarla	`subscription_expired`	La intención de suscripción expira automáticamente. Los nuevos intentos deben iniciar una nueva intención.

Simular cargos

Para simular un cargo exitoso o fallido, puedes usar el atributo amount:

Montos mayores o iguales a 500 resultan en un cargo succeeded.
Montos menores a 500 resultan en un cargo failed.

En modo de prueba, ambos escenarios tienen notificaciones de webhook inmediatas. Antes de realizar un cargo de prueba, necesitas crear una suscripción de prueba.

Ejemplo - Exitoso

Request

curl --request POST \
     --url https://api.fintoc.com/v1/charges \
     --header 'Accept: application/json' \
     --header 'Authorization: sk_test_9c8dr3ryBTx1VcJzuDgpm4H' \
     --header 'Content-Type: application/json' \
     --data '
{
     "currency": "clp",
     "subscription_id": "sub_123ad123",
     "amount": 500
}
'

Response

{
 "id": "ch_e6dGMaB5UVy2QV3j",
 "failure_code": null,
 "created_at": "2022-07-15T19:09:51Z",
 "object": "charge",
 "status": "pending",
 "amount": 509,
 "currency": "CLP",
 "metadata": {},
 "subscription_id": "sub_gJYEapRyUg07yvz3"
}

Ejemplo - Fallido

Request

curl --request POST \
     --url https://api.fintoc.com/v1/charges \
     --header 'Accept: application/json' \
     --header 'Authorization: sk_test_9c8dr3ryBTx1VcJzuDgpm4H' \
     --header 'Content-Type: application/json' \
     --data '
{
     "currency": "clp",
     "subscription_id": "sub_123ad123",
     "amount": 499
}
'

Response

{
 "id": "ch_e6dGMaB5UVy2QV3j",
 "failure_code": null,
 "created_at": "2022-07-15T19:09:51Z",
 "object": "charge",
 "status": "pending",
 "amount": 50,
 "currency": "CLP",
 "metadata": {},
 "subscription_id": "sub_gJYEapRyUg07yvz3"
}

Probar webhooks

Para probar webhooks, tienes dos opciones:

Realiza acciones en modo de prueba que envíen eventos legítimos a tu endpoint. Por ejemplo, para disparar el evento charge.succeeded, puedes usar un valor de prueba que produzca un cargo exitoso.
Disparar eventos de prueba desde el Dashboard

Inicio

Recursos

Pagos

Transferencias

Movimientos

Prueba tu integración

Tipos de MFA disponibles

Simular suscripciones

Chile 🇨🇱

Credenciales de prueba

MFA para autorizar la suscripción

Probar errores

Simular cargos

Ejemplo - Exitoso

Ejemplo - Fallido

Probar webhooks

​Tipos de MFA disponibles

​Simular suscripciones

​Chile 🇨🇱

​Credenciales de prueba

​MFA para autorizar la suscripción

​Probar errores

​Simular cargos

​Ejemplo - Exitoso

​Ejemplo - Fallido

​Probar webhooks

Tipos de MFA disponibles

Simular suscripciones

Chile 🇨🇱

Credenciales de prueba

MFA para autorizar la suscripción

Probar errores

Simular cargos

Ejemplo - Exitoso

Ejemplo - Fallido

Probar webhooks