Fintoc tramite API diretta

Panoramica

Fintoc è un metodo di pagamento istantaneo latinoamericano (Iniziazione del pagamento / Account-to-Account) che consente agli utenti di pagare direttamente dal proprio conto bancario. DEUNA integra Fintoc utilizzando un modello di reindirizzamento: dopo aver avviato l'acquisto tramite l'API DEUNA, l'utente viene reindirizzato a una pagina ospitata da Fintoc per accedere alla propria banca e autenticare il pagamento, quindi restituito al tuo sito.

Requisiti:

Disponibile in Chile
Valuta: CLP (Chile)
L'utente deve avere un account attivo con una banca supportata da Fintoc

Acquisto v2

Gli acquisti V2 effettuano la creazione dell'ordine e l'iniziazione del pagamento in un unico punto di vista.

Il processo di acquisto di Fintoc è il seguente:

Chiamate utente POST v2/merchants/order/purchase con le informazioni sull'ordine.
DEUNA crea l'ordine e avvia la transazione Fintoc.
DEUNA restituisce un URL reindirizzato nella risposta.
Reindirizza l'utente a quell'URL per completare il login e l'autenticazione bancaria nella pagina Fintoc.
Dopo l'autenticazione, Fintoc reindirizza l'utente al tuo sito.
DEUNA ascolta la notifica Fintoc (webhook) per confermare lo stato di pagamento finale.

Integrare Fintoc per API

1. Fare un acquisto Fintoc

Fai una richiesta al V2 acquisto endpoint.

Per effettuare un acquisto di Fintoc con DEUNA, il carico di pagamento V2 deve contenere:

I dati dell'ordine
URL di Callback per reindirizzare l'utente dopo il pagamento
Opzionalmente, l'email del cliente o l'ID fiscale per pre-riempire lo schermo Fintoc

📘 Tutti gli importi devono essere espressi in centesimi. Esempio: CLP 10.50 = 1050

Esempio di richiesta

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. Reindirizza l'utente

Dopo l'avvio dell'acquisto, l'API risponde con un URL reindirizzato nel next_action node.

Prendi l'URL
Reindirizza l'utente a quell'URL.
L'utente completa l'autenticazione nella pagina Fintoc:
- Seleziona la loro banca
- Accedi con le credenziali bancarie online
- Completa l'autorizzazione MFA/contatta se richiesto dalla loro banca
- Conferma il pagamento
Dopo l'autenticazione, Fintoc reindirizza l'utente al tuo callback_urls.on_success o callback_urls.on_error.
Ascoltate i webhooks DEUNA per confermare lo stato di pagamento finale.

Esempio di risposta

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