Transbank | DEUNA Docs

このページで

Integrar Transbank
特別な考慮事項と制限

Supported Operations

DEUNAとのTransbank統合により、次の操作を実行できます。

購入
認証^*
完全な決済^*
部分的な決済^*
部分払い戻し
全払い戻し
キャンセル^*
分割払い

支援された支払方法

カード

Visa
Mastercard
Amex

利用可能な国と通貨

チリ (CLP)

要件

Transbankの担当者に連絡し、次の資格情報をリクエストしてください。

APIキーシークレット（Tbk-Api-Key-Secret)
商 ID (Tbk-Api-Key-Id)

Integrar Transbank#

「Connections」で Transbank を検索した後、ストアで接続を設定する必要があります。

1. ストアで Transbank を設定

Connectionsでは、次のウィンドウが開きます。

次の資格情報を入力してください:
- 「名前参照用の名前を入力してください。
- 「通貨商社プロセッサで利用可能な通貨を選択してください。
- 「 Commerce ID Transbank の商 ID を入力してください (Tbk-Api-Key-Id).
- 「 ファイル。 Transbank の API Key Secret を入力してください (Tbk-Api-Key-Secret).
- 「 ストア Transbank のストアコード (tienda) を入力してください (Transbank を介して処理する場合) Transacción Completa Mall。そうでない場合は、このパラメータを空にします。
実行する操作の種類を選択してください:
- 購入
- 認証
情報
この操作をサポートするために、ゲートウェイでこれらの認証情報を事前に設定する必要があります。
クリック Connect.

手順を完了すると、成功メッセージが表示されます。

3. Transbank を使用した決済処理

次に、Transbank の接続が「Active Connections」タブに表示されます。

この時点で、DEUNA を通じて Transbank を使用した取引を開始できます。

v2 のサンプル

JSON

{
  "payer_info": {
    "email": "test_chile@testuser.com",
    "date_of_birth": "1990-08-30T16:00:00.000Z"
  },
  "payment_source": {
    "method_type": "credit_card",
    "card_info": {
      "card_number": "4051885600446623",
      "card_holder": "JUAN PÉREZ",
      "expiry_month": "08",
      "expiry_year": "30",
      "card_cvv": "123",
      "card_holder_dni": "12.345.678-5",
      "zip": "8320000",
      "city": "Santiago",
      "address1": "Av. Apoquindo 3000",
      "state": "Región Metropolitana",
      "phone": "+56228901234",
      "country": "CL"
    }
  },
  "order": {
    "order_id": "fee5036f-8251-4101-8ecc-74259e6e040b",
    
    "currency": "CLP",
    "items": [
      {
        "id": "TK001",
        "name": "Tiquete Aéreo Santiago - Antofagasta",
        "description": "Vuelo LATAM LA128 • Clase Economy",
        "options": "Equipaje de mano incluido",
        "total_amount": {
          "original_amount": 459900,
          "amount": 459900,
          "currency": "CLP",
          "currency_symbol": "$"
        },
        "unit_price": {
          "amount": 459900,
          "currency": "CLP",
          "currency_symbol": "$"
        },
        "tax_amount": {
          "amount": 0,
          "currency": "CLP",
          "currency_symbol": "$"
        },
        "quantity": 1,
        "uom": "ticket",
        "upc": "",
        "sku": "TKT-SCL-ANF-ECON",
        "isbn": "",
        "brand": "LATAM",
        "manufacturer": "",
        "category": "Aereo",
        "color": "",
        "size": "",
        "weight": {
          "amount": 0,
          "unit": "kg"
        },
        "image_url": "https://upload.wikimedia.org/wikipedia/commons/thumb/8/8a/LATAM_Airlines_logo.svg/512px-LATAM_Airlines_logo.svg.png",
        "details_url": "",
        "type": "service",
        "taxable": true
      }
    ],
    "sub_total": 45990000,
    "total_amount": 45990000,
    "store_code": "all",
    "billing_address": {
      "address1": "Av. Apoquindo 3000",
      "address2": "Oficina 1205",
      "address_type": "office",
      "city": "Santiago",
      "country_code": "CL",
      "email": "test_chile@testuser.com",
      "first_name": "Juan",
      "last_name": "Pérez",
      "identity_document": "12.345.678-5",
      "identity_document_type": "RUT",
      "is_default": true,
      "phone": "+56228901234",
      "state_code": "RM",
      "state_name": "Región Metropolitana",
      "zipcode": "8320000"
    },
    "shipping_address": {
      "address1": "Av. Apoquindo 3000",
      "address2": "Oficina 1205",
      "address_type": "office",
      "city": "Santiago",
      "country_code": "CL",
      "email": "test_chile@testuser.com",
      "first_name": "Juan",
      "last_name": "Pérez",
      "identity_document": "12.345.678-5",
      "identity_document_type": "RUT",
      "is_default": true,
      "phone": "+56228901234",
      "state_code": "RM",
      "state_name": "Región Metropolitana",
      "zipcode": "8320000"
    }
  }
}

特別な考慮事項と制限#

Transbank は、注文識別子として最大 26 文字しかサポートしていないため、注文 ID order_id パラメータを要件に合わせて変換します。そのため、DEUNA から送信されたものとは異なる ID が表示される場合があります。
分割回数は、アクイアーとの合意された最大分割回数と一致するように検証されます。
Authorization、Capture（full and partial）および voidを使用するには、商人はTransbankで 保留払い.
決済は AUTHORIZED 完了できます。
必要に応じて、部分決済を行うことができます。
承認された決済は、完全な決済または部分決済のいずれかに対応します。
注文の承認から5日以内に決済を完了することをお勧めします。これにより、決済の有効期限を回避できます。
返金は、決済が「CAPTURED」状態になった後にのみリクエストできます。 CAPTURED または PROCESSED status.
返金は元のキャプチャされた金額を超えない場合がありますが、キャプチャされた金額の一部または全部の返金を行うことができます。
注文ごとに複数の部分払いを行うことができます。
支払いは、以下の条件を満たした場合のみキャンセル（Void）可能です。 AUTHORIZED status.
キャンセルは、決済が「CAPTURED」状態になった後に、もうできません。 CAPTURED status.
完全なキャンセル（void）は、注文ごとに送信できます。