Fintoc via Direct API

Overview

Fintoc is a Latin American instant payment method (Payment Initiation / Account-to-Account) that allows users to pay directly from their bank account. DEUNA integrates Fintoc using a redirect model: after initiating the purchase via the DEUNA API, the user is redirected to a Fintoc-hosted page to log in to their bank and authenticate the payment, then returned to your site.

Requirements:

• Available in Chile
• Currency: CLP (Chile)
• The user must have an active account with a bank supported by Fintoc

Purchase v2

V2 purchases perform the order creation and payment initiation in a single endpoint.

The Fintoc purchase process goes as follows:

1. User calls POST v2/merchants/order/purchase with the order information.
2. DEUNA creates the order and initiates the Fintoc transaction.
3. DEUNA returns a redirect URL in the response.
4. You redirect the user to that URL to complete bank login and authentication on the Fintoc page.
5. After authentication, Fintoc redirects the user back to your site.
6. DEUNA listens to the Fintoc notification (webhook) to confirm the final payment status.

Integrate Fintoc by API

1. Make a Fintoc purchase

Make a request to the V2 Purchase endpoint.

To make a Fintoc purchase with DEUNA, the V2 payload must contain:

• The order data
• Callback URLs to redirect the user after payment
• Optionally, the customer's email or tax ID to pre-fill the Fintoc screen

📘 All amounts must be expressed in cents. Example: CLP 10.50 = 1050

Request example

{
  "order_type": "DEUNA_CHECKOUT",
  "payment_source": {
    "method_type": "bank_transfer",
    "processor": "fintoc",
    "method_type_specific_fields": {
      "customer_email": "[email protected]"
    }
  },
  "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. Redirect the user

After the purchase is initiated, the API responds with a redirect URL in the next_action node.

1. Take the URL
2. Redirect the user to that URL.
3. The user completes authentication on the Fintoc page:
   • Selects their bank
   • Logs in with their online banking credentials
   • Completes MFA/contact authorization if required by their bank
   • Confirms the payment
4. After authentication, Fintoc redirects the user back to your callback_urls.on_success or callback_urls.on_error.
5. Listen to DEUNA webhooks to confirm the final payment status.

Response example

{
  "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"
          }
        }