Skip to main content
All systems operationalChangelogv1
Log in

Fintoc via Widget

On this page

This section explains how to integrate Fintoc using DEUNA's Payment Widget. The user is redirected to Fintoc's hosted page to log in to their bank and authorize the payment, while DEUNA resolves the final status via polling and webhooks.

Prerequisites#

Before implementing Fintoc payments, ensure you have:

  1. Enabled Fintoc in the DEUNA Admin Panel. Add Fintoc under Connections with your Secret API Key, Public API Key, merchant name and currency (CLP). See Fintoc.
  2. A generated order token in CLP.
  3. The DEUNA SDK integrated in your project.
  4. Reviewed the Payment Widget documentation for your platform.

Payment Method configuration#

Display the Payment Widget by passing the Fintoc configuration in the paymentMethods parameter.

JSON
[
  {
    "paymentMethod": "bank_transfer",
    "processors": ["fintoc"]
  }
]

Payment Widget — Web#

JavaScript
DeunaSDK.initPaymentWidget({
  orderToken: 'YOUR_ORDER_TOKEN',
  paymentMethods: [
    {
      paymentMethod: 'bank_transfer',
      processors: ['fintoc'],
    },
  ],
  callbacks: { ... },
});

Payment Widget — Android#

Kotlin
// MODAL
deunaSDK.initPaymentWidget(
    context = context,
    orderToken = orderToken,
    callbacks = PaymentWidgetCallbacks().apply { ... },
    paymentMethods = listOf(
        mapOf(
            "paymentMethod" to "bank_transfer",
            "processors" to listOf("fintoc")
        )
    )
)

/// EMBEDDED
PaymentWidgetConfiguration(
    orderToken = orderToken,
    paymentMethods = listOf(
        mapOf(
            "paymentMethod" to "bank_transfer",
            "processors" to listOf("fintoc")
        )
    ),
    callbacks = PaymentWidgetCallbacks().apply { ... }
)

Payment Widget — iOS#

Swift
/// MODAL
deunaSDK.initPaymentWidget(
  orderToken: "<DEUNA order token>",
  userToken: ..., // optional
  styleFile: ..., // optional
  callbacks: ...,
  paymentMethods: [
    [
      "paymentMethod": "bank_transfer",
      "processors": ["fintoc"]
    ]
  ]
)

// EMBEDDED
DeunaWidget(
  deunaSDK: deunaSDK,
  configuration: PaymentWidgetConfiguration(
    orderToken: "YOUR_ORDER_TOKEN",
    callbacks: PaymentWidgetCallbacks(
      onSuccess: { order in },
      onError: { error in },
      onEventDispatch: { event, data in }
    ),
    paymentMethods: [
      [
        "paymentMethod": "bank_transfer",
        "processors": ["fintoc"]
      ]
    ]
  )
)

Payment Widget — React Native#

JavaScript
deunaSDK.initPaymentWidget({
  orderToken: 'YOUR_ORDER_TOKEN',
  paymentMethods: [
    {
      paymentMethod: 'bank_transfer',
      processors: ['fintoc'],
    },
  ],
  callbacks: { ... },
});

Customization#

The Fintoc screens support the standard widget customizations through CustomStyle:

  • Merchant logo
  • Payment method selector title
  • Powered by DEUNA

See Customize the UI/UX of widgets using CustomStyles.

Testing#

Use the Fintoc sandbox credentials:

ParameterValue
RUT41.579.263-8
Online banking passwordjonsnow
SMS verification code0000
CurrencyCLP
Environmenthttps://api.sandbox.deuna.io

Limitations#

  • Available in Chile only.
  • Supports CLP only.
  • The shopper must hold an active account with a bank supported by Fintoc.
  • Recurring payments are not supported in this flow.