Fintoc via Direct API

概要

Fintoc は、ラテンアメリカにおける即時決済方法（アカウント間決済）であり、ユーザーが銀行口座から直接支払うことを可能にします。DEUNA は、Fintoc をリダイレクトモデルを使用して統合します。DEUNA API を通じて購入を開始した後、ユーザーは Fintoc がホストするページにリダイレクトされ、そこで銀行にログインして支払いを認証し、その後、元のサイトにリダイレクトされます。

要件:

チリで利用可能
通貨: CLP (チリ)
ユーザーは、Fintoc をサポートする銀行の有効なアカウントを持っている必要があります。

購入 (バージョン 2)

V2の購入は、注文の作成と支払い開始を単一のエンドポイントで行います。

Fintoc の購入プロセスは以下のとおりです。

ユーザーからの呼び出し POST v2/merchants/order/purchase 注文に関する情報とともに。
DEUNA は注文を作成し、Fintoc トランザクションを開始します。
DEUNA はレスポンスにリダイレクト URL を返します。
ユーザーを Fintoc ページにリダイレクトして、銀行でのログインと認証を完了させます。
認証後、Fintoc はユーザーを元のサイトにリダイレクトします。
DEUNA は、最終的な支払いステータスを確認するために、Fintoc から送信される通知（ウェブフック）を監視します。

API を使用して Fintoc を統合

1. Fintoc を通じて購入

V2の「Purchase」エンドポイントへのリクエストを送信してください。 V2 Purchase endpoint.

DEUNA で Fintoc を使用して購入を行うには、V2 パイロードには以下の内容を含める必要があります。

注文データ
支払い完了後にユーザーをリダイレクトするためのコールバックURL
オプションで、顧客のメールアドレスまたは税務IDを、Fintoc 画面を事前に入力するために使用

📘 すべての金額はセント単位で表現する必要があります。例: 10.50 CLP = 1050

リクエスト例

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. ユーザーをリダイレクトする

購入が開始された後、APIはレスポンスとしてリダイレクトURLを返します。 next_action node.

指定されたURLを取得する。
ユーザーをそのURLにリダイレクトする。
ユーザーは Fintoc ページで認証を完了します。
- 銀行を選択
- オンラインバンキングの資格情報でログイン
- 銀行が要求する場合は、MFA/連絡による承認を完了
- 支払いを承認
認証後、Fintoc はユーザーを元のサイトにリダイレクトします。 callback_urls.on_success または callback_urls.on_error.
最終決済ステータスの確認には、DEUNAのウェブフックを監視してください。

応答例

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