本ガイドの内容

本ガイドは、株式会社DGフィナンシャルテクノロジーが提供するVeriTrans4GのAmazon Payサービスをインターネット店舗等に導入するための、Webアプリケーション開発者向けのガイドです。

Amazon Payサービスの概要

Amazon Payサービスは、加盟店のサイトで購入された商品の代金を、Amazon社が提供するAmazon Payサービス上で選択した支払い方法で決済できるサービスです。

• Amazon Payサービスでは、ユーザがAmazonに登録した支払い方法と配送先情報を選択することができます。（購入のたびにユーザがこれらの情報を入力する必要はありません。）
  また、決済申込の際に新規の支払い方法や配送先情報を登録することも可能です。
  • 支払い方法について、2021年3月時点では、都度決済ではAmazonギフト券とクレジットカード、随時決済ではクレジットカードのみ利用可能です。その他の方法で支払いを行うことはできません。

    ※支払い方法については追加される可能性があります。
    支払い方法についてはAmazon PayのFAQなどを参照してください。

• Amazon PayサービスはPC・スマートフォンのどちらにも対応しています。
  Amazon Pay決済の画面遷移のイメージを以下に示します。

  ※決済導入ページのお支払いボタンには以下のURLの画像のうちSandbox以外の画像を必ずお使いください。
  https://amazon-pay-v2.s3.ap-northeast-1.amazonaws.com/button_images/amazonpay_button_images.zip

都度決済と随時決済

Amazon Payサービスでは、「都度決済」と「随時決済」の2種類の決済を行うことができます。

【都度決済機能】

消費者の購入した商品などについて、1回だけ決済を行います。
都度決済機能には以下の特徴があります。

1. 都度決済の申込は、「課金種別」を未指定、あるいは都度決済を指定して行います。
2. 都度決済の申込は、消費者の端末から行います。
3. 与信のキャンセル、売上、売上後の返金、与信変更はMDKまたは管理画面（MAP）から可能です。

【随時決済機能】

店舗様と利用者の決済頻度についての承諾に基づき、その決済頻度にあわせて課金することができます。解約手続き（利用承諾の終了）が行われるまで、店舗様からの要求の都度、課金が発生します。

1. 随時決済の申込（利用承諾）は、「課金種別」に随時決済を指定し、「頻度（単位）」と「頻度（値）」を設定して、都度決済と同様のフローで行います。
2. 随時決済の申込時に「承諾時決済タイプ」を指定することで、「承諾のみ」か「与信＋承諾」のいずれかを行うことができます。
   ※withCapture を指定することで申込と同時に売上処理も可能です。
3. 随時決済の申込は、消費者の端末から行います。
4. 課金する場合には、1.の取引IDを元取引IDに指定し、新しい取引IDで再与信することにより金額を確保します。

   ※withCaptureを指定することで同時に売上処理も可能です。

5. 4.の取引IDに対して、キャンセル、売上、返金を実施します。
   再与信した取引のキャンセル、売上、売上後の返金はMDKまたは管理画面（MAP）から可能です。
6. 随時決済の解約が行われるまで、4.と5.を何度でも実施できます。
   ただし、13か月以上再与信を行わなかった場合は、Amazon Pay側で利用承諾終了となり、抹消通知が店舗様に通知されます。消費者側で解約が行われた場合にも抹消通知が店舗様に通知されます。
   また、金額、頻度を変えて再与信を行う場合は、承諾情報更新を実施する必要があります。
7. 随時決済の解約はMDKまたは管理画面（MAP）から可能です。

配送先による金額の変更

Amazon Payサービスでは、決済申込フローの中で配送先の住所を選択することができます。選択された住所により配送料が異なる場合は、以下の方法で決済金額の変更を行います。

※決済申込時の決済確認画面に「決済サーバー画面」と「加盟店画面」を利用した2つのパターンがあり、それぞれで決済金額の変更方法が異なります。

【決済サーバー画面】を利用する場合

決済申込処理の完了後に「与信変更」コマンド(都度決済)、または「承諾変更」コマンド(随時決済)を実施します。
決済処理シーケンスは「決済申込時の処理（決済サーバーの決済確認画面利用）」を参照してください。

【加盟店画面】を利用する場合

決済申込フローの途中で「与信変更」コマンド(都度決済および随時決済)を実施します。
決済確認画面では消費者が配送先や支払い方法を変えるための処理を実装する必要があります。詳細については、「6-7決済申込での加盟店の決済確認画面の利用について」を参照してください。
決済処理シーケンスは「決済申込時の処理（加盟店の決済確認画面利用）」を参照してください。

