PagBank | DEUNA Docs

このページで

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

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

Supported Operations

DEUNA と PagBank を統合することで、次の操作を実行できます。

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

支援された支払方法

カード:

Visa
Mastercard
Diners
Amex
Elo

利用可能な国と通貨

Brasil (BRL)

要件

Pagbankの担当者に連絡し、以下の認証情報を取得してください。

PagBank の認証情報

Pagbank 側でアカウントが正しく設定されていることを確認してください。

Pagbank の統合#

DEUNAへのPagBank統合

1. DEUNA で Pagbank を検索

DEUNA の管理画面で PagBank の接続を探し、クリックします。

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

決済

接続

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

Acme LATAM · 本番環境

接続を検索

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

2. ストアで PagBank を構成

Connections で Pagbank を検索した後、ストアで Pagbank を構成する必要があります。

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

次の資格情報を入力してください:
- 「名前参照用の名前を入力してください。
- 「通貨商社プロセッサで利用可能な通貨を選択してください。
- 「 Merchant ID ID を入力して、認証情報を参照します。
- 「 ファイル。 Pagbank のプライベートキーを入力します。
実行する操作の種類を選択してください:
- 購入
- 認証
PagBank の API Connect を通じて接続を有効にするには、次のことを確認してください。 Deuna の認証情報 checkbox.
3DSを有効にするかどうかを選択してください。
クリック Connect.

3. API を通じて PagBank を承認

PagBank の API Connect を使用して接続する場合は:

Deuna ポータルは、接続を完了するために Pagbank ポータルにリダイレクトされます。
PagBank のユーザー名とパスワードを入力します。

アカウントにログインした後、接続の許可を承認します。

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

4. PagBank で支払い処理

Active Connections タブに Pagbank の接続が表示されます。

ここから、DEUNA を通じて Pagbank を使用した取引処理を開始できます。

V2 購入

JSON

{
    "payer_info": {
        "email": "omar_guzhnay@gmail.com"
    },
    "order_type": "DEUNA_NOW",
    "payment_source": {
        "method_type": "credit_card",
        "card_info": {
            "expiry_month": "12",
            "expiry_year": "2026",
            "card_holder_dni": "12345678000195",
            "card_holder": "Omar Guzhnay",
            "card_number": "4024007197692931",
            "card_cvv": "123",
            "address1": "Rua Visconde de Pirajá, 123, apto 12",
            "address2": "apto 12",
            "zip": "22410001",
            "city": "MIGUEL HIDALGO",
            "state": "CIUDAD DE MÉXICO",
            "country": "BR",
            "phone": "+5511985176644",
            "installments": 1
        }
    },
    "order": {
        "order_id": "a7c1d6c6-9a36-49b1-8cee-dd5434f3d270",
        "currency": "BRL",
        "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": "BRL",
                    "currency_symbol": "R$"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "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": "BRL",
                    "currency_symbol": "R$"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "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": "Rua Visconde de Pirajá, 123, apto 12",
            "address2": "apto 12",
            "zipcode": "22410001",
            "city": "Rio de Janeiro",
            "state_code": "RJ",
            "state_name": "Rio de Janeiro",
            "country_code": "BR",
            "identity_document": "12345678000195",
            "identity_document_type": "CNPJ",
            "phone": "+5511985176644",
            "lat": -22.943934,
            "lng": -43.182984,
            "additional_description": "confirm",
            "address_type": "home"
        }
    }
}

リクエストで繰り返し処理

JSON

{
    "payer_info": {
        "email": "omar_guzhnay@gmail.com"
    },
    "order_type": "DEUNA_NOW",
    "payment_source": {
        "method_type": "credit_card",
        "card_info": {
            "expiry_month": "12",
            "expiry_year": "2026",
            "card_holder_dni": "12345678000195",
            "card_holder": "Omar Guzhnay",
            "card_number": "4024007197692931",
            "card_cvv": "123",
            "address1": "Rua Visconde de Pirajá, 123, apto 12",
            "address2": "apto 12",
            "zip": "22410001",
            "city": "MIGUEL HIDALGO",
            "state": "CIUDAD DE MÉXICO",
            "country": "BR",
            "phone": "+5511985176644",
            "installments": 1
        }
    },
    "order": {
        "order_id": "6eab785f-c0c6-4e04-9021-b296b8a36611",
        "currency": "BRL",
        "statement_descriptor":"test",
        "market_type": "ecommerce",
        "recurrence": {
            "first_time_use": true   //true = first or false=subsequent
        },
        "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": "BRL",
                    "currency_symbol": "R$"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "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": "BRL",
                    "currency_symbol": "R$"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "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": "Rua Visconde de Pirajá, 123, apto 12",
            "address2": "apto 12",
            "zipcode": "22410001",
            "city": "Rio de Janeiro",
            "state_code": "RJ",
            "state_name": "Rio de Janeiro",
            "country_code": "BR",
            "identity_document": "12345678000195",
            "identity_document_type": "CNPJ",
            "phone": "+5511985176644",
            "lat": -22.943934,
            "lng": -43.182984,
            "additional_description": "confirm",
            "address_type": "home"
        }
    }
}

特別な考慮事項と制限#

請求先住所

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

billing_address.zipcode
billing_address.state_name
billing_address.country_code

これは、購入者の居住地の税法に従って税金を徴収するものです。この情報が提供されない場合、PagBankは、販売者の所在地に基づいて税金を徴収します。

Proporcione uno de los códigos:

ローカルの州コード (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）は、注文ごとに送信できます。
Pedidos con el recurrence campo "first payment" diferenciando entre el primer y los pagos posteriores.
1. El primer pago se categoriza por tipo recurrence.first_time_use = true.
2. 後続の支払いは、種類によって識別されます。 recurrence.first_time_use = false.
3. 注: パラメータの追加 recurrence.first_time_use Recurring Payment API との連携や依存関係はありません。
ラテンアメリカでの決済を行うには、事業所の国で法的法人と決済機関が必要です。

テストリソース#

Credenciales de Pagbank

ABAP

Private_Key = 
"44167361-1afc-444a-8c4b-4de444b9387a072451e54f40a400c2e292867b9e2f64a825-39f7-4443-ac02-6d7c42b5104d"

Postmanコレクション

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

カードテスト

ブランド	Type	Card Number	有効期限（月）	有効期限（年）	CVV
Visa	承認済み	4024007197692931	12	2026	123
Master	承認済み	5555666677778884	12	2026	123
Visa	拒否	4929291898380766	12	2026	123
Master	拒否	5530062640663264	12	2026	123