Getnet SEP | DEUNA Docs

このページで

Getnet SEPとの連携
特別な考慮事項と制限
テストリソース

このページは、DEUNAとのGetnet SEPの統合に関するガイドを提供します。

Supported Operations

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

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

支援された支払方法

カード

Visa
Mastercard
Diners

利用可能な国と通貨

AR (ARS)
MX (MXN)
CL (CLP)
BR (BRL, USD)

要件

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

Client ID
クライアントシークレット

Getnet SEPとの連携#

DEUNAでGetnet SEPを連携

1. 「接続」でGetnet SEPを探す

DEUNA管理画面でGetnet SEPを検索

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

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

決済

接続

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

Acme LATAM · 本番環境

接続を検索

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

2. 自分の店舗でGetnet SEPを設定

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

次の資格情報を入力してください:
- 「名前参照用の名前を入力してください。
- 「通貨商社プロセッサで利用可能な通貨を選択してください。
- 「 Client ID Getnet SEPのクライアントIDを入力
- 「 クライアントシークレット Getnet SEPのクライアントシークレットを入力
- 「 Canal 入力 DN (常にSBXまたはPROD環境)
実行する操作の種類を選択してください:
- 購入
- 認証
3DSを有効にするかどうかを選択してください。
クリック Connect.

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

3. Getnet SEP を使用した決済処理

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

この時点で、DEUNA を通じて Getnet SEP を使用した決済処理を開始できます。

v2 のサンプル

JSON

{
    "payer_info": {
        "email": "omar_guzhnay@gmail.com"
    },
    "order_type": "AIRLINE_ORDER",
    "payment_source": {
        "method_type": "credit_card",
        "card_info": {
            "expiry_month": "03",
            "expiry_year": "2030",
            "card_holder_dni": "",
            "card_holder": "Omar Guzhnay",
            "card_number": "4772133007520635",
            "card_cvv": "737",
            "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": "9517cc3e-ef63-478d-88cc-9a72f690bcdc",
        "currency": "MXN",
        "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": "MXN",
                    "currency_symbol": "$"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "MXN",
                    "currency_symbol": "$"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "MXN",
                    "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": "MXN",
                    "currency_symbol": "$"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "MXN",
                    "currency_symbol": "$"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "MXN",
                    "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_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"
        },
        "airline_information": {
            "bookingItems": [
                {
                    "airline_3_digit_code": "139",
                    "airline_iata_designator": "AM",
                    "pnr": "KFA5001",
                    "ticket_number": "10005001",
                    "e_ticket": true,
                    "ticketing_travel_agency": {
                        "agency_invoice_number": "5001001000000009",
                        "iata_code": "TRA123",
                        "name": "Expedia"
                    },
                    "ancillaries": [
                        {
                            "description": "Premium Meal",
                            "service_category": "c",
                            "ticket_number": "10005001",
                            "total_amount": 100,
                            "type": "Meal"
                        }
                    ],
                    "legs": [
                        {
                            "carrier_code": "AM",
                            "carrier_name": "Aeromexico",
                            "fare_basis_code": "VL7PR",
                            "flight_number": "AM690",
                            "seat_location": "12A",
                            "service_class": "Economy",
                            "stopover_code": "X",
                            "sub_total_amount": 100,
                            "tax_amount": 0,
                            "total_amount": 100,
                            "origin": {
                                "city": "Seattle",
                                "iata_code": "SEA",
                                "date": "2024-02-01",
                                "time": "12:00"
                            },
                            "destination": {
                                "city": "Los Angeles",
                                "iata_code": "LAX",
                                "date": "2024-02-01",
                                "time": "14:30"
                            }
                        },
                        {
                            "carrier_code": "AM",
                            "carrier_name": "Aeromexico",
                            "fare_basis_code": "VL7PR",
                            "flight_number": "AM691",
                            "seat_location": "15F",
                            "service_class": "Economy",
                            "stopover_code": "X",
                            "sub_total_amount": 100,
                            "tax_amount": 0,
                            "total_amount": 100,
                            "origin": {
                                "city": "Los Angeles",
                                "iata_code": "LAX",
                                "date": "2024-02-01",
                                "time": "18:00"
                            },
                            "destination": {
                                "city": "Mexico City",
                                "iata_code": "MEX",
                                "date": "2024-02-01",
                                "time": "23:00"
                            }
                        }
                    ],
                    "passenger": {
                        "user_id": "de9b4c78-4a03-4f20-a2e8-fea47fd1fe0f",
                        "frequent_flyer_code": "51434591833",
                        "country_code": "PE",
                        "document_type": "DNI",
                        "identity_document_number": "07277747",
                        "title": "Mr",
                        "first_name": "Orlando",
                        "middle_name": "Juan",
                        "last_name": "Perez",
                        "email": "user5074@mail.net",
                        "phone": "+14155688537",
                        "date_of_birth": "1985-12-31"
                    }
                },
                {
                    "airline_3_digit_code": "139",
                    "airline_iata_designator": "AM",
                    "pnr": "KFA5002",
                    "ticket_number": "10005002",
                    "e_ticket": true,
                    "ticketing_travel_agency": {
                        "agency_invoice_number": "5001001000000009",
                        "iata_code": "TRA123",
                        "name": "Expedia"
                    },
                    "ancillaries": [
                        {
                            "description": "Premium Meal",
                            "service_category": "c",
                            "ticket_number": "10005001",
                            "total_amount": 100,
                            "type": "Meal"
                        }
                    ],
                    "legs": [
                        {
                            "carrier_code": "AM",
                            "carrier_name": "Aeromexico",
                            "fare_basis_code": "VL7PR",
                            "flight_number": "AM690",
                            "seat_location": "12A",
                            "service_class": "Economy",
                            "stopover_code": "X",
                            "sub_total_amount": 100,
                            "tax_amount": 0,
                            "total_amount": 100,
                            "origin": {
                                "city": "Seattle",
                                "iata_code": "SEA",
                                "date": "2024-02-01",
                                "time": "12:00"
                            },
                            "destination": {
                                "city": "Los Angeles",
                                "iata_code": "LAX",
                                "date": "2024-02-01",
                                "time": "14:30"
                            }
                        },
                        {
                            "carrier_code": "AM",
                            "carrier_name": "Aeromexico",
                            "fare_basis_code": "VL7PR",
                            "flight_number": "AM691",
                            "seat_location": "15F",
                            "service_class": "Economy",
                            "stopover_code": "X",
                            "sub_total_amount": 100,
                            "tax_amount": 0,
                            "total_amount": 100,
                            "origin": {
                                "city": "Los Angeles",
                                "iata_code": "LAX",
                                "date": "2024-02-01",
                                "time": "18:00"
                            },
                            "destination": {
                                "city": "Mexico City",
                                "iata_code": "MEX",
                                "date": "2024-02-01",
                                "time": "23:00"
                            }
                        }
                    ],
                    "passenger": {
                        "user_id": "f5e1b2c3-6d7a-4e9f-8c0d-1a2b3c4d5e6f",
                        "frequent_flyer_code": "98765432109",
                        "country_code": "US",
                        "document_type": "Passport",
                        "identity_document_number": "P12345678",
                        "title": "Ms",
                        "first_name": "Maria",
                        "middle_name": "Isabel",
                        "last_name": "Rodriguez",
                        "email": "maria.rodriguez@example.com",
                        "phone": "+12125551234",
                        "date_of_birth": "1990-05-15"
                    }
                }
            ]
        }
    }
}

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

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"
            }
            
        }
    }
}