機能一覧（決済要求コマンド）

使用可能な決済要求コマンドを下記表に示します。

※1 部分売上を複数回行うことはできません。部分売上を行った場合の残りのオーソリ枠は解放されます
※2 部分返金は、決済金額の残り（残高）が0円になるまで繰り返し実行できます。
※3 承諾情報更新は解約を行うまで繰り返し実行できます。
※4 与信変更は売上、与信（オーソリ）の取消を行うまで繰り返し実行できます。

決済処理シーケンス

【決済申込時の処理（決済サーバーの決済確認画面利用）】

【決済申込時の処理（加盟店の決済確認画面利用）】

【売上処理】

【キャンセル処理】

【返金処理】

【住所情報取得処理】

【再与信処理】

【解約処理】

【承諾情報更新処理】

【与信変更処理】

結果通知受信処理の対象

Amazon Payの結果通知受信処理の対象は以下の機能です。

Amazon Pay

共通

結果通知電文

ご利用前の設定

Amazon Payサービスのご利用にあたり、以下の設定を必ず行ってください。

売上要求、返金要求、中断について

Amazon Payサービスでは、Amazonとクレジットカード会社の間で返金処理を非同期で行うため、加盟店からの要求に対して、ある程度の時間が経過してから、処理結果が決定することになります。（直ちに処理されることもあります。）
決済サーバー側の処理としては、加盟店からの返金要求に対して、Amazonで要求を受け付けたことが確認できた時点で、受付成功(結果コードが6G01)の応答を返戻します。直ちに処理が完了した場合は、受付成功ではなく、処理成功（結果コードが6001）の応答を返戻します。
売上要求については、与信取得から約一週間経過した後に売上を行った場合には、Amazonで受付成功の応答を返戻することがあります。
また、各コマンドで決済サーバーがAmazonからの応答を受信できなかった場合や応答内容から取引結果が判別できずに取引状況が不明となった場合は、取引は中断状態となります。

処理結果が決定した場合には、決済サーバーから加盟店に結果通知を行います。

※パラメータ誤りなど、コマンドがAmazonへの要求前に失敗相当となった場合は、決済サーバーから加盟店への結果通知は行いません。

受付成功の後、失敗となる可能性があるため、受付成功の時点では要求は成立していないものとして扱ってください。
また、結果通知による処理結果は、通信状況によってはコマンド返戻より先に加盟店に届くことがある他、複数回同じ内容の結果通知が届くことがあります。このような場合にも加盟店側の処理として問題とならないようにご対応ください。

要求可能期間

Amazon Payサービスにおける、要求可能期限は下記となります。

随時決済の頻度について

随時決済の決済申込の際に再与信を行う頻度（単位）と頻度（値）を設定していただきますが、設定した頻度と異なるタイミングで再与信を実施しても再与信は成立します。ただし、決済申込時の設定と実際の再与信の頻度が頻繁に異なる場合は、Amazon側の判断でアカウントを閉鎖される可能性がございます。可能な限り、設定した頻度で再与信を実施するようにご注意ください。
設定した頻度を変更したい場合、承諾情報更新を実施してください。 頻度の設定方法に関しては5.1.1 申込 要求電文：AmazonpayAuthorizeRequestDtoの「frequencyUnit」、「frequencyValue」をご参照ください。

Amazon Pay管理画面(セラーセントラル)について

Amazon Pay管理画面(セラーセントラル)では取引状態を変更しないでください。弊社とAmazonとの間での決済不整合の発生につながります。

Amazonマーケットプレイス保証について

Amazon Payサービスに登録された配送先について、加盟店と購入者が直接連絡して配送先を変更した場合はAmazonマーケットプレイス保証が適用されないリスクがあります。
Amazonマーケットプレイス保証の詳細につきましては、Amazon Payのサポートページ（https://pay.amazon.co.jp/help/201212410）よりご確認ください。

決済申込での加盟店の決済確認画面の利用について

決済申込で加盟店の決済確認画面を利用する場合、決済申込完了までに以下の処理を実装する必要があります。

1. MDKの決済申込(Authorize)コマンド実施
   要求電文で決済確認画面種別(payConfirmScreenType)および決済確認画面ＵＲＬ(payConfirmScreenＵｒｌ)を設定する必要があります。

