Fintoc via l'API directe

Aperçu

Fintoc est un mode de paiement instantané latino-américain (Initiation de paiement / Compte à compte) qui permet aux utilisateurs de payer directement depuis leur compte bancaire. DEUNA intègre Fintoc selon un modèle de redirection : après avoir initié l'achat via l'API DEUNA, l'utilisateur est redirigé vers une page hébergée par Fintoc pour se connecter à sa banque et authentifier le paiement, puis renvoyé sur votre site.

Exigences :

• Disponible en Chili
• Monnaie: CLP (Chili)
• L'utilisateur doit avoir un compte actif auprès d'une banque prise en charge par Fintoc

Acheter la v2

Les achats V2 effectuent la création de commande et l’initiation du paiement dans un seul point de terminaison.

Le processus d'achat Fintoc se déroule comme suit :

1. Appels d'utilisateurs POST v2/merchants/order/purchase avec les informations de commande.
2. DEUNA crée la commande et initie la transaction Fintoc.
3. DEUNA renvoie une URL de redirection dans la réponse.
4. Vous redirigez l'utilisateur vers cette URL pour terminer la connexion bancaire et l'authentification sur la page Fintoc.
5. Après authentification, Fintoc redirige l'utilisateur vers votre site.
6. DEUNA écoute la notification Fintoc (webhook) pour confirmer le statut de paiement final.

Intégrer Fintoc par API

1. Effectuer un achat Fintoc

Faites une demande au Achat V2 endpoint.

Pour effectuer un achat Fintoc avec DEUNA, la charge utile V2 doit contenir :

• Les données de la commande
• URL de rappel pour rediriger l'utilisateur après paiement
• En option, l'email ou le numéro fiscal du client pour pré-remplir l'écran Fintoc

📘 Tous les montants doivent être exprimés en centimes. Exemple : 10,50 CLP = 1 050

Exemple de demande

{
  "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. Rediriger l'utilisateur

Une fois l'achat lancé, l'API répond avec une URL de redirection dans le next_action node.

1. Prenez l'URL
2. Redirigez l'utilisateur vers cette URL.
3. L'utilisateur finalise son authentification sur la page Fintoc :
   • Sélectionne sa banque
   • Se connecte avec ses identifiants bancaires en ligne
   • Remplit l'autorisation MFA/contact si sa banque l'exige
   • Confirme le paiement
4. Après authentification, Fintoc redirige l'utilisateur vers votre callback_urls.on_success ou callback_urls.on_error.
5. Écoutez les webhooks DEUNA pour confirmer le statut du paiement final.

Exemple de réponse

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