メインコンテンツへスキップ
このページで

このページは、Ebanx LocalをDEUNAに統合する方法を説明しています。

Supported Operations

EbanxをDEUNAの支払い戦略に統合すると、次の操作を実行できます。

  • 認証
  • フルキャプチャ
  • キャンセル
  • 購入(自動キャプチャ)
  • 部分払い戻し(注文あたり1回まで)
  • 全払い戻し
  • 分割払い

利用可能な国と通貨

  • ブラジル、チリ、コロンビア、メキシコ。

要件

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

  • Ebanxの資格情報

アカウントがEbanx側で適切に構成されていることを確認してください。

Ebanxを統合#

DEUNAにEbanxを統合

1. DEUNAでEbanx Localを探す

DEUNAのAdminでEbanxを検索

インタラクティブな例サンプルデータを使用し、APIリクエストは行いません。
本番環境
決済

接続

決済、ウォレット、および不正検知の統合を発見および管理します。

Acme LATAM · 本番環境
5 サンプル接続直前に更新
接続種類ステータスアクション
Adyen決済ゲートウェイ接続済み
Worldpay決済ゲートウェイ接続済み
PayPal決済方法接続済み
Mercado Pago決済方法接続されていない
Riskified不正検知エンジン接続されていない

2. ストアでEbanxを設定

ConnectionsでEbanxを検索した後、ストアでEbanxを設定する必要があります。

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

  1. 次の資格情報を入力してください:
    • 「 名前 参照用の名前を入力してください。
    • 「 通貨 商社プロセッサで利用可能な通貨を選択してください。
    • 「 ファイル。 Ebanxのプライベートキーを入力してください。
    • 「 公開鍵 Ebanxの公開鍵を入力してください。
  2. クリック Connect.

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

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

Ebanxの接続は「アクティブな接続」タブに表示されます。

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

V2 Purchase

JSON
{
    "payer_info": {
        "email": "omar_guzhnay@gmail.com"
    },
    "order_type": "DEUNA_NOW",
    "payment_source": {
        "method_type": "credit_card",
        "card_info": {
            "expiry_month": "01",
            "expiry_year": "2029",
            "card_holder_dni": "",
            "card_holder": "Omar Guzhnay",
            "card_number": "4111115666052208",
            "card_cvv": "123",
            "address1": "Jose Luis Lagrange 123, Piso 12",
            "address2": "Polanco I Sección",
            "zip": "11510",
            "city": "MIGUEL HIDALGO",
            "state": "CIUDAD DE MÉXICO",
            "country": "MX",
            "phone": "+5930962917328",
            "installments": 1
        }
    },
    "order": {
        "order_id": "12c4f9bb-3128-4fb5-b99a-4e38569c69b5",
        "currency": "CRC",
        "statement_descriptor":"test",
        "market_type": "ecommerce",
        "items": [
            {
                "id": "00ab2d23-f44a-4782-aa7c-bb4fadeddfe3",
                "name": "Item #1",
                "description": "Description Item #1",
                "total_amount": {
                    "original_amount": 115000,
                    "amount": 115000,
                    "total_discount": 0,
                    "currency": "CRC",
                    "currency_symbol": "₡"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "CRC",
                    "currency_symbol": "₡"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "CRC",
                    "currency_symbol": "₡"
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            },
            {
                "id": "3cb41aec-1be8-4255-a386-94bb316a8157",
                "name": "Item #2",
                "description": "Description Item #2",
                "total_amount": {
                    "original_amount": 115000,
                    "amount": 115000,
                    "total_discount": 0,
                    "currency": "CRC",
                    "currency_symbol": "₡"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "CRC",
                    "currency_symbol": "₡"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "CRC",
                    "currency_symbol": "₡"
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            }
        ],
        "sub_total": 200000,
        "tax_amount": 30000,
        "total_tax_amount": 30000,
        "total_amount": 230000,
        "store_code": "all",
        "billing_address": {
            "id": "4255",
            "first_name": "Omar",
            "last_name": "Guzhnay",
            "email": "omar_guzhnay@gmail.com",
            "address1": "Jose Luis Lagrange 123, Piso 12",
            "address2": "Polanco I Sección",
            "zipcode": "11510",
            "city": "MIGUEL HIDALGO",
            "state_code": "CDMX",
            "state_name": "CIUDAD DE MÉXICO",
            "country_code": "CR",
            "identity_document": "120597333",
            "identity_document_type": "",
            "phone": "+5930962917328",
            "lat": -22.943934,
            "lng": -43.182984,
            "additional_description": "confirm",
            "address_type": "home"
        }
    }
}

分割払いオプションを含むリクエスト

JSON
{
    "transaction_id": "b54e3150-5fad-475d-892b-b13dbdbb99d4",
    "amount": 230009,
    "device_id": "f98c0141-dd96-4724-9e9a-c2c637307845",
    "order_token": "c000fbf0-2e86-4f4b-a1bb-223f80bbe477",
    "payer_info": {
        "email": "omar_guzhnay@gmail.com"
    },
    "payment_source": {
        "method_type": "credit_card",
        "card_info": {
            "expiry_month": "01",
            "expiry_year": "2029",
            "card_holder_dni": "",
            "card_holder": "Omar Guzhnay",
            "card_number": "4111115666052208",
            "card_cvv": "123",
            "address1": "Jose Luis Lagrange 123, Piso 12",
            "address2": "Polanco I Sección",
            "zip": "11510",
            "city": "MIGUEL HIDALGO",
            "state": "CIUDAD DE MÉXICO",
            "country": "MX",
            "phone": "+5930962917328",
            "installment": {
                "plan_option_id": "6d8d4c4a-26c7-49a1-b92c-9fd89ea39323"
            }
            
        }
    }
}

特別な考慮事項と制限#

請求先住所

Ebanxによって取得された国内取引には、次の顧客情報が承認リクエストに含まれている必要があります。

  • billing_address.zipcode
  • billing_address.state_name
  • billing_address.country_code

Esto cumple con la regulación local para retener impuestos en la provincia del comprador. Cuando estos datos no se proporcionan, Ebanx retiene impuestos según la ubicación del comerciante.

  1. 通貨コード: 関連する国のISO 4217コードを指定します。
  2. 国コード: ISO国コード
  3. 分割回数は、アクイアーとの合意された最大分割回数と一致するように検証されます。
  4. EBANXは部分キャプチャをサポートしていません。
  5. 返金は、決済が「CAPTURED」状態になった後にのみリクエストできます。 CAPTURED status.
  6. 返金は元のキャプチャされた金額を超えない場合がありますが、キャプチャされた金額の一部または全部の返金を行うことができます。
  7. 注文ごとに返金は1回のみ送信できます。
  8. 支払いは、以下の条件を満たした場合のみキャンセル(Void)可能です。 AUTHORIZED status.
  9. キャンセルは、決済が「CAPTURED」状態になった後に、もうできません。 CAPTURED status.
  10. 完全なキャンセル(void)は、注文ごとに送信できます。
  11. 分割回数は、特定の回数にカスタマイズでき、利息なしのオプションや、商社によって定義された手数料を含めることができます。 仕組み:
    1. 顧客は分割払いを選択します。 "Get Installment API" を使用することで、顧客は利用可能な分割払いオプションを取得できます。 応答には、手数料、利息が発生する場合の合計金額、および分割額などの情報が含まれます。
    2. DEUNAを介した決済処理 - 弊社は、適切な分割払いと直接PSPとの間で決済処理を行います。