Worldpay
Worldpay を DEUNA に接続し、支払い通知を設定し、公開前に完全な支払いフローを確認します。
このページで
DEUNA Admin で Worldpay アカウントを接続し、トランザクション更新を DEUNA に送信するように Worldpay を構成します。どちらの手順も重要です。接続を保存すると認証情報が追加され、通知によって処理後に DEUNA が支払い結果を調整できるようになります。
始める前に#
加盟店や店舗の決済接続を管理する方を対象としたガイドです。DEUNA Adminの「接続」とWorldpay Merchant Administration Interface(MAI)へのアクセスが必要です。利用できない場合は、アカウント管理者にアクセスを依頼してください。
アカウントと認証情報を確認します
構成している環境に次のものを準備します。
- 有効な Worldpay アカウントとそのマーチャント ID。
- WorldpayのXML接続認証情報。DEUNAで秘密キーと公開キーとして表示される値を含みます。
- 通知の設定に使用するWorldpay MAIのログイン認証情報。
- DEUNA 接続が作成される販売者または店舗へのアクセス。
これらの認証情報を Worldpay の担当者にリクエストしてください。資格情報が選択した操作と環境をサポートしていることを確認します。 MAI ログイン資格情報と XML 接続資格情報は、異なる目的を果たします。接続資格情報は DEUNA Admin にのみ入力し、チェックアウト コード、スクリーンショット、サポート メッセージには入力しないでください。
支払いが可能かどうかを確認する
チェックしてください Worldpay の機能カタログ 市場、通貨、カード ブランド、および必要な操作に合わせて。利用できるかどうかはアカウントと接続によって異なります。以下の機能の説明は、すべての機能がすべての販売者に対して有効であることを意味するものではありません。
国ごとの現地アクワイアリングと法人に関する要件をWorldpayに確認してください。3-D Secure、分割払い、ウォレット、複数回の部分操作を利用する場合は、テスト前に必要な設定をDEUNAおよびWorldpayと確認してください。
対応通貨
ARS · BRL · EUR · GBP · JPY · MXN · USD
利用可能な通貨は、Worldpayの加盟店アカウントと接続設定によって異なります。テスト前に、アカウントで有効になっている通貨を確認してください。
1. DEUNAにWorldpayを接続します#
開きます DEUNA Adminを開き、対象の加盟店または店舗を選択して「接続」に進みます。「発見」でWorldpayを検索し、「接続」を選択します。
以下のプレビューで、Worldpayの検索、認証情報の設定、保存済み接続の確認を体験できます。操作例のため、実際のアカウント設定はDEUNA Adminで行ってください。
接続設定を入力します
- チームが他のアカウントや環境と区別できるように、認識可能な接続名を選択してください。
- 要求されたら通貨を選択し、その接続用に発行された Worldpay 資格情報を入力します。
- 1 つの支払いフローで売上確定を承認およびリクエストするには [購入] を選択し、後で別の売上確定 リクエストを送信する場合は [承認] を選択します。
- DEUNA でサポートされている認証フローを確認した後にのみ、3-D Secureを設定します。参照 3Dセキュア対応 チェックアウトを実装する前に。
- 「接続」を選択し、「アクティブな接続」の下に「Worldpay」が表示されていることを確認します。
| DEUNAフィールド | 入力する値 |
|---|---|
| Merchant ID | 接続に対して発行された Worldpay マーチャント ID。 |
| 秘密キー | Worldpay XML 秘密キー。 |
| 公開キー | Worldpay XML パブリック パスワード。 |
航空会社への支払いの場合は、設定に必要な発行者フィールド (発行者名、発行者の住所 1、発行者の郵便番号、発行者の都市、および発行者の国コード) にも入力します。これらは航空券を発行した航空会社を識別します。国には 2 文字の ISO 国コードを使用します。支払いとともに送信される乗客、航空券、旅程のデータは置き換えられません。
[アクティブな接続] の下にある接続により、保存されたことが確認されます。統合が準備完了として扱われる前に、Worldpay 通知と支払いテストを続行します。
2. Worldpay 通知を構成する#
Worldpayは承認、売上確定、取消、返金の処理結果をDEUNAに通知し、決済状態を更新します。加盟店のバックエンドへの状態通知には、別途DEUNAのWebhook設定を使用します。非同期更新が必要な連携では、両方の通知経路を設定してください。
参照 DEUNA 支払いステータス通知 販売者側の設定用。
通知アドレスを設定する
Worldpay MAI で開きます Integration → Merchant Channel。で http 行、セット Active ~ Yes、セット Method ~ POSTをクリックし、一致する環境の通知アドレスを入力します。
| 環境 | Worldpay通知アドレス |
|---|---|
| サンドボックス | https://api.sandbox.deuna.io/transactions/webhooks/payconnect/payment-processors/worldpay |
| 生産 | https://api.deuna.io/transactions/webhooks/payconnect/payment-processors/worldpay |
保存する前に、接続のアドレスを DEUNA で確認してください。 Worldpay はこのアドレスを呼び出します。アプリケーションは、支払いを作成したりステータスを取得したりするためにこれを呼び出しません。
トランザクションイベントを有効にする
「 Merchant Channel Events (Production)で次のイベントを選択します。 http 行。イベント識別子は示されているとおりに正確に保持してください。
| 支払い段階 | 有効にするイベント |
|---|---|
| 認証とエラー | AUTHORIZED, REFUSED, ERROR |
| 売上確定 | CAPTURED, CAPTURE_FAILED |
| 払い戻し | SENT_FOR_REFUND, REFUNDED, REFUNDED_BY_MERCHANT, REFUND_REVERSED, REFUND_FAILED |
| キャンセルと取り消し | SHOPPER_CANCELLED, CANCELLED, REVERSED, VOIDED, CANCEL_FAILED |
3. 完全な支払いフローをテストする#
サンドボックス認証情報と、接続でサポートされている支払いフローを使用します。接続テストが成功すると、要求された支払い操作とその結果の状態の両方が表示される必要があります。
Worldpayによる処理中は、売上確定、返金、取消の要求が保留状態になることがあります。要求の受理、ブラウザーからの復帰、タイムアウトだけでは最終結果を判断できません。再試行や完了判定の前に、最新の注文状態と設定済みのDEUNA Webhookで元の決済結果を照合してください。
参照 決済ワークフロー & ステータス 支払いライフサイクルと DEUNAのウェブフック バックエンド通知用。
期待した結果が得られない場合
- 接続を保存できない場合は、Worldpay を使用して、選択したアカウント、環境、操作、および XML 資格情報を確認してください。
- 支払いが保留中の場合は、Worldpay 通知アドレスを確認してください。
POST方法と選択されたhttp元の操作を再試行する前にイベントを確認してください。 - DEUNA には結果があるが、バックエンドには結果がない場合は、 DEUNA Webhook 配信の設定.
DEUNA にエスカレーションする場合は、環境、注文参照、試行された操作、および観察されたステータスを含めます。認証情報やカード全体のデータは含めないでください。
本番環境への移行
運用資格情報と運用通知アドレスを使用して、接続と通知のセットアップを繰り返します。 DEUNA および Worldpay で有効な操作と認証要件を確認し、顧客のトラフィックを受け入れる前に本番の支払いフローを確認します。
サポートされている操作#
このリファレンスを使用して、構成およびテストする支払いフローを選択します。各機能を照合して確認します。 Worldpay の機能カタログ そしてアカウントの設定。
| 機能 | 機能概要 |
|---|---|
| 承認 | カード会員の口座で指定金額を確保し、売上は確定しません。代金を回収するには、別途売上確定が必要です。 |
| 売上確定 | 承認済みの決済から代金を回収します。全額売上確定では、利用可能な承認金額をすべて回収します。 |
| 購入 | 1 つの決済フローで承認と売上確定を要求します。加盟店が別途売上確定を要求する必要はありません。 |
| 部分売上確定 | 承認済み金額の一部を売上確定します。複数回の売上確定には、別途有効化が必要です。 |
| 複数回の部分売上確定 | 1 回の承認に対して、利用可能な承認残高を超えない範囲で複数回の売上確定を行えます。要求の方法と期限は、動作モードと承認の有効期間によって決まります。 |
| 取消 | 売上未確定の承認を取り消し、残りの確保金額の解除を要求します。売上確定済みの代金は返金しません。 |
| 払い戻し | 売上確定済みの代金をカード会員に返金します。全額返金では、返金可能な残高をすべて返金します。 |
| 部分返金 | 売上確定済み金額の一部をカード会員に返金します。 |
| 複数回の部分返金 | 有効化されている場合、同じ売上確定済み決済に対して複数回返金できます。返金の累計は、確認済みの売上確定金額を超えることはできません。 |
| 発行会社による分割払い | 対象のカード会員は、発行会社、アクワイアラー、加盟店接続が対応する条件に従って、購入代金を分割払いにできます。 |
| デジタルウォレット | Worldpay 接続で対象ウォレットが利用可能かつ有効な場合、Apple Pay と Google Pay の決済に対応します。 |
| 3-D Secure MPI | DEUNA は、ブラウザーの確認と、必要に応じた発行会社のチャレンジを含む 3-D Secure 認証を管理します。画面にチャレンジを表示せずに認証が完了する場合もあります。 |
| 航空会社データ | 乗客、航空券、旅程など、対応する航空取引情報を送信します。決済フローに必要な航空会社データを指定してください。 |
複数回の売上確定と返金
部分売上確定と部分返金への対応だけでは、複数回の操作は有効になりません。動作モードと注文ごとの上限を、DEUNA の Technical Account Manager(TAM)と Worldpay に確認してください。
オンラインの複数回売上確定では、各要求を個別に Worldpay に送信し、DEUNA の売上確定期限は使用しません。Worldpay の承認有効期間と売上確定制限は引き続き適用されます。DEUNA で設定する売上確定期間は、要求を蓄積するオフライン方式に適用され、シーケンス終了時に DEUNA が累計金額を送信します。次を参照してください: 複数回の部分売上確定 に、モード別のルールを記載しています。
複数回の返金は、確認済みの返金可能残高の範囲内で行う必要があります。DEUNA が要求を蓄積する接続では、部分返金要求は累計返金の送信まで返金の意図を記録するだけであり、顧客が代金を受け取ったことを意味しません。次を参照してください: 複数回の部分返金 に、要求を蓄積する方式を記載しています。
3-D Secure認証を処理する
認証にブラウザーでの操作が必要な場合、DEUNA は決済の次のアクションを通じてホストされた画面を返します。連携側は、対応するウィジェット、iframe、リダイレクト方式で表示します。ブラウザー確認だけで認証が完了する場合もあり、発行会社のチャレンジは必要な場合にのみ表示されます。
認証成功は、決済の承認や売上確定を保証しません。DEUNA が残りの承認や処理を完了した後、最終決済ステータスを確認してください。次のフローに従ってください: 3DS 決済フロー に、次のアクションと復旧の手順を記載しています。
ウォレットと分割払い
別途記入を完了してください Apple Pay または Google Pay チェックアウト時にウォレットを提供する前にセットアップしてください。ウォレットを利用できるかどうかは、市場と接続によって異なります。
発行会社による分割払いの場合は、カード、アクワイアラー、および接続に適格な条件のみを提供します。参照 分割払い に、キャンペーン設定と顧客が選択した条件の送信方法を記載しています。
地域および航空会社の要件#
航空会社の支払い
フローに必要な航空会社データを認証または取得リクエストで指定します。のために airline_order、必要な航空会社データがこれらのリクエストの少なくとも 1 つに存在する必要があります。テストする前に、接続に予想される乗客、航空券、旅程情報を確認してください。
売上確定と払い戻しの制限
認証が期限切れになる前に売上確定します。許可された売上確定 ウィンドウを Worldpay および DEUNA で確認します。 DEUNA バッチ処理のカットオフは、発行者の承認を延長しません。払い戻しは確認された捕獲金額を超えることはできません。フォローしてください 動作モード別のルール を確認してから、2 回目以降の部分操作を要求してください。
アルゼンチンの現地取引
アルゼンチンの Worldpay が現地で取得した取引の場合、承認リクエストに購入者の郵便番号、州、国を含めます。
billing_address.zipcodebilling_address.state_namebilling_address.country_code
Worldpay は、この情報を地方税の源泉徴収に使用します。それが存在しない場合、源泉徴収は販売者の所在地に基づいて行われます。 ISO 州コードまたは COMARB コードを次の形式で送信します。 billing_address.state_name、両方ではありません。
アルゼンチンの州コード
| 州コード: 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 |