| ▶︎ | 購入者は、Amazon Pay Hosted pageにリダイレクトされ、AmazonのログインID、パスワードでログインします | ▶︎ | ログインが完了すると、購入者は"住所/支払いが選択できるHosted Page"、 または、"住所/支払いが選択できないHosted Page"で 「続行」ボタンをクリックします。 どちらのHosted Pageを表示するかを事業者側でコントロールすることは基本的にできませんので、ご注意ください。 住所/支払いが選択できるHosted PageproductType="PayAndShip"の場合Merchant テスト姓名 153-0064 東京都目黒区下目黒1-8-1 VISA 末尾 1111 Amazon Payの利用をキャンセルして xxxに戻る > productType="PayOnly"の場合Merchant VISA 末尾 1111 Amazon Payの利用をキャンセルして xxxに戻る > 「変更」ボタンをクリックした場合 お届け先を選択してください ◉ テスト姓名二 1530064 Tokyo 目黒区下目黒1-8-1 日本 ○ テスト姓 名スペース 153-0064 東京都目黒区 下目黒1-8-1 日本 + 新しい住所を追加 支払い方法を選択してください ◉ VISA 末尾1111 xxx 有効期限 05/2023 ○ American Express 末尾 0005 xxxx 有効期限 05/2023 住所/支払いが選択できないHosted PagePayAndShipの場合Amazonアカウントでログインしています Amazon Payの利用をキャンセルして xxxに戻る > | ▶︎ | 購入者が「続行」をクリックすると、 AmazonはcreateCheckoutSessionConfig.payloadJSONに設定いただいた checkoutReviewReturnUrlへリダイレクトします。このリダイレクト先へは、amazonCheckoutSessionIdがURLパラメータとして付加されます 例) https://anyurl.com/review/? amazonCheckoutSessionId=26be7331-7dc2-4722-be22-f7e75582d3ef | ▶︎ | | ▶︎ | 事業者は、APIレスポンスで取得した情報(お届け先、支払い方法等)を事業者の注文確認画面に表示します。 注文確認ページ 〒153-0064 東京都目黒区下目黒1-8-1 アマゾン太郎 VISA 1111xxxx (Amazon Pay) ご注文内容 お届け先住所および氏名についてproductType=PayAndShipを選択した場合は、Amazonから取得したお届け先 (shippingAddress)を表示します。 お届け先住所に関する注意点Get Checkout Session APIのresponseに含まれる shippingAddressを使用します。 shippingAddressの情報については 日本では使用されていない項目などもありますので注意が必要です。詳細は以下のFAQをご覧ください。 FAQ - アカウント情報として何が取得できますか? > アドレス帳(お届け先住所) Checkout Session: shippingAddressまた 氏名や住所フォーマットが事業者の望むような形で成形されていない可能性があります(氏名が姓と名で分かれていない、市区町村、町域、番地のような区分で分かれていない)。 さらに 姓名のふりがなはAmazonからご提供していません。そのため、Amazonアカウントの氏名を姓と名に分割したり、住所のAddressLine1、AddressLine2およびAddressLine3の内容を市区町村、町域、番地、および、マンション・建物名に分割するサンプルコード、また、姓名のふりがなを生成するサンプルコードをご提供しています。 サンプルコードは以下のFAQから取得ください。 FAQ - Amazonアカウントから取得した住所や姓名を分割したいです 支払い方法についてAmazonから取得した支払い方法(paymentPreferencesのpaymentDescriptor)を表示します。 支払い方法に関する注意点Get Checkout Session APIのresponseに含まれる paymentPreferencesのpaymentDescriptorを使用します "paymentDescriptor": "Visa ****1111 (Amazon Pay)" このような形で、 支払い方法をテキストで連携しますので、それをそのまま表示します。なお、ギフトカードが利用できるような購入のケースでは、ギフトカードを含めた形でpaymentDescriptorが表示されます。 "paymentDescriptor": "Amazonギフトカード と Visa ****6069 (Amazon Pay)" 詳細は以下のFAQをご覧ください。 FAQ - Amazonギフトカードの利用について注意点を知りたいです。 | お届け先住所やお支払い方法をAmazonサイトに複数登録しているお客様がこの画面から別の住所/ 支払い方法へ変更できるよう、事業者は 「変更」 ボタンの設置をお願いいたします。 「変更」ボタンには、bindChangeAction実装します。 これにより「変更」ボタンをクリックした際に購入者は再びAmazon Pay Hosted pageにリダイレクトされ、お届け先や支払い方法を変更します。 bindChangeActionの詳細は以下のインテグレーションガイドをご覧ください。 インテグレーションガイド - 配送と支払い方法の更新この「変更」ボタンからAmazon Pay以外の支払い方法へ変更させるにはどうすれば良いか?というご質問をいただくことがあります。 こちらの注文確認ページはAmazon Payでログインした後に表示される画面となっており、購入者は明示的にAmazon Payを選択済みの状態ですので、混乱を避けるためにもこのタイミングで別の支払い方法へ変更させるフローは避けていただきますようお願いいたします。 「変更」ボタンはあくまでAmazonに登録済みの別の支払い方法へ変更するためのボタンとなります
注文確認ページ 〒153-0064 東京都目黒区下目黒1-8-1 アマゾン太郎 VISA 1111xxxx (Amazon Pay) ご注文内容 「変更」ボタンをクリックすると、住所/支払いが選択できるHosted Pageが表示されますproductType="PayAndShip"の場合Merchant テスト姓名 153-0064 東京都目黒区下目黒1-8-1 VISA 末尾 1111 Amazon Payの利用をキャンセルして xxxに戻る > productType="PayOnly"の場合Merchant VISA 末尾 1111 Amazon Payの利用をキャンセルして xxxに戻る > 「変更」ボタンをクリックした場合 お届け先を選択してください ◉ テスト姓名二 1530064 Tokyo 目黒区下目黒1-8-1 日本 ○ テスト姓 名スペース 153-0064 東京都目黒区 下目黒1-8-1 日本 + 新しい住所を追加 支払い方法を選択してください ◉ VISA 末尾1111 xxx 有効期限 05/2023 ○ American Express 末尾 0005 xxxx 有効期限 05/2023 | ▶︎ | 購入者は、「注文を確定する」ボタンをクリックします。 注文確認ページ 〒153-0064 東京都目黒区下目黒1-8-1 アマゾン太郎 VISA 1111xxxx (Amazon Pay) ご注文内容 | ▶︎ | 既存のamazonCheckoutSessionに対して、金額 (chargeAmount)、決済請求タイプ(paymentIntent)をセットし、 Update Checkout Session APIを呼び出します。 Paymentには3つの種類があり、選択したpaymentIntentにより後続の処理が異なって来ますのでご注意ください。paymentIntentの詳細は、 実装前の前提知識 - 主要なパラメータ - paymentIntentを参照ください。 Update Checkout Sessionが成功するとAPI responseでamazonPayRedirectUrlが返りますので、 事業者からamazonPayRedirectUrlへリダイレクトします。 API responseの "WebCheckoutDetails"内に "amazonPayRedirectUrl": "https://pay.amazon.com/redirect/checkoutId-1"という形でamazonPayRedirectUrlが返ってきます。 Ref: インテグレーションガイド - Update Checkout Sessionレスポンスサンプル | ▶︎ | 処理が完了すると、Amazonは、Amazon PayボタンのpayloadJSON. webCheckoutDetails.checkoutResultReturnUrlに設定した URLへリダイレクトします。遷移先URLには amazonCheckoutSessionIdパラメータが追加されます 例)https://anyurl.com/result/?amazonCheckoutSessionId=26be7331-7dc2-4722-be22-f7e75582d3ef | ▶︎ | | ▶︎ | |