Fintoc a través de API directa

Descripción general

Fintoc es un método de pago instantáneo (Iniciación de Pago / Cuenta a Cuenta) latinoamericano que permite a los usuarios pagar directamente desde su cuenta bancaria. DEUNA integra Fintoc utilizando un modelo de redireccionamiento: después de iniciar la compra a través de la API DEUNA, el usuario es redirigido a una página alojada en Fintoc para iniciar sesión en su banco y autenticar el pago, luego regresa a su sitio.

Requisitos:

Disponible en Chile
Moneda: CLP (Chile)
El usuario debe tener una cuenta activa en un banco respaldado por Fintoc.

Compra v2

Las compras V2 realizan la creación del pedido y el inicio del pago en un único punto final.

El proceso de compra de Fintoc es el siguiente:

Llamadas de usuario POST v2/merchants/order/purchase con la información del pedido.
DEUNA crea la orden e inicia la transacción Fintoc.
DEUNA devuelve una URL de redireccionamiento en la respuesta.
Redirige al usuario a esa URL para completar el inicio de sesión y la autenticación del banco en la página de Fintoc.
Después de la autenticación, Fintoc redirige al usuario a su sitio.
DEUNA escucha la notificación de Fintoc (webhook) para confirmar el estado del pago final.

Integrar Fintoc por API

1. Realiza una compra en Fintoc

Realizar una solicitud al Compra V2 endpoint.

Para realizar una compra de Fintoc con DEUNA, la carga útil V2 debe contener:

los datos del pedido
URL de devolución de llamada para redirigir al usuario después del pago
Opcionalmente, el correo electrónico del cliente o su identificación fiscal para completar previamente la pantalla de Fintoc.

📘 Todos los importes deben expresarse en céntimos. Ejemplo: $10,50 = 1050

Ejemplo de solicitud

JSON

{
  "order_type": "DEUNA_CHECKOUT",
  "payment_source": {
    "method_type": "bank_transfer",
    "processor": "fintoc",
    "method_type_specific_fields": {
      "customer_email": "customer@example.com"
    }
  },
  "callback_urls": {
    "on_success": "https://example.com/success",
    "on_error": "https://example.com/error"
  },
  "order": {
    "order_id": "d81fe7bf-748b-4a7a-bc8f-7be98c8ae748",
    "store_code": "all",
    "currency": "CLP",
    "total_amount": 1050,
    "items_total_amount": 1050,
    "sub_total": 1050,
    "items": [
      {
        "id": "1",
        "name": "Cinema ticket",
        "description": "Standard ticket",
        "total_amount": {
          "amount": 1050,
          "currency": "CLP",
          "currency_symbol": "$"
        },
        "unit_price": {
          "amount": 1050,
          "currency": "CLP",
          "currency_symbol": "$"
        },
        "quantity": 1
      }
    ]
  }
}

2. Redirigir al usuario

Una vez iniciada la compra, la API responde con una URL de redireccionamiento en el next_action node.

Toma la URL
Redirigir al usuario a esa URL.
El usuario completa la autenticación en la página de Fintoc:
- Selecciona su banco
- Inicia sesión con sus credenciales de banca en línea
- Completa MFA/autorización de contacto si así lo requiere su banco
- Confirma el pago
Después de la autenticación, Fintoc redirige al usuario a su callback_urls.on_success o callback_urls.on_error.
Escuche los webhooks de DEUNA para confirmar el estado del pago final.

Ejemplo de respuesta

JSON

{
  "order_type": "DEUNA_CHECKOUT",
  "order_token": "db3fc147-2a4e-460f-a874-f6f79b1e651c",
  "order": {
    "order_id": "d81fe7bf-748b-4a7a-bc8f-7be98c8ae748",
    "currency": "CLP",
    "total_amount": 1050,
    "status": "pending",
    "payment": {
      "data": {
        "status": "pending",
        "method_type": "bank_transfer",
        "processor": "fintoc",
        "next_action": {
          "action": "authorization_bank_transfer",
          "authorization_bank_transfer": {
            "redirect_url": "https://checkout.fintoc.com/cs_li5531onlFDi235"
          }
        }