- インテグレーションガイドライン
- 支払方法
- セキュアリモートコマース
セキュアリモートコマース
セキュアリモートコマース (SRC) は、インテリジェントかつパスワード不要のオンラインチェックアウトオプションで、支払者に迅速で簡単なチェックアウト操作を提供します。SRC には 1 つのチェックアウトボタンがあり (「クリックして支払い」とも呼ばれています)、Mastercard、Visa、American Express、Discover などのすべての参加カードスキームに対して標準的な精算フローを提供します。SRC は EMVCo の SRC 仕様で構築され、Masterpass、Visa Checkout、Amex Express Checkout を置き換えます。
支払者は、電子メールアドレスを使用して SRC プロファイルを作成できます。チェックアウトの際に、支払者はその後この電子メールアドレスを提供し、ワンタイムコードで追加の検証手順を実行する必要があります。また、支払者は「記憶する」オプションを選択することで、後に同じブラウザを使用する場合に検証をスキップすることができます。
支払者は、SRC プロファイルに複数のクレジットカード、デビットカード、プリペイドカード、関連する請求先住所、複数の発送先住所を保存できます。カードの詳細は安全に保存され、ネットワークのトークン化によって追加のセキュリティが提供されています。
SRC は、支払者が支払いの際に使用する支払詳細を選択できるようにします。ただし、支払いそのものは、ゲートウェイで加盟店プロファイル用に設定されたアクワイアラーを使用して処理されます。
SRC は、ゲートウェイの支払画面 (<<checkout>>)、または自身の支払画面を使用している場合は JavaScript SDK を通じてサポートされています。
主な利点
SRC は、以下の利点を提供しています。
- 支払者に対して、迅速で使いやすいチェックアウトオプションを提供し、チェックアウトが放置されるリスクを軽減
- ネットワークトークンの使用時に承認率を向上
- 支払者詐欺を減少
- カードの詳細、請求先住所と発送先住所の詳細情報を含む支払データのやりとりの安全性
前提条件
支払者に対して、SRC をチェックアウトオプションとして提供する場合:
- SRC が利用できるかどうかを確認するには、your payment service provider にお問い合わせください。
- Merchant Administration の [Admin] メニューで [SRC 設定] をクリックして、SRC にオンボーディングする手順に従って加盟店プロファイルに対して SRC をアクティブ化してください。SRC 設定を更新するには、必須の特権が必要です。
<<checkout>> のチェックアウトオプションとしての SRC
ゲートウェイの支払画面 (Hosted Checkout) を使用し、加盟店プロファイルで SRC をアクティブ化し、Create Checkout Session リクエストを送信して Hosted Checkout インタラクションを開始した時に <<webServicesIntegration>> バージョン 57 以上を使用した場合、SRC は支払者に対して自動的にチェックアウトオプションを提供します。
サポートされているカードスキームについて、支払者の SRC プロファイル自体にカードを含めることができる一方、特定の取引について、支払者は以下の場合でのみ SRC をそれらのカードに使用できます。
- 加盟店プロファイル上でカードスキームが SRC 用にアクティブ化されている場合
- このスキームと取引通貨でカードを処理するために、加盟店プロファイルが設定されている場合
発送先住所:支払者は SRC インタラクション中に発送先住所を選択できません。発送先住所の収集は現在、<<checkout>> 経由でサポートされていないためです。
請求先住所:請求先住所は、常に SRC インタラクション中に収集されます。
3D セキュア認証:3D セキュア (3DS) 認証が設定されている場合、Hosted Checkout は SRC インタラクション後に自動的に 3DS 認証を実行します。
<<checkout>> を使用するには、「<<checkout>> のインテグレーションの実装」で明示された手順に従ってください。
Checkout.configure()
を呼び出す場合、以下の詳細を含めます。
インタラクション国 | SRC インタラクションについて、インタラクション国は SRC インタラクション中に支払者に表示する国特有のコンテンツ (利用規約など) を決定します。 加盟店プロファイルに対してゲートウェイで設定する値は、デフォルトで使用されます。このインタラクションでこの値を上書きする場合は、 Checkout.configure() メソッドに interaction.country フィールドを追加します。 |
インタラクションロケール | SRC インタラクションについて、インタラクションロケールは表示言語を決定します。 デフォルトでは、支払者のブラウザで設定された言語が使用されます。支払者の言語が決定できない場合、またはサポートされていない場合は、en_US が使用されます。この値を上書きする場合は、 Checkout.configure() メソッドに interaction.locale フィールドを追加します。現在、サポートされている言語は英語 (英国) (en_UK)、スペイン語 (スペイン) (es_ES)、フランス語 (カナダ) (fr_CA)、ポルトガル語 (ブラジル) (pt_BR)、中国語 (香港) (zh_HK) です。 |
加盟店名 | 商号 (支払者に知られている名前) を提供します。名前は SRC インタラクション中に表示される場合があります。 |
加盟店 URL | 支払者が使用している Web サイトの URL を提供します。たとえば https://example.com です。URL は SRC インタラクション中に表示される場合があります。 |
支払人のメールアドレス | 支払者の電子メールアドレスは、常に SRC インタラクション中に収集されます。支払者の電子メールアドレスを既に知っている場合、<支払者の電子メールアドレス> customer.email を Checkout.configure() に追加します。これにより、支払者は SRC インタラクション中に電子メールアドレスの入力をバイパスできるようになります。 |
<html> <head> <script src="https://qnbalahli.test.gateway.mastercard.com/static/srci/1.2.0/srci.min.js" data-error="errorCallback" data-cancel="cancelCallback"></script> <script type="text/javascript"> function errorCallback(error) { console.log(JSON.stringify(error)); } function cancelCallback() { console.log('Payment cancelled'); } Checkout.configure({ merchant: "<gateway_merchant_ID>", session: { id: "<session_ID>", }, customer: { email: "<payer_email_address>" }, order: { amount: "60", currency: "USD", description: "High level description of the goods contained in the order", id: "<your_unique_order_ID>", }, interaction: { country: "USA", locale: "en_US", operation: "AUTHORIZE", merchant: { name: "<merchant_name>", url: "<website_URL>", address: { line1: "200 Sample St", line2: "1234 Example Town" } } } }); </script> </head> <body> ... <input type="button" value="Pay with Lightbox" onclick="Checkout.showLightbox();" /> <input type="button" value="Pay with Payment Page" onclick="Checkout.showPaymentPage();" /> ... </body> </html>
支払画面のチェックアウトオプションとしての SRC
自身の支払画面を使用しており、支払者に対して SRC をチェックアウトオプションとして提供する場合、ゲートウェイから提供された SRCI JavaScript SDK (srci.js) を使用します。
これはクライアント側の JavaScript インテグレーションで、SRC インタラクションを支払者のブラウザから直接開始できるようになります。また、SRC インタラクション中に支払者が選択した支払詳細が、支払者のブラウザからゲートウェイに確実に直接送信されるようにします。
SRCI JavaScript SDK を使用するには、以下の手順に従います。
手順 1: セッションの作成
サーバ側アプリケーションから Create Session
リクエストを送信することでセッションを作成します。レスポンスは、後の手順でこのセッションを参照する必要のあるセッション ID を返します。
手順 2: 注文金額と通貨でのセッションの更新
サーバ側アプリケーションから Update Session
リクエストを送信することで、注文金額および通貨でセッションを更新します。この手順は、この通貨で支払いが可能かどうか、SRC について後に照会する時に必要になります。
URL | https://qnbalahli.test.gateway.mastercard.com/api/rest/version/72/merchant/<your_merchant_ID>/session/<your_session_ID> |
HTTP メソッド | PUT |
{ "order":{ "amount":100.00, "currency":"USD" } }
手順 3: 支払画面に SRCI JavaScript SDK を含める
支払画面で、head
要素に script
要素を追加することにより、ゲートウェイから提供される SRCI JavaScript SDK (srci.js) を含みます。これで、SRCi
オブジェクトはウィンドウネームスペースに配置されます。
<script type="text/javascript" src="https://qnbalahli.test.gateway.mastercard.com/static/srci/1.2.0/srci.min.js"></script>
手順 4: SRC インタラクションの設定
支払画面をロードする際に、SRCi.configure()
メソッドを起動することで SRC インタラクションを開始します。
<html> <head> <script type="text/javascript" src="https://qnbalahli.test.gateway.mastercard.com/static/srci/1.2.0/srci.min.js"></script> <script type="text/javascript"> var callback = function (response) { if(response.result === "SUCCESS") { console.log("Response from SDK: %s", response.restApiResponse); } else if(response.result === "ERROR") { console.log("An error occurred"); } } SRCi.configure( "<your_gateway_merchant_ID>", "<your_merchant_name>", "<your_merchant_URL>", "<your_session_ID>", { wsVersion: 57 }, callback ); </script> </head> <body> ... </body> </html>
加盟店の詳細情報
merchantId
は必須です。これにより、ゲートウェイは支払方法を正しく決定できます。
merchantName
と merchantUrl
フィールドは SRC サーバに送信されます。これらの詳細は、SRC インタラクション中に支払者に提示される場合があります。
商号 (支払者に知られている名前) と支払者が使用している Web サイトの URL を提供します。
バージョン
この値を 57 に設定します。これは Create Session
リクエストを送信する際に使用されるバージョンです。
コールバック
callback
パラメータを使用して、SRCi.configure()
が完了した後に起動されるアクションを定義します。たとえば、メソッドが正常に処理された場合、ログを取ることができます。
var srciConfigCallback = function (resp) { var response = resp.restApiResponse; if (response.result === "ERROR") { console.error("SRC could not successfully be configured"); } else if (response.result === "SUCCESS") { console.log("SRC was successfully configured"); } }
SRCi.configure()
コールは、以下のエラーレスポンスを返す場合があります。
response.cause |
resp.explanation |
アクションが必要 |
---|---|---|
エラー | 引数なし:Merchant ID、Merchant Name、Merchant URL、Hosted Session ID、コールバック機能はすべて configure() メソッドで必要な引数です。 |
インテグレーションを修正してください。すべての必須フィールドに値を提供する必要があります |
エラー | 引数なし:加盟店 URL は configure() メソッドで必要な引数です |
インテグレーションを修正してください。加盟店 URL フィールドに値を提供する必要があります。 |
エラー | コールバックは関数である必要があります。 | インテグレーションを修正してください。 |
エラー | API バージョンは <MIN_VERSION> 以降を使用する必要があります。 |
インテグレーションを修正してください。wsVersion を 57 に設定してください。 |
エラーが返された場合、次の手順に進まないでください。支払者に別の支払方法として提供します。
詳細設定
SDK は Payment Options Inquiry
操作を使用して、SRC に対する加盟店プロファイルの設定に関する詳細を取得します (これには、たとえば SRC が使用可能なすべてのスキームのリストなどが含まれます)。ただし、支払者のセッション中に既に Payment Options Inquiry
リクエストを送信した場合、リクエストに configuration
要素を追加することでこれらの詳細を渡すことができます。
この場合、SDK は Payment Options Inquiry
リクエストを再度実行しません。wsVersion
パラメータは、Payment Options Inquiry
リクエストを送信した際に使用した <<webServicesIntegration>> バージョンを示します。
<html> <head> <script type="text/javascript" src="https://qnbalahli.test.gateway.mastercard.com/static/srci/1.2.0/srci.min.js"></script> // Response from the Payment Options Inquiry call. This value to SRCi.configure() is optional. If it is not passed in, a call will be made from the SDK to the API to retrieve it. var paymentOptionsInquiryResponse = { merchant: "<gateway_merchant_ID>", paymentTypes: { card: { cardTypes: [{ cardType: "MASTERCARD", schemeTokenTypes: "CRYPTOGRAM_3DSECURE" }, { cardType: "VISA", schemeTokenTypes: "CRYPTOGRAM_3DSECURE" }, { cardType: "AMEX", schemeTokenTypes: "DYNAMIC_CSC_AND_EXPIRY" }], walletProviders: [{ secureRemoteCommerce: { defaultPayerCountry: "USA", shippingAddressCountries : "USA,CAN" scheme: [{ dpaId: "<DPA_ID>", // As configured for this scheme on your merchant profile. name: "MASTERCARD" }, { dpaId: "<DPA_ID>", // As configured for this scheme on your merchant profile. name: "VISA" }, { name: "AMERICAN_EXPRESS" }] }, walletProvider: "SECURE_REMOTE_COMMERCE" }] } }, result: "SUCCESS" } SRCi.configure({ "<gateway_merchant_ID>", "<merchant_name>", "<merchant_URL>", "<session_ID>", configuration: { wsVersion: 57, paymentOptions: paymentOptionsInquiryResponse }, callback: function (response) { if(response.result === "SUCCESS") { console.log("Response from SDK: %s", response.restApiResponse); } else if(response.result === "ERROR") { console.log("An error occurred"); } } }); </script> </head> <body> ... </body> </html>
SRCi.configure()
レスポンスの例
以下の例は、SRCi.configure()
コールが正常に処理されたことを示します。
{ result: "SUCCESS" restApiResponse: <Payments Options Inquiry response> }
レスポンスには、restApiResponse
フィールドに Payments Options Inquiry
レスポンスを含みます。これは参考情報です。ただし、PAYMENT_OPTIONS_INQUIRY
リクエストを使用して取得する代わりに、支払者のセッション中に後にこの情報を使用することができます。
以下の例は、SRCi.configure()
コールが正常に処理されなかったことを示します。
{ result: "ERROR" cause: <cause> explanation: <explanation> }
この場合、別のチェックアウトオプションを選択するよう支払者にリクエストしてください。
手順 5: チェックアウトオプションとしての SRC の表示
SRCi.configure()
が正常に処理されると、支払画面のチェックアウトオプションとしての SRC が表示されます。ブランディング要件については、「SRC ユーザーインターフェイスガイドライン」を参照してください。
Payment Options Inquiry
レスポンスで返された SRC 設定詳細情報 を使用して、ボタンにどのスキームロゴを表示するかを決定します。サポートされているそれぞれのスキームについて、paymentTypes.card.walletProviders[n].secureRemoteCommerce.scheme[n].name
フィールドの Payment Options Inquiry
レスポンスにスキーム名が含まれます。
手順 6:SRC UI の起動
支払者がチェックアウトオプションとして SRC を選択する際、SRCi.launchUI()
メソッドを呼び出して SRC UI を起動します。
var payloadCallback = function (correlationId, scheme) { console.log("Payload callback complete with correlation id %s and scheme %s", correlationId, scheme); }; var errorCallback = function (error) { console.log("Error callback triggered with error: %s", error); }; var cancelCallback = function () { console.log("Cancel callback triggered"); }; SRCi.launchUI({ orderAmount: "100.00", orderCurrency: "USD" }, payloadCallback, errorCallback, cancelCallback );
必須フィールドに加え、多くの任意フィールドも提供できます。
SRCi.launchUI( { "orderAmount":"60" "orderCurrency":"USD", "customerEmail":"<payer_email_address>", "collectShippingAddress":true, "interactionCountry":"CAN" "interactionLocale":"fr" } );
支払者の電子メールアドレスの収集
支払者の電子メールアドレスは、常に SRC インタラクション中に収集されます。支払者の電子メールアドレスを既に知っている場合、customerEmail
フィールドを SRCi.launchUI()
メソッドに追加します。これにより、支払者は SRC インタラクション中に電子メールアドレスの入力をバイパスできるようになります。
請求先住所の収集
請求先住所は、常に SRC インタラクション中に収集されます。
発送先住所の収集
デフォルトでは、SRC は支払者の発送先住所を収集しません。SRC が支払者の発送先住所を収集できるようにするには、SRCi.launchUI()
メソッドに collectShippingAddress:true
を追加します。
デフォルトでは、支払者は発送先住所のどの国でも選択できます。商品を発送する国のリストを制限するには、Merchant Administration 経由で SRC の加盟店プロファイルを設定する必要があります。許可された国のリストまたは除外された国のリストのいずれかでこれを行うことができます。定義された制限がある場合、支払者は許可された発送先住所の国のみを選択できます。
特定のリクエストについて、サポートされている発送先住所の国を上書きすることはできません。
インタラクション国
インタラクション国は SRC インタラクション中に支払者に表示する国特有のコンテンツ (利用規約など) を決定します。加盟店プロファイルに対してゲートウェイで設定する値は、デフォルトで使用されます。このインタラクションでこの値を上書きする場合は、SRCi.launchUI()
メソッドに interactionCountry
フィールドを追加します。
インタラクションロケール
インタラクションロケールは、SRC インタラクション中に使用される言語を決定します。デフォルトでは、支払者のブラウザで設定された言語が使用されます。支払者の言語が決定できない場合、またはサポートされていない場合は、en_US が使用されます。この値を上書きする場合は、SRCi.launchUI()
メソッドに interactionLocale
フィールドを追加します。現在、サポートされている言語は英語 (英国) (en_UK)、スペイン語 (スペイン) (es_ES)、フランス語 (カナダ) (fr_CA)、ポルトガル語 (ブラジル) (pt_BR)、中国語 (香港) (zh_HK) です。
コールバック
SRCi.launchUI()
が完了した後に起動されるアクションを、以下の内容で定義する必要があります。
payloadCallback |
支払者が SRC UI でインタラクションを完了した時にトリガされるコールバック機能。 この機能は、2 つの引数として correlationId と scheme を使用します。
これらの詳細は、この SRC インタラクションで支払詳細を取得するために、後で使用されなければなりません (手順 7 を参照してください)。 |
|||||||||||||||||||||
errorCallback |
SRC UI のロードをする際に、エラーの発生によりトリガーされるコールバック機能。この機能は、エラー詳細を含むエラーオブジェクトが反映された引数を使用します。
|
|||||||||||||||||||||
cancelCallback |
支払者が SRC インタラクションをキャンセルし、または SRC UI を閉じた時にトリガされるコールバック機能。引数は使用しません。 |
手順 7: SRC 支払詳細によるセッションの更新
支払者が SRC インタラクションを正常に完了した後に、 SRC インタラクション用の支払詳細を取得するようゲートウェイにリクエストし、セッションに保存する必要があります。
以下を使用して、Update Session From Wallet
リクエストを送信します。
- リクエスト URL にあるセッション ID
correlationId
とpayloadCallback
で返されたスキーム
URL | https://qnbalahli.test.gateway.mastercard.com/api/rest/version/72/merchant/<your_merchant_ID>/session/<your_session_ID> |
HTTP メソッド | POST |
{ "apiOperation":"UPDATE_SESSION_FROM_WALLET", "order":{ "walletProvider":"SECURE_REMOTE_COMMERCE" }, "wallet":{ "secureRemoteCommerce":{ "srcCorrelationId":"<correlationId_provided_in_payloadCallback>", "scheme":"<scheme_provided_in_payloadCallback>" } } }
セッションが SRC インタラクションからの支払詳細で正常に更新されると、続行できます。セッションが正常に更新できなかった場合、支払者に別のチェックアウトオプションを選択するように依頼してください。
手順 8: 3D セキュア認証の実行 (オプション)
支払者を認証する場合、セッションを使用して 3D セキュア認証を実行します。詳細については、「3DS JavaScript API を使用した 3DS インテグレーションの実装」を参照してください。
手順 9: 支払操作の実行
セッションが SRC インタラクション (そして手順 8 を実行した場合は 3D セキュア認証) からの支払詳細で正常に更新されると、セッションを使用してサーバ側アプリケーションからの支払いを送信して処理します。たとえば、Authorize
リクエストを送信できます。SRC インタラクションからのセッションに保存されている支払詳細は、支払いを処理する際に使用されます。多くの API 操作でセッションを使用できます。詳細情報については、「セッションの使用」を参照してください。
URL | https://qnbalahli.test.gateway.mastercard.com/api/rest/version/72/merchant/<your_merchant_ID>/order/<your_order_ID>/transaction/<your_transaction_ID> |
HTTP メソッド | PUT |
{ "session":{ "id":"<session_ID>" } "..." }
以下の HTML のサンプルは、支払画面でどのように SRCi.j を統合すればよいかを示します。以下に留意してください。
srci.min.js
スクリプトがページにロードされた直後に、SRCi.configure()
が呼び出される必要があります。ボタンクリックハンドラの中のSRCi.configure()
を呼び出そうとすると、ブラウザによっては SRC 支払ウィンドウが開くのをブロックすることがあります。- 「Pay」ボタンイベントハンドラはまず、JavaScript SDK が完全に設定されていることを確認する必要があります。正常な設定の前に
SRCi.launchUI()
を呼び出そうとすると、エラーを生じさせ、支払者の操作に悪影響を及ぼします。 - 「Pay」ボタンは、SRCi.launchUI() を呼び出す直前に無効にし、それぞれのコールバックで再度有効にしなければなりません。
SRCi.launchUI()
を複数回呼び出そうとすると、予期しない動作を引き起こすことがあります。
<html> <head> <script type="text/javascript" src="https://qnbalahli.test.gateway.mastercard.com/static/srci/1.2.0/srci.min.js"></script> <script type="text/javascript"> var configured = false; //SRCi global object is initialized by srci script SRCi.configure( "<gateway_merchant_ID>", "<merchant_name>", "<merchant_URL>", "<session_ID>", { wsVersion: 57 }, function (response) { if(response.result === "SUCCESS") { configured = true; console.log("Response from SDK: %s", response.restApiResponse); } else if(response.result === "ERROR") { console.log("An error occurred"); } } ); var payloadCallback = function (correlationId, scheme) { console.log("Payload callback complete with correlation id %s and scheme %s", correlationId, scheme); enablePayButton(); }; var errorCallback = function (error) { console.log("Error callback triggered with error %s", error); enablePayButton(); }; var cancelCallback = function () { console.log("Cancel callback triggered"); enablePayButton(); }; function enablePayButton() { document.getElementById("payButton").disabled = false; } function disablePayButton() { document.getElementById("payButton").disabled = true; } function pay() { if (configured) { // ensure only one payment window is launched disablePayButton(); SRCi.launchUI({ orderAmount: "100.00", orderCurrency: "USD" }, payloadCallback, errorCallback, cancelCallback ); } else { console.error("SRCi is not configured"); } } </script> </head> <body> <button id="payButton" type="button" onclick="pay();">Pay</button> </body> </html>
SRC 支払詳細
このセクションは、SRC インタラクションで返された支払詳細について説明します。
SRC インタラクションで返された支払詳細のタイプ
SRC は、処理のために異なるタイプの支払詳細を返すことをサポートしています。SRC システムによって返される支払詳細は、ゲートウェイからリクエストされたタイプ、SRC システム上の設定、カードスキームによって異なります。SRC は通常、ネットワークトークン、トークンの有効期限、完全な暗号文 (カードスキームによってサポートされている場合) を返します。
ただし、ゲートウェイがアクワイアラーに対して完全な暗号文があるネットワークトークンを送信することができない場合、SRC は代わりにネットワークトークン、トークンの有効期限、動的なカードのセキュリティコード (CSC) を提供する必要があります。ゲートウェイは、支払詳細の正しいタイプがリクエストされたかを自動的に確認します。
カードがネットワークのトークン化をサポートしていない場合 (たとえば、イシュアー (カード発行会社) が参加していない場合)、SRC はネットワークトークンの詳細 (ネットワークトークン、トークンの有効期限、暗号文や動的な CSC) の代わりにカードの詳細 (カード番号とカードの有効期限) を返します。
米国の加盟店で、ダービン修正条項に基づく権利を行使することを示した場合、SRC はデビットカードについてカードの詳細 (カード番号とカードの有効期限) を提供します。
API 取引応答における SRC 支払詳細
SRC インタラクション中に支払者が選択した支払詳細は、セッションに保存され、セッションを使用して API リクエストで実行された取引応答で返されます。SRC がネットワークトークンの詳細を提供すると、ネットワークトークンの詳細と (マスキングされた) カードの詳細の両方が提供されます。
SRC システムによって返された支払詳細のタイプに応じて、以下の詳細を API レスポンスで受領します。
完全な暗号文を含むネットワークトークン (American Express はこのタイプのネットワークトークンをサポートしていません) (暗号文は取引応答で返されません) |
|
動的な CSC があるネットワークトークン (CSC は取引応答で返されません) |
|
カード番号と有効期限 |
|
支払者の詳細情報
支払者の名前と電話番号は、customer
パラメータグループの取引応答で提供されます。
支払者の電子メールアドレスは、consumerEmailAddressRequested
をオンに設定した場合、customer.email
フィールドの取引応答で提供されます。
請求先住所の詳細情報
カードに関連する請求先住所の詳細情報は、billing.address
パラメータグループの取引応答で提供されます。
発送先住所の詳細情報
collectShippingAddress
を true
に設定した場合、発送先住所の詳細情報は、shipping.address
パラメータグループの取引応答で提供されます。
加盟店が開始する取引
一連の支払い (登録型決済または分割払いなど) を開始するために、それらの支払詳細を後で使用する場合には、チェックアウトオプションとして SRC を支払者に提供してはなりません。これは今後のリリースでサポートされます。
インテグレーションのテスト
SRC に対してゲートウェイでインテグレーションを完了すると、テスト用加盟店プロファイル (TEST
という接頭辞が付いている加盟店 ID) を使用してテストできます。テスト用加盟店プロファイルを使用する際、ゲートウェイは SRC インタラクション用のシミュレーターを提供します。SRC シミュレーターは、一連の定義済みの支払詳細を使用します。この支払詳細は変更できません。定義済みの支払詳細に基づき、以下で説明されているとおり、異なるシナリオをトリガーし、テストできます。
表の 2 つ目の欄は、SRC インタラクション中に支払者によって選択された FPAN の最後の 4 桁を示しています。シナリオをトリガするには、支払者の SRC インタラクション中に対応する FPAN をシミュレーターで選択します。
スキーム | FPAN の最後の 4 桁 | SRC 相関 ID | 結果: API UPDATE_SESSION_FROM_WALLET レスポンス | 結果: API AUTHORIZE または PAY レスポンス |
---|---|---|---|---|
Mastercard | xxx0007 | 783a935d-c6a9-4289-b19d-c3336f998b57 |
|
|
Visa | xxx0003 | 12345671-visaTAVV-expiry0822-colShiptrue |
|
|
スキーム | FPAN の最後の 4 桁 | SRC 相関 ID | 結果: API UPDATE_SESSION_FROM_WALLET レスポンス | 結果: API AUTHORIZE または PAY レスポンス |
---|---|---|---|---|
Mastercard | xxx0008 | 261af700-e576-43bf-af92-bd0f6810e8fb |
|
|
Visa | xxx0002 | 12345671-visaDTVV-expiry0822-colShiptrue |
|
|
American Express | xxx0017 | cf3de1e0-55a2-44cf-9563-5ef9e648c492 |
|
|
スキーム | FPAN の最後の 4 桁 | SRC 相関 ID | 結果: API UPDATE_SESSION_FROM_WALLET レスポンス | 結果: API AUTHORIZE または PAY レスポンス |
---|---|---|---|---|
Mastercard | xxx0305 | 8e455e8b-4e52-46cf-a3da-83aa3cf9a76e |
|
|
Visa | xxx0001 | 12345671-visa1-expiry0822 |
|
|
American Express | xxx4564 | bb978084-42b7-4985-af9d-2e41ee0a370c |
|
|
3D セキュア認証による SRC のテスト
加盟店プロファイルが EMV 3D セキュア認証 (3DS2) を有効にしている場合、以下の表で示されている SRC テストの詳細を使用して、円滑フローまたは検証フローのいずれかをトリガできます。
スキーム | FPAN の最後の 4 桁 | SRC 相関 ID | 結果: API レスポンス |
---|---|---|---|
Mastercard | xxx0009 | 1049624e-cc67-45f6-bd5f-c625eb4c6cc1 |
|
Visa | xxx4222 | 12345671-SRC3DSChallenge-expiry0822-colShiptrue |
|
American Express | xxx0017 | 16e051bc-bd25-46db-a7d3-d2944fbb05cf |
|
スキーム | FPAN の最後の 4 桁 | SRC 相関 ID | 結果: API レスポンス |
---|---|---|---|
Mastercard | xxx0010 | 16e051bc-bd25-46db-a7d3-d2944fbb05cf |
|
Visa | xxx4180 | 12345671-SRC3DSFrictionless-expiry0822-colShiptrue |
|
American Express | xxx4564 | 17e051bc-bd25-46db-a7d3-d2944fbb05cf |
|