特別な考慮事項と制限#

請求先住所

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

billing_address.zipcode
billing_address.state_name
billing_address.country_code

これは、購入者の居住地の税金を徴収するための現地の規制に準拠しています。このデータが提供されない場合、Getnet SEP は、商社の所在地に基づいて税金を徴収します。

国別の ISO コード一覧:

メキシコ州の ISO コード	メキシコ州名
MX-AGU	アグアスカルエンテス
MX-BCN	バハ・カリフォルニア
MX-BCS	バハ・カリフォルニア・スル
MX-CAM	カンペチェ
MX-CHP	Чиапас
MX-CHH	チワワ
MX-CMX	シウダー・デ・メヒコ
MX-COA	コアウイラ
MX-COL	コリマ
MX-DUR	ドゥランゴ
MX-MEX	エスタド・デ・メヒコ
MX-GUA	グアナハト
MX-GRO	Guerrero
MX-HID	Hidalgo
MX-JAL	ジャリスコ
MX-MIC	Michoacán
MX-MOR	Morelos
MX-NAY	Nayarit
MX-NLE	Nuevo León
MX-OAX	Oaxaca
MX-PUE	プエブラ
MX-QUE	Querétaro
MX-ROO	Quintana Roo
MX-SLP	San Luis Potosí
MX-SIN	Sinaloa
MX-SON	Sonora
MX-TAB	Tabasco
MX-TAM	Tamaulipas
MX-TLA	Tlaxcala
MX-VER	Veracruz
MX-YUC	Yucatán
MX-ZAC	Zacatecas

コード ISOの州、アルゼンチン	アルゼンチンの州名
AR-C	CABA
AR-P	Formosa
AR-D	San Luis
AR-E	Entre Ríos
AR-L	La Pampa
AR-A	Salta
AR-H	Chaco
AR-U	Chubut
AR-Y	Jujuy
AR-Z	Santa Cruz
AR-K	Catamarca
AR-X	Cordoba
AR-F	La Rioja
AR-G	Santiago del Estero
AR-J	サン・フアン
AR-M	Mendoza
AR-N	Misiones
AR-Q	Neuquén
AR-R	Rio Negro
AR-V	Tierra del Fuego
AR-B	Buenos Aires
AR-S	Santa Fe
AR-T	Tucumán
AR-W	Corrientes