2. 決済確認画面表示処理
   決済サーバーから加盟店が指定したURLにリダイレクトを行います。
   改ざんチェックのパラメータとして、リクエストパラメータで取引ID(orderId), ハッシュ値(orderHash)を付与します。

   ※決済確認画面表示後に配送先を変更したパターンなどで、本処理は複数回実施されることがございます。2回目以降の場合はAmazon Payにより上記以外のパラメータが付与されることがございますが、無視して問題ありません。

   決済確認画面に表示する内容、および配送先や支払い方法を変更するための実装は、Amazon Payのインテグレーションガイドを参照してください。
   なお、変更時に必要となるamazonCheckoutSessionIdは、
   住所情報取得(GetAddress)コマンド応答のcheckoutSessionIdの値をご使用ください。 https://developer.amazon.com/ja/docs/amazon-pay-checkout/display-shipping-payment-info.html

   配送先情報および支払い方法の情報取得に関しては、MDKの住所情報取得(GetAddress)コマンドを実施してください。取得した配送先住所を確認し、送料変更による金額変更が発生する場合は、決済確認画面には変更後の表示を実施し、「3.金額変更処理」で与信変更のコマンドを実施してください。
   また、応答電文で取得した決済確定URL(payRedirectUrl)は後の処理で必要になるため、取引と紐づけて保存する必要があります。

   [ハッシュ値による改ざんチェックについて]

   ハッシュ値の計算は以下の式で実施し、リクエストパラメータの値と一致するかご確認ください。merchantCcIdおよびパスワードは加盟店サーバーに保存されている値をご利用ください。
   「merchantCcId + 取引ID + パスワードをSHA-1でハッシュ化」

   ダミー取引で「お届け先修正」と「支払い方法変更」の遷移を確認する場合はダミー取引専用の処理が必要になりますので、「8-1決済申込時の画面遷移をシミュレートする」の「加盟店の決済確認画面を利用する場合」のセクションをご確認ください。

3. 金額変更処理
   

   「2.決済確認画面表示処理」で金額変更が必要な場合は、与信変更(UpdateAuthorize)コマンドを実施して金額変更の電文を決済サーバーに送信してください。金額変更がない場合は与信変更コマンドの実施は不要です。
   与信変更コマンド実施後、「2.決済確認画面表示処理」で保存した決済確定ＵＲＬ、もしくは与信変更コマンドで取得した決済確定ＵＲＬのうち新しいＵＲＬにリダイレクトするように処理してください。

4. これ以降の処理は決済サーバーの決済確認画面を利用した場合と同様になります。

返金要求の失敗について

返金要求が失敗(結果コードが6G02)だった場合、購入者のAmazonアカウントが削除されていないか確認をしてください。 確認方法として、Amazon Pay管理画面(セラーセントラル)から対象の取引を確認した際に、購入者氏名の欄が「削除された購入者アカウント」と表示されているかどうかで確認することができます。

決済要求から24時間経過しても処理が確定しない場合について

決済要求(結果コードが6G01)が発生した取引に関して、24時間経過しても結果が確定しない場合、クレジットカード会社で処理が長引いている可能性がございます。 処理状況についての詳細はAmazon Pay管理画面(セラーセントラル)からAmazon側へ直接お問い合わせください。

通信プロトコルについて

Amazon Payは、安全な通信を確保するためにTLS1.0を使用して行われたリクエストをブロックします。 Amazon PayへのリクエストにはTLS1.1以降を使用する必要があります。

Amazon Payサービスの参考情報

選択可能な支払い方法や対象ブラウザその他、Amazon Payサービスの仕様につきましては、開発者向けページ、対象ブラウザをご参照ください。

Amazon Payサービスのロゴ・マーク・バナーのご利用につきましてはAmazon Pay販売事業者様向けマーケティングガイドをご参照ください。

検索（Search）に関する補足（詳細コマンドタイプ/詳細オーダー決済状態）

決済サーバーでは、システム内部データとして詳細コマンド（処理要求の種類）と詳細な決済状態（その取引がどのような状態にあるか）を管理しています。
通常の運用では、店舗様システムではこれらの内部情報を利用する必要はありませんが、店舗様システムにおいて取引の状態検索が必要なケースや、障害等のお問い合わせ時の参照情報として、これらの内部データをSearchコマンドで公開しています。
下表にSearchコマンドにて利用可能な内部データの一覧を示します。

注） 一覧に記載していないコマンドタイプと状態も存在します。

決済サーバーの決済確認画面イメージ

