Ebanx | DEUNA Docs

このページで

Ebanxを統合
特別な考慮事項と制限
テストリソース

このページは、EbanxをDEUNAプラットフォームに統合するためのガイドを提供します。

Supported Operations

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

認証
完全な決済
部分的な決済
購入（自動キャプチャ）
部分払い戻し（注文あたり1回まで）
全払い戻し
キャンセル
分割払い
3DS DEUNA

支援された支払方法

カード

Visa
Mastercard

利用可能な国と通貨

コスタリカ (CRC, USD)
アルゼンチン (ARS)
ブラジル (BRL, USD)
チリ (CLP)
コロンビア (COP)
Ecuador (USD)
メキシコ (MXN)
ペルー（PEN、USD）
パラグアイ (PYG)
ウルグアイ (UYI, USD)
南アフリカ (ZAR)

要件

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

Ebanxの資格情報

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

Ebanxを統合#

DEUNAにEbanxを統合

1. DEUNA で Ebanx を確認

DEUNAのAdminでEbanxを検索

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

決済

接続

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

Acme LATAM · 本番環境

接続を検索

接続	種類	ステータス
Adyen	決済ゲートウェイ	接続済み
Worldpay	決済ゲートウェイ	接続済み
PayPal	決済方法	接続済み
Mercado Pago	決済方法	接続されていない
Riskified	不正検知エンジン	接続されていない

2. ストアでEbanxを設定

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

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

次の資格情報を入力してください:
- 「名前参照用の名前を入力してください。
- 「通貨商社プロセッサで利用可能な通貨を選択してください。
- 「 ファイル。 Ebanxのプライベートキーを入力してください。
- 「 公開鍵 Ebanxの公開鍵を入力してください。
実行する操作の種類を選択してください:
- 購入
- 認証
3DSを有効にするかどうかを選択してください。
クリック 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.

Proporcione uno de los códigos:

ISO
ローカルの州コード (COMARB)

州コード: COMARB	Código de provincia ISO	Nombre de la provincia
901	AR-C	CABA
909	AR-P	Formosa
919	AR-D	San Luis
908	AR-E	Entre Ríos
911	AR-L	La Pampa
917	AR-A	Salta
906	AR-H	Chaco
907	AR-U	Chubut
910	AR-Y	Jujuy
920	AR-Z	Santa Cruz
903	AR-K	Catamarca
904	AR-X	Cordoba
912	AR-F	La Rioja
922	AR-G	Santiago del Estero
918	AR-J	サン・フアン
913	AR-M	Mendoza
914	AR-N	Misiones
915	AR-Q	Neuquén
916	AR-R	Rio Negro
923	AR-V	Tierra del Fuego
902	AR-B	Buenos Aires
921	AR-S	Santa Fe
924	AR-T	Tucumán
905	AR-W	Corrientes

通貨コード: 関連する国のISO 4217コードを指定します。
国コード: ISO国コード
分割回数は、アクイアーとの合意された最大分割回数と一致するように検証されます。
決済は AUTHORIZED 完了できます。
必要に応じて、部分決済を行うことができます。
承認された決済は、完全な決済または部分決済のいずれかに対応します。
注文の承認から5日以内に決済を完了することをお勧めします。これにより、決済の有効期限を回避できます。
返金は、決済が「CAPTURED」状態になった後にのみリクエストできます。 CAPTURED status.
返金は元のキャプチャされた金額を超えない場合がありますが、キャプチャされた金額の一部または全部の返金を行うことができます。
注文ごとに返金は1回のみ送信できます。
支払いは、以下の条件を満たした場合のみキャンセル（Void）可能です。 AUTHORIZED status.
キャンセルは、決済が「CAPTURED」状態になった後に、もうできません。 CAPTURED status.
完全なキャンセル（void）は、注文ごとに送信できます。
分割回数は、特定の回数にカスタマイズでき、利息なしのオプションや、商社によって定義された手数料を含めることができます。仕組み:
1. 顧客は分割払いを選択します。 "Get Installment API" を使用することで、顧客は利用可能な分割払いオプションを取得できます。応答には、手数料、利息が発生する場合の合計金額、および分割額などの情報が含まれます。
2. DEUNAを介した決済処理 - 弊社は、適切な分割払いと直接PSPとの間で決済処理を行います。
ラテンアメリカでの決済を行うには、事業所の国で法的法人と決済機関が必要です。

テストリソース#

Ebanx の認証情報

ABAP

Private Key
test_ik_L9l0hOg-Qg7xScUGw-QLAA

Public Key
test_pk_AAK0Nzo8Vcp6yuRwYuDu7A

Postmanコレクション

DEUNA の統合チームから、現在の EBANX Postman 環境とコレクションをリクエストしてください。

カードテスト

ブランド	Type	Card Number	有効期限（月）	有効期限（年）	CVV
Visa	承認済み	4111115666052208	12	2026	123
Master	承認済み	5555556355564617	12	2026	123
Visa	拒否	4918019199883839	12	2026	123