Código ISO de provincia de Chile	Nombre de provincia de Chile
CL-RM	サンティアゴ首都圏
CL-AN	アンタファガス
CL-AP	アリカ・パリナコタ
CL-AT	アタカマ
CL-AI	アイスン
CL-BI	ビオビオ
CL-CO	コキンボ
CL-AR	ラ・アラウカニア
CL-LL	ロス・ラゴス
CL-LR	ロス・リオス
CL-MA	マガジャネス
CL-ML	Maule
CL-NB	ヌブレ
CL-LI	オヒギンズ
CL-TA	タラパカ
CL-VS	バパロ

ブラジルのISOプロビンコード	ブラジル州名
BR-SP	サンパウロ
BR-RJ	リオデジャネイロ
BR-AC	エーカー
BR-AL	アラゴアス
BR-AP	アマパ
BR-AM	アマゾン
BR-BA	バイシャ
BR-CE	セアラ
BR-DF	連邦区
BR-ES	エスピリト・サント
BR-GO	ゴイアス
BR-MA	マラニョン
BR-MT	マト・グロッソ
BR-MS	マト・グロッソ・ド・スル
BR-MG	ミナスジェライス
BR-PA	パラ
BR-PB	パライバ
BR-PR	パラナ
BR-PE	ペルナンブコ
BR-PI	ピアウイ
BR-RN	リオ・グランデ・ド・ノルテ
BR-RS	リオ・グランデ・ド・スル
BR-RO	Rondônia
BR-RR	ロライマ
BR-SC	サンタカタリーナ
BR-SE	セルジペ
BR-TO	トカンティス

通貨コード: 関連する国のISO 4217コードを指定します。
国コード: ISO国コード
分割回数は、アクイアーとの合意された最大分割回数と一致するように検証されます。
決済は AUTHORIZED 完了できます。
必要に応じて、部分決済を行うことができます。
承認された決済は、完全な決済または部分決済のいずれかに対応します。
注文の承認から5日以内に決済を完了することをお勧めします。これにより、決済の有効期限を回避できます。
返金は、決済が「CAPTURED」状態になった後にのみリクエストできます。 CAPTURED status.
返金は元のキャプチャされた金額を超えない場合がありますが、キャプチャされた金額の一部または全部の返金を行うことができます。
注文ごとに複数の部分払いを行うことができます。
部分払いとは、総取引額よりも少ない金額での払い戻しのことです。
支払いは、以下の条件を満たした場合のみキャンセル（Void）可能です。 AUTHORIZED status.
キャンセルは、決済が「CAPTURED」状態になった後に、もうできません。 CAPTURED status.
完全なキャンセル（void）は、注文ごとに送信できます。
分割回数は、特定の回数にカスタマイズでき、利息なしのオプションや、商社によって定義された手数料を含めることができます。仕組み:
1. 顧客は分割払いを選択できます。「Get Installment API」を通じて、顧客は利用可能な分割払いオプションを取得できます。レスポンスには、利息を除く分割払いの金額と分割回数が含まれます。このサービスは利息率を返しません。これは、直接的に取引機関または発行機関との契約によるものです。
2. DEUNAを介した決済処理 - 弊社は、適切な分割払いと直接PSPとの間で決済処理を行います。
ラテンアメリカでの決済を行う前に、事業所の国で法的法人と決済機関が必要です。
次の acquirer_transaction_id 取引機関によって割り当てられたトランザクション識別子を含むフィールドが、決済のレスポンスで返されます。DEUNAは、GetNet SEPからこの値を取得し、APIレスポンス、ウェブフック、およびトランザクションの詳細など、すべてのトランザクション表面で一貫して公開します。トランザクションの照合、決済に関する問題のトラブルシューティング、または特定のトランザクションについて直接取引機関とやり取りする際に、この識別子を使用してください。

テストリソース#

Postmanコレクション

APIをテストする前に、DEUNAの統合チームから現在のGetnet SEP Postmanコレクションをご依頼ください。

カードテスト

ブランド	フロー	国	カード番号	有効期限（月）	有効期限（年）	CVV
Master	承認済み	MX	5155901222260000	12	2030	123
Visa	承認済み	CL	4042050000001005	12	2030	123
Master	承認済み	BR	5155901222280001	12	2030	123
Visa	承認済み	AR	4042050000001005	12	2030	123
Master	3DS承認	*ALL	5204740000001002	12	2030	123
Master	3DS承認	*ALL	5200000000002151	12	2030	123

拒否テストシナリオ

ブランド	フロー	国	カード番号	有効期限（月）	有効期限（年）	CVV
Master	拒否	MX, CL, AR	5155901222280001	12	2030	123

Amount	拒否
8888.01	カードの有効期限切れ
8888.02	十分な資金
8888.03	引き出し制限を超えた
8888.05	無効なカード番号