Niubiz | DEUNA Docs

このページで

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

このページは、Niubiz を DEUNA と統合するためのガイドを提供します。

Supported Operations

DEUNA との Niubiz 統合により、以下の操作を実行できます。

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

支援された支払方法

カード

Visa
Mastercard
Diners
Amex

利用可能な国と通貨

ペルー（PEN、USD）

要件

Niubiz の担当者に連絡し、以下の Niubiz 認証情報をリクエストしてください。

Niubiz 商社コード
ユーザー名
パスワード
RUC

テストには、以下の認証情報を利用できます。

MerchantCode: 456879852
Username: integraciones@niubiz.com.pe
Password: _7z3@8fF
RUC: 10119228282

Niubiz の統合#

DEUNA で Niubiz を統合します。

1. Connections で Niubiz を検索

DEUNA AdminでNiubizを検索

Inicie sesión en su sesión de administración de DEUNA.
クリック接続.
Niubiz の結果をクリック Connect.

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

決済

接続

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

Acme LATAM · 本番環境

接続を検索

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

2. ストアで Niubiz を設定

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

次の資格情報を入力してください:
- 「名前参照用の名前を入力してください。
- 「通貨商社プロセッサで利用可能な通貨を選択してください。
- 「 Merchant Code Niubiz の商社コードを入力
- 「 ユーザー名 Niubiz のユーザー名を入力
- 「 パスワード Niubiz のパスワードを入力
- 「 RUC Niubiz の RUC を入力
実行する操作の種類を選択してください:
- 購入
- 認証
PSP を使用したトークン化を有効にするかどうかを選択してください。
3DSを有効にするかどうかを選択してください。
クリック Connect.

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

3. Niubizで支払いを処理する

「Active Connections」タブにNiubiz接続が表示されます。

これ以降、DEUNAを通じてNiubizの取引を処理できます。

v2 のサンプル

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": "4551708161768059",
            "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": "4d7b64fe-8f2f-4f85-b982-29ba54305a73",
        "currency": "PEN",
        "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": "PEN",
                    "currency_symbol": "s/."
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "PEN",
                    "currency_symbol": "s/."
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "PEN",
                    "currency_symbol": "s/."
                },
                "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": "PEN",
                    "currency_symbol": "s/."
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "PEN",
                    "currency_symbol": "s/."
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "PEN",
                    "currency_symbol": "s/."
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            }
        ],
        "sub_total": 200000,
        "tax_amount": 30009,
        "total_tax_amount": 30009,
        "total_amount": 230009,
        "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": "{{state_code}}",
            "state_name": "CIUDAD DE MÉXICO",
            "country_code": "MX",
            "identity_document": "1205973330",
            "identity_document_type": "",
            "phone": "+5930962917328",
            "lat": -22.943934,
            "lng": -43.182984,
            "additional_description": "confirm",
            "address_type": "home"
        }
    }
}

カード ID (PSP トークン化) を含むリクエスト

JSON

{
    "payer_info": {
        "email": "omar_guzhnay@gmail.com"
    },
    "order_type": "DEUNA_CHECKOUT",
    "payment_source": {
        "method_type": "credit_card",
        "card_info": {
            "card_id": "55545067-6a87-416c-f44a-4782-aa7c",
            "card_cvv": "123"
        }
    },
    "order": {
        "order_id": "52385067-6a87-416c-80fa-6394d03b0945",
        "currency": "PEN",
        "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": "PEN",
                    "currency_symbol": "s/."
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "PEN",
                    "currency_symbol": "s/."
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "PEN",
                    "currency_symbol": "s/."
                },
                "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": "PEN",
                    "currency_symbol": "s/."
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "PEN",
                    "currency_symbol": "s/."
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "PEN",
                    "currency_symbol": "s/."
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            }
        ],
        "sub_total": 200000,
        "tax_amount": 30009,
        "total_tax_amount": 30009,
        "total_amount": 230009,
        "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": "{{state_code}}",
            "state_name": "CIUDAD DE MÉXICO",
            "country_code": "MX",
            "identity_document": "1205973330",
            "identity_document_type": "",
            "phone": "+5930962917328",
            "lat": -22.943934,
            "lng": -43.182984,
            "additional_description": "confirm",
            "address_type": "home"
        },
        "shipping_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": "{{state_code}}",
            "state_name": "{{state_code}}",
            "country_code": "MX",
            "identity_document": "1205973330",
            "identity_document_type": "",
            "phone": "+5930962917328",
            "lat": -22.943934,
            "lng": -43.182984,
            "additional_description": "confirm",
            "address_type": "home"
        }
    }
}

Запрос с примером вариантов плана оплаты

JSON

{
    "transaction_id": "32e61625-6586-4392-8d03-1745901bd9e6",
    "amount": 230009,
    "device_id": "2128b31d-c7c1-46d1-83fa-3fc545dbbeb4",
    "order_token": "4a64f32b-5086-4199-9e0e-c9ec1f54e93a",
    "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": "4772133007520635",
            "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": "ff1c4600-f3ef-4a9e-918a-95468ac1216a"
            }
            
        }
    }
}

特別な考慮事項と制限#

請求先住所

Niubizが処理する国内取引では、承認リクエストに次の購入者情報を含める必要があります：

billing_address.zipcode
billing_address.state_name
billing_address.country_code

これは購入者の州で源泉徴収を行う現地規制に準拠するものです。この情報がない場合、Niubizは加盟店の所在地に基づいて源泉徴収します。

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.
返金は元のキャプチャされた金額を超えない場合がありますが、キャプチャされた金額の一部または全部の返金を行うことができます。
注文ごとに複数の部分払いを行うことができます。
取引総額を下回る一部返金は、決済後（午前0時以降）のT+1から実行できます。
American Express、Diners、Discoverカードでは、T+1以降の返金はできません。ただし、当日中の返金は可能です。
支払いは、以下の条件を満たした場合のみキャンセル（Void）可能です。 AUTHORIZED status.
キャンセルは、決済が「CAPTURED」状態になった後に、もうできません。 CAPTURED status.
完全なキャンセル（void）は、注文ごとに送信できます。
分割回数は、特定の回数にカスタマイズでき、利息なしのオプションや、商社によって定義された手数料を含めることができます。仕組み:
1. 顧客は分割払いを選択できます。「Get Installment API」を通じて、顧客は利用可能な分割払いオプションを取得できます。レスポンスには、利息を除く分割払いの金額と分割回数が含まれます。このサービスは利息率を返しません。これは、直接的に取引機関または発行機関との契約によるものです。
2. DEUNAを介した決済処理 - 弊社は、適切な分割払いと直接PSPとの間で決済処理を行います。
以下のトランザクションを利用する card_id PSPによるトークン化を使用するため、カード確認値（CVV）を指定せずに処理されます。
ラテンアメリカでの決済を行うには、事業所の国で法的法人と決済機関が必要です。

テストリソース#

Niubizの認証情報

ABAP

RUC *
10119228282

Username *
integraciones@niubiz.com.pe

Password *
_7z3@8fF

MerchantCode *
456879852

Postmanコレクション

APIをテストする前に、DEUNA統合チームから最新のNiubiz Postmanコレクションを入手してください。

カードテスト

ブランド	Type	カード番号	有効期限（月）	有効期限（年）	CVV
Visa	承認済み	4551708161768059	12	2030	123
Visa	拒否	4024007126919058	12	2030	111
Master	承認済み	5160030000000317	03	2028	111
Diners	承認済み	36006616055724	04	2026	111
Amex	承認済み	371064649323968	03	2028	111
Visa	承認済み（トークン化用）	4005520000000129	01	2029	123