PayU
このページは、DEUNA との PayU の統合に関するガイドを提供します。
このページで
Supported Operations
DEUNA との PayU の統合により、以下の操作を実行できます。
- 認証
- 完全な決済
- 部分的な決済
- 購入（自動キャプチャ）
- 部分払い戻し（注文あたり1回まで）
- 全払い戻し
- キャンセル
- 分割払い
- 3DS DEUNA
- PSP との連携による 3DS
支援された支払方法
カード
- Visa
- Mastercard
- Diners
- Amex
利用可能な国と通貨
- コロンビア (COL)
- アルゼンチン (ARS)
- ペルー（PEN、USD）
- パナマ（USD）
要件
PayU の担当者に連絡し、以下の認証情報を取得してください。
- PayUの認証情報
PayU の統合#
Connections で PayU を検索した後、ストアで PayU を設定する必要があります。
1. ストアで PayU を設定
Connectionsでは、次のウィンドウが開きます。
- 次の資格情報を入力してください:
- 「 名前 参照用の名前を入力してください。
- 「 通貨 商社プロセッサで利用可能な通貨を選択してください。
- 「 Merchant ID PayU の Merchant ID を入力してください。
- 「 APIキー PayU の API キーを入力してください。
- 「 APIログイン PayU APIへのログイン情報を入力してください。
- 「 Account ID PayUの口座IDを入力してください。
- 入力された認証情報が選択と互換性がある必要があります。
- 実行する操作の種類を選択してください:
- 購入
- 認証
- 以下のいずれかを選択してください。 複数の部分的な払い戻し.
- 以下のいずれかを選択してください。 3DS DEUNAまたはPSPを通じて
- クリック Connect.
手順を完了すると、成功メッセージが表示されます。
3. PayUでの支払い処理
次に、PayUの接続を「Active Connections」タブで確認できます。
この時点で、DEUNAを通じてPayUでの取引処理が可能になります。
v2 のサンプル
JSON
{
"payer_info": {
"email": "omar_guzhnay@gmail.com"
},
"order_type": "AIRLINE_ORDER",
"payment_source": {
"method_type": "credit_card",
"card_info": {
"expiry_month": "01",
"expiry_year": "2029",
"card_holder_dni": "",
"card_holder": "Omar Guzhnay",
"card_number": "5555556355564617",
"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": "5930962917",
"installments": "1"
}
},
"order": {
"order_id": "4cac429d-68e5-44da-a12d-1571dbb43537",
"currency": "ARS",
"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": "ARS",
"currency_symbol": "$"
},
"unit_price": {
"amount": 100000,
"currency": "ARS",
"currency_symbol": "$"
},
"tax_amount": {
"amount": 15000,
"currency": "ARS",
"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": "ARS",
"currency_symbol": "$"
},
"unit_price": {
"amount": 100000,
"currency": "ARS",
"currency_symbol": "$"
},
"tax_amount": {
"amount": 15000,
"currency": "ARS",
"currency_symbol": "$"
},
"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": "Buenos Aires",
"state_code": "AR-B",
"state_name": "Buenos Aires",
"country_code": "AR",
"identity_document": "30123456",
"identity_document_type": "",
"phone": "5930962917",
"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"
}
}
]
}
}
}特別な考慮事項と制限#
請求先住所
PayUによって取得された国内取引には、購入者の billing_address.zipcode, billing_address.state-name, billing_address.country_code を承認リクエストに含める必要があります。これは、購入者の居住地の税金徴収に関する地域の規制に準拠したものです。このデータが提供されない場合、PayUは商人の所在地に基づいて税金を徴収します。
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+2期間以降に適用できます。
- 支払いは、以下の条件を満たした場合のみキャンセル（Void）可能です。 AUTHORIZED status.
- キャンセルは、決済が「CAPTURED」状態になった後に、もうできません。 CAPTURED status.
- 完全なキャンセル（void）は、注文ごとに送信できます。
- 分割回数は、特定の回数にカスタマイズでき、利息なしのオプションや、商社によって定義された手数料を含めることができます。 仕組み:
- 顧客は分割払いを選択できます。「Get Installment API」を通じて、顧客は利用可能な分割払いオプションを取得できます。 レスポンスには、利息を除く分割払いの金額と分割回数が含まれます。このサービスは利息率を返しません。これは、直接的に取引機関または発行機関との契約によるものです。
- DEUNAを介した決済処理 - 弊社は、適切な分割払いと直接PSPとの間で決済処理を行います。
- 以下のトランザクションを利用する
card_idPSPによるトークン化を使用するため、カード確認値（CVV）を指定せずに処理されます。 - ラテンアメリカでの決済を行うには、事業所の国で法的法人と決済機関が必要です。
不正行為分析
- PayUは、高い承認率と制御されたチャージバックを維持するための不正行為対策機能を備えています。
- PayUによって疑わしいと判断された取引は、PayUが手動でレビューを行う間、Deunaに「支払い処理中」として残ります。
- PayUが分析を完了すると、Deunaは支払いステータスを「処理中」から「処理済み」または「拒否」に変更し、ウェブフックを通じて商人にこの変更を通知します。
- この機能には、以下の情報が必要です。
- デバイスフィンガープリント。詳細については、 セクション を参照してください。
- 電子商取引: 請求、配送、航空券の詳細
- 航空券注文: PNR、旅程情報、乗客の詳細
- 同様に、PayUは、商人のウェブサイトに購入者のセッションIDが必要です。PayUは、Merchant Session Cookie（通常は「セッションID」と呼ばれます）を期待しています。これは、ウェブサイトが訪問者のショッピングカートまたはログイン状態を追跡するために割り当てる一意の識別子です。
- 名前は、ウェブサイトが使用している技術によって異なります。
- PHP / Magento / WooCommerce: PHPSESSID
- Java / Spring: JSESSIONID
- Node.js: connect.sid
- ASP.NET: ASP.NET_SessionId
- VTEX / Shopify: 多くの場合、checkout、cart_token、または _shopify_s という名前で指定されます。
- ウェブサイトで sessionID を見つけるには？
- 「Inspect」を選択し、アプリケーションまたはストレージで「cookies」フォルダを探します。
- ウェブサイトを選択し、「Name」列で、使用しているテクノロジーに一致するものを探します（例：PHPSESSID）。
- 「Value」列にある文字列が、送信する必要があるもの（通常はUUID）です。
- 名前は、ウェブサイトが使用している技術によって異なります。
- この情報を Deuna に送信するには？
-
- 購入 (バージョン 2)
- metadata.additional_data.cookie
- 購入 (バージョン 2)
- オプション 1: anti_fraud_info.cookies[].value
- オプション 2: metadata.additional_data.cookie
- 購入 (バージョン 2)