Skip to content

サンプルコード機能

このセクションでは、3DSリクエスターデモプロジェクトのすべての機能を紹介します。弊社の3DSリクエスターにアクセスするには:

  • こちらから3DSリクエスターデモのコードをダウンロードして実行するか、
  • 弊社のオンラインのTestLabsリクエスターを使用してください。

以下に表示されているのは弊社の3DSリクエスターサイトのホームページです。 オンラインショップとテストページの2つのセクションがあります。オンラインショップはLaunchボタン(1.a)を選択する、もしくは左上のOnline shopボタン(1.b)を選択する事でアクセス出来ます。それぞれのテストページは関連ボタン(2.a)を選択する、もしくは左上のTest pagesドロップダウン(2.b)を選択する事でアクセス出来ます。加えて、右上にActiveServer認証APIドキュメントへのAPI Documentのリンク(3)があります。

index site

オンラインショップ

オンラインショップは、どのように3DS2を電子取引サイトに統合するかを加盟店視点で提供する、デモの加盟店のチェックアウトページです。統合の実装については、統合ガイドに従ってください。

商品をショップページ内のカートに追加してください:

purchase page

Checkoutボタンを選択しチェックアウトページへ移動してください:

取引を完了するのに使用されるカード番号を含む、標準の支払いと請求の情報が予め入力されています。Continue to Checkoutボタンを選択して3DS2認証プロセスを開始してください:

checkout page

3DSリクエスターが3DS2認証を実行している間、処理ページにスピナーが表示されます。3DS2認証が終了すると、結果が表示されます。

processing page

Show results in separate pagesを選択すると、新しいページが開き結果が表示されます。

result page

テストページ

テストページでブラウザベース認証 (BRW)、3DS Requestor Initiated (3RI)、EnrolAPIドキュメントに定義されたすべてのパラメータで試験を実施できます。

BRWテストページ

基礎情報

BRWテストページにはBasic Info(基礎情報)、Cardholder(カード会員)、Additional Risk (追加リスク)の3つのタブがあります。

brw cards

Basic Info(基礎情報)タブにはChannel(チャンネル)、Required Field(必須項目)、Additional Field(追加項目)の3つのセクションがあります。

brw parts

Channel (チャンネル)では、アプリケーションに読み込まれている3DS Server URLとRequestor URLを確認する事が出来ます。さらに、paもしくはnpaのどちらのMessage Categoryがテストに使用されるかを選択出来ます。

Required Field (必須項目)では、カード番号、マーチャントID、認証インジケータを入力する必要があります。これらは3DS2ブラウザベース認証に必要なパラメータです。

カード会員

Additional Field (追加項目)では、購入数量、金額、通貨、有効期限といった追加の情報を入力する事が出来ます。

GPayments TestLabsシナリオの使い方

カード番号 は、自分のカード番号を入力するか、もしくは予め設定された弊社のシナリオから選ぶ事が出来ます。例えば、VisaのFrictionless authentication、そしてカード番号4100000000000001がカード番号フィールドに自動的に入力されます。

Cardholder(カード会員)タブでは、名前、住所、Eメール、電話番号を含むカード会員の情報を入力する事が出来ます。

brw cardholder

追加リスク

Additional Risk (追加リスク)タブでは、アカウント情報、リクエスターの認証情報、加盟店リスク情報のような追加のリスク情報を入力する事が出来ます。

加盟店リスク情報

この情報の提供は必須ではありません。しかし、イシュアーのACSは提供された情報が多いほどリスクベース認証の精度は上がり、フリクションレスのレートが高くなる可能性があります。なので、加盟店がこの情報を提供することは非常に重要です。

brw add risk

テストオプション

テストオプションタブで、Cancel Challengeチェックボックスをオンにすることで、ACSが取引に対してチャレンジを要求した場合にチャレンジをキャンセルすることを選択できます。チャレンジをキャンセルすると、 3ds-web-adapterはiframeでCReqコールバックページを実行しません。必要に応じて、/api/v1/auth/challenge/statusのエンドポイントを使用して、Cancel Reason (キャンセルの理由)を指定し、ActiveServerにチャレンジをキャンセルした理由を通知します。

  • CReq Not Sent (CReqが送信されなかった) - 3DSリクエスターがチャレンジをオプトアウトすることを選択したため、チャレンジリクエストが開始されなかったことを示します。CReqNotSentのステータスを/api/v1/auth/challenge/statusに送信します。

  • Auth Result Not Delivered (認証結果が届かなかった) - チャレンジリクエストを3DSリクエスターに配信できなかったことを示します。例： 3DSリクエスターが認証リクエストを実行するとき(/api/v1/auth/brw/等)にActiveServerが応答しないなどの技術的なエラー等の理由。 AuthResultNotDeliveredのステータスを/api/v1/auth/challenge/statusに送信します。

  • No Reason Sent　(理由が送信されなかった) - 3DSリクエスターがチャレンジを開始せず、 /api/v1/auth/challenge/statusを呼び出さないシナリオをシミュレートします。キャンセル理由はActiveServerに送信されません。

brw add risk

3RIテストページ

BRWテストページと同様に、3RIテストページにもBasic Info(基礎情報)、Cardholder(カード会員)、Additional Risk (追加リスク)の3つのカードがあります。1つの違いは3RI IndicatorパラメータがRequired Field (必須項目)内にあり、Additional Field (追加項目)内に無い事です。その他の違いとして、3DS Requestor Initiatedは非決済認証のみに使用される為、Message Categoryを選択する事が出来ません。

3ri basic

Enrolテストページ

カード番号とマーチャントIDのみがEnrolテストでは必要です。

enrol basic

テスト結果

テストページのどれか1つでTestXXXボタンを選択すると、process.html移動します。すべての3DS2プロセスはprocess.htmlページで処理されます。3DS2プロセスが実行中の間はスピナーが表示されます。3DS2プロセスが完了すると、同じページ内に結果が表示されます。

result success

例えば、BRW testページを選択し、そしてTest BRWボタンを予め入力された情報で選択すると、成功した応答を取得します。

result error

もしくは、不正なパラメータをBRW testページ内で入力すると（例えばMerchant IDに000)、エラーを返します。