決済サーバーが提供する決済確認画面を用いる場合、消費者には下記のような画面が表示されます。
決済確認画面では、消費者の選択した配送先、支払い方法、取引情報（取引ID、取引金額、お支払いサイクル）を表示します。
消費者は、「お届け先修正」ボタンと「支払い方法修正」ボタンにより、購入手続き前に配送先や支払い方法を変更できます。
配送先、支払い方法の変更処理の詳細を確認する場合は、Amazon Payのインテグレーションガイドをご参照ください。
https://developer.amazon.com/ja/docs/amazon-pay-checkout/display-shipping-payment-info.html

※配送先と「お届け先修正」ボタンは、配送先表示抑止フラグで非表示と指定した場合は表示しません。
※お支払いサイクルは都度決済の場合は表示しません。
※決済確認画面のイメージは2022年11月時点の内容となります。今後、予告なしに変更させていただく場合がございます。

決済申込時の画面遷移をシミュレートする

弊社では、Amazon Payのテストのための疑似環境を提供しております。
Authorizeコマンドの結果として返戻されたレスポンツコンテンツ（AmazonpayAuthorizeResponseDto.responseContents）によって消費者のブラウザを遷移させると、以下の疑似環境が表示されます。
Amazon Payの認証画面のイメージが表示されますのでそのまま「ログイン」ボタンをクリックして次の画面に遷移します。

Amazon Payのお支払方法・お届け先選択画面が表示されます。
「続行」ボタンをクリックすることで以降の遷移を確認でき、「ログアウト」ボタンを押すことでログイン画面に戻ります。

加盟店の決済確認画面を利用する場合、
「お届け先修正」などのAmazon Payの画面に戻る遷移をシミュレートする場合は以下のように遷移するボタンを実装することで実現可能です。

コマンドのエラーをシミュレートする

Authorize、Capture、Refund、ReAuthorize、UpdateConsent、UpdateAuthorizeコマンドの要求金額（"amount"）の一の位の値を調整することで、意図的にエラーを発生させることができます。
Cancel、GetAddressコマンドは、対象取引の決済金額が要求金額に相当します。
（Captureコマンドで金額を指定しない場合は、対象取引の決済金額が要求金額に相当します。）
（Refundコマンドで金額を指定しない場合は、対象取引の返金可能金額が要求金額に相当します。）

Terminateコマンドは、対象取引の決済金額の千の位の値を調整することで、意図的にエラーを発生させることができます。
決済金額が1000未満の場合、千の位は"0"として処理されます。
要求金額の一の位と、返戻されるvResultCodeの対応表を以下に記載します。

※1：Authorizeコマンドの返戻ではなく、消費者が操作完了した後に返戻する結果コードを記載しております。
　　決済申込で加盟店の決済確認画面を利用するパターンにおいて、決済申込処理の途中でコマンドを実施した際の結果コードは下記の通りになります。
　　金額の一の位が7の取引でGetAddressを実施 ... 6GD1(失敗)
　　金額の一の位が9の取引でUpdateAuthorizeを実施 ... 6GD1(失敗)
　　上記以外 ... 6001(成功)
※2：「決済申込の中断」「売上の受付」に対する結果通知を行う前に、後続処理の要求を行った場合は6C01（失敗）となります。

※3：決済申込、 ReAuthorizeコマンド、Captureコマンド、Cancelコマンド、Refundコマンド、UpdateAuthorizeコマンドで成功もしくは失敗となったダミー取引について、直ちに結果通知を行います。
※4：「決済申込の中断」「売上の受付」「売上の中断」「返金の受付」「キャンセルの中断」となったダミー取引について、下記の通り結果通知を行います。
金額の一の位が6の返金の取引 ... コマンド返戻の約30秒後に結果通知を行います。
金額の一の位が6、9以外の返金、9以外の売上、7のキャンセルの取引 ... コマンド返戻の約10秒後に結果通知を行います。
金額の一の位が3、5、6の決済申込、8のキャンセルの取引 ... コマンド返戻から数分後に結果通知を行います。（返戻までの間隔は不定となります。）
※5,6：決済申込処理の途中で実施するコマンドの結果コードにおいては、※1を参照してください。

返戻されるエラーコード（vResultCode）につきましては、今後、予告なしに変更させていただく場合がございます。

要求金額の千の位と返戻されるvResultCodeの対応表を以下に記載します。

※1：Terminateコマンドで成功もしくは失敗となったダミー取引について、直ちに結果通知を行います。
※2：「解約の中断」となったダミー取引について、コマンド返戻の約10秒後に結果通知を行います。
※3：随時決済の「決済申込の成功」となったダミー取引について、金額の千の位が9の場合、コマンド返戻から約5分後に抹消通知を行います。

返戻されるエラーコード（vResultCode）につきましては、今後、予告なしに変更させていただく場合がございます。