Prueba tu integración

Simula todos los resultados de los métodos de pago alternativos sin tocar bancos reales. En modo de prueba, Fintoc reemplaza la página de checkout del banco con un simulador sandbox que emite los mismos webhooks que el flujo en vivo, para que puedas verificar tu integración antes de pasar a producción.

Proveedores disponibles

Usa institution_id para filtrar bancos en la página de checkout. El payment intent resultante incluye payment_type, que identifica el método utilizado. No envíes payment_type al crear una Checkout Session para seleccionar el método alternativo.

Banco	`institution_id`	`payment_type`	Tipos de cuenta
Banco Santander	`cl_banco_santander`	`banco_santander`	Personal y empresa
Banco de Chile	`cl_banco_de_chile`	`banco_de_chile`	Personal y empresa
BancoEstado	`cl_banco_estado`	`banco_estado`	Personal y empresa
Mach	`cl_mach`	`mach`	Personal

Los proveedores con cuenta empresa incluyen un flujo de múltiples firmantes. Los proveedores solo personales se completan en un solo paso.

Elige el flujo de pago que quieres probar

Tanto la iniciación de pagos Fintoc como los métodos alternativos usan payment_method_types: ["bank_transfer"]. Fintoc selecciona el flujo según el banco, el monto y la configuración de tu organización. Seleccionar un banco no fuerza su método de pago alternativo. Antes de probar, confirma con el equipo de Fintoc que los métodos alternativos que necesitas estén habilitados para tu organización en modo test. Crea una nueva Checkout Session con uno de estos montos y selecciona el banco correspondiente en el checkout:

Banco que seleccionas	`amount` de prueba (CLP)
Banco de Chile	`8000000`
Banco Santander	`8000000`
BancoEstado	`8000000`
Mach	`200000`

Para Banco de Chile, Santander y BancoEstado, 8.000.000 CLP supera los límites de iniciación de pagos documentados. El monto está bajo el máximo predeterminado del método alternativo de 15.000.000 CLP. Mach utiliza el flujo de pago alternativo sin que debas superar un límite de iniciación de pagos. Los límites configurados para tu organización pueden cambiar los montos elegibles. Para probar métodos alternativos con montos menores, pide al equipo de Fintoc que configure tu organización para preferir esos métodos en modo test. Para probar la iniciación estándar, usa un monto elegible y una configuración que no prefiera métodos alternativos. Sigue la guía de pruebas de iniciación de pagos para las credenciales y los resultados de prueba.

Crea una Checkout Session en modo de prueba

Envía la solicitud desde tu servidor con tu API key de prueba. Los ejemplos siguientes crean un pago de 8.000.000 CLP para probar BancoEstado, Santander o Banco de Chile. Para probar Mach, cambia amount a 200000.

curl --request POST "https://api.fintoc.com/v2/checkout_sessions" \
  --header "Authorization: sk_test_a1b3h4j24i9j0" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "amount": 8000000,
    "currency": "CLP",
    "payment_method_types": ["bank_transfer"],
    "success_url": "https://example.com/success",
    "cancel_url": "https://example.com/cancel"
  }'

Node

const { Fintoc } = require('fintoc');

const fintoc = new Fintoc('sk_test_a1b3h4j24i9j0');

const checkoutSession = await fintoc.v2.checkoutSessions.create({
  amount: 8000000,
  currency: 'CLP',
  payment_method_types: ['bank_transfer'],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel'
});

from fintoc import Fintoc

client = Fintoc('sk_test_a1b3h4j24i9j0')

checkout_session = client.v2.checkout_sessions.create(
    amount=8000000,
    currency='CLP',
    payment_method_types=['bank_transfer'],
    success_url='https://example.com/success',
    cancel_url='https://example.com/cancel'
)

La respuesta incluye id y redirect_url.

{
  "id": "cs_test_a1b2c3d4e5f6g7h8i9j0",
  "object": "checkout_session",
  "status": "in_progress",
  "redirect_url": "https://pay.fintoc.com/payment?checkout_session=cs_ca29miv93md9hwl9",
  "amount": 8000000,
  "currency": "CLP"
}

Abre el checkout y elige un banco

Abre el redirect_url en un navegador y selecciona el banco correspondiente a tu monto de prueba. Cuando Fintoc selecciona el método alternativo, el checkout te redirige a https://pay.fintoc.com/sandbox/{checkout_session_id}. Si el checkout pide credenciales de acceso bancario, estás probando la iniciación de pagos Fintoc estándar, no el simulador de métodos alternativos. Revisa el banco y el monto con la tabla anterior. Si el método alternativo aún no se abre, contacta al equipo de Fintoc para revisar la disponibilidad y el enrutamiento de tu organización en modo test.

Dispara un resultado

El simulador renderiza una página con el estilo del banco seleccionado. Para proveedores con capacidad de empresa (Santander, Banco de Chile, BancoEstado), primero elige el escenario:

Pago Persona
Pago empresa con 1 apoderado
Pago empresa con 2 o más apoderados

Mach omite este paso y muestra la pantalla de resultado directamente. Luego haz clic en el resultado que quieres simular: Pagos personales (Mach, o el flujo Pago Persona en proveedores con capacidad de empresa):

Botón de resultado	Estado
`Pago exitoso`	`succeeded`
`Pago fallido`	`failed`
`Pago expirado`	`expired`

Pagos empresa (1 o 2+ apoderados en Santander, Banco de Chile, BancoEstado):

Botón de resultado	Estado
`Pago aprobado por todos los apoderados`	Pasa a `requires_action` y transiciona a `succeeded` después de 30 segundos.
`Pago pendiente de aprobación`	Permanece en `requires_action` hasta que los firmantes restantes actúen o expire la sesión.
`Pago fallido`	`failed`.

El retraso de 30 segundos reproduce el tiempo que toma a cada firmante firmar el pago en producción.

Inspecciona los webhooks

Suscríbete a estos eventos en la configuración de tu endpoint de webhooks; el sandbox emite los mismos payloads que producción. Los payloads a continuación muestran solo los campos relevantes para este flujo.

Empresa aprobada por todos los firmantes

El cliente hace clic en Pago aprobado por todos los apoderados. Fintoc envía checkout_session.finished inmediatamente, luego payment_intent.succeeded después de 30 segundos.

{
  "type": "checkout_session.finished",
  "mode": "test",
  "data": {
    "object": "checkout_session",
    "id": "cs_test_a1b2c3d4e5f6g7h8i9j0",
    "status": "finished",
    "payment_resource": {
      "payment_intent": {
        "object": "payment_intent",
        "id": "pi_test_1a2b3c4d5e6f7g8h9i0j",
        "status": "requires_action",
        "amount": 8000000,
        "currency": "CLP",
        "payment_type": "banco_santander",
        "next_action": {
          "type": "bank_transfer_authorization",
          "expires_at": "2026-05-16T00:00:00-04:00"
        }
      }
    }
  }
}

{
  "type": "payment_intent.succeeded",
  "mode": "test",
  "data": {
    "object": "payment_intent",
    "id": "pi_test_1a2b3c4d5e6f7g8h9i0j",
    "status": "succeeded",
    "amount": 8000000,
    "currency": "CLP",
    "payment_type": "banco_santander",
    "next_action": null
  }
}

Empresa pendiente de aprobación

El cliente hace clic en Pago pendiente de aprobación. Fintoc envía checkout_session.finished. El intent permanece en requires_action hasta que los firmantes restantes actúen. Si nadie actúa antes del plazo mostrado en next_action.expires_at, Fintoc envía payment_intent.expired.

{
  "type": "checkout_session.finished",
  "mode": "test",
  "data": {
    "object": "checkout_session",
    "id": "cs_test_a1b2c3d4e5f6g7h8i9j0",
    "status": "finished",
    "payment_resource": {
      "payment_intent": {
        "object": "payment_intent",
        "id": "pi_test_1a2b3c4d5e6f7g8h9i0j",
        "status": "requires_action",
        "amount": 8000000,
        "currency": "CLP",
        "payment_type": "banco_santander",
        "next_action": {
          "type": "bank_transfer_authorization",
          "expires_at": "2026-05-16T00:00:00-04:00"
        }
      }
    }
  }
}

{
  "type": "payment_intent.expired",
  "mode": "test",
  "data": {
    "object": "payment_intent",
    "id": "pi_test_1a2b3c4d5e6f7g8h9i0j",
    "status": "expired",
    "amount": 8000000,
    "currency": "CLP",
    "payment_type": "banco_santander",
    "next_action": null
  }
}

Empresa rechazada

El cliente hace clic en Pago fallido. Fintoc envía checkout_session.finished y luego payment_intent.failed.

{
  "type": "checkout_session.finished",
  "mode": "test",
  "data": {
    "object": "checkout_session",
    "id": "cs_test_a1b2c3d4e5f6g7h8i9j0",
    "status": "finished",
    "payment_resource": {
      "payment_intent": {
        "object": "payment_intent",
        "id": "pi_test_1a2b3c4d5e6f7g8h9i0j",
        "status": "requires_action",
        "amount": 8000000,
        "currency": "CLP",
        "payment_type": "banco_santander",
        "next_action": {
          "type": "bank_transfer_authorization",
          "expires_at": "2026-05-16T00:00:00-04:00"
        }
      }
    }
  }
}

{
  "type": "payment_intent.failed",
  "mode": "test",
  "data": {
    "object": "payment_intent",
    "id": "pi_test_1a2b3c4d5e6f7g8h9i0j",
    "status": "failed",
    "amount": 8000000,
    "currency": "CLP",
    "payment_type": "banco_santander",
    "next_action": null
  }
}

Personal exitoso

Los ejemplos de webhooks personales usan una Checkout Session separada de 200.000 CLP con Mach. El cliente hace clic en Pago exitoso. Fintoc envía checkout_session.finished y payment_intent.succeeded en la misma transacción.

{
  "type": "checkout_session.finished",
  "mode": "test",
  "data": {
    "object": "checkout_session",
    "id": "cs_test_a1b2c3d4e5f6g7h8i9j0",
    "status": "finished",
    "payment_resource": {
      "payment_intent": {
        "object": "payment_intent",
        "id": "pi_test_1a2b3c4d5e6f7g8h9i0j",
        "status": "succeeded",
        "amount": 200000,
        "currency": "CLP",
        "payment_type": "mach"
      }
    }
  }
}

{
  "type": "payment_intent.succeeded",
  "mode": "test",
  "data": {
    "object": "payment_intent",
    "id": "pi_test_1a2b3c4d5e6f7g8h9i0j",
    "status": "succeeded",
    "amount": 200000,
    "currency": "CLP",
    "payment_type": "mach"
  }
}

Personal fallido

El cliente hace clic en Pago fallido. Misma estructura que personal exitoso, con status: "failed".

{
  "type": "payment_intent.failed",
  "mode": "test",
  "data": {
    "object": "payment_intent",
    "id": "pi_test_1a2b3c4d5e6f7g8h9i0j",
    "status": "failed",
    "amount": 200000,
    "currency": "CLP",
    "payment_type": "mach"
  }
}

checkout_session.finished también se dispara en paralelo, con payment_resource.payment_intent.status: "failed".

Personal expirado

El cliente hace clic en Pago expirado. Fintoc envía checkout_session.finished y payment_intent.expired.

{
  "type": "payment_intent.expired",
  "mode": "test",
  "data": {
    "object": "payment_intent",
    "id": "pi_test_1a2b3c4d5e6f7g8h9i0j",
    "status": "expired",
    "amount": 200000,
    "currency": "CLP",
    "payment_type": "mach"
  }
}

checkout_session.finished también se dispara en paralelo, con payment_resource.payment_intent.status: "expired". Cuando el pago termina en failed o expired, el objeto payment_intent también puede incluir un campo error_reason que describe la falla. Los valores exactos dependen del banco y del traductor de razones.

​Proveedores disponibles

​Elige el flujo de pago que quieres probar

​Crea una Checkout Session en modo de prueba

​Abre el checkout y elige un banco

​Dispara un resultado

​Inspecciona los webhooks

​Empresa aprobada por todos los firmantes

​Empresa pendiente de aprobación

​Empresa rechazada

​Personal exitoso

​Personal fallido

​Personal expirado