Login and Pay with Amazon Integration Guide

Transcription

1 Amazon ログイン & ペイメント インテグレーションガイド

2 Amazon ログイン & ペイメント インテグレーションガイド 2 目 次 概 要... 4 重 要 な 前 提 条 件... 4 Amazon ログイン & ペイメントの 仕 組 み... 4 重 要 な 概 念... 5 購 入 者 エクスペリエンスの 概 要... 9 インテグレーションの 概 要 作 業 の 開 始 Eメールに 表 示 されるデータの 処 理 オーソリの 同 期 モードと 非 同 期 モード AddressBookウィジェットなしのインテグレーション スマートフォン 用 の 折 りたたみ 可 能 ウィジェットの 使 用 複 雑 な 支 払 いシナリオへの 対 応 購 入 後 に 注 文 が 変 更 された 場 合 の 支 払 いへの 対 応 支 払 い 拒 否 への 対 応 システムとAmazon Paymentsの 同 期 テスト 環 境 とのインテグレーションのテスト エラーの 処 理 ボタンギャラリー スタイルのガイドライン Amazon ログイン & ペイメント インテグレーションガイド 2

3 Amazon ログイン & ペイメント インテグレーションガイド 3 Amazon ログイン & ペイメント インテグレーションガイド Copyright Amazon.com, Inc. or its affiliates. AMAZON AMAZON PAYMENTS およびAMAZON.COMは Amazon.com, Inc.またはその 関 連 会 社 の 商 標 です その 他 のすべての 商 標 は 各 所 有 者 の 財 産 です 最 終 更 新 日 :2015 年 11 月 2 日 Amazon ログイン & ペイメント インテグレーションガイド 3

4 Amazon ログイン & ペイメント インテグレーションガイド 4 概 要 Amazon ログイン & ペイメントは Amazon 購 入 者 がセラーのサイトで 購 入 する 場 合 のログインと 支 払 いに 利 用 できる 安 全 で 信 頼 性 に 優 れた 便 利 な 方 法 です 購 入 者 は Amazon ログイン & ペイメントを 使 用 して プロファイル 情 報 ( 名 前 Eメールアドレス および 郵 便 番 号 )を 共 有 し Amazonアカウントに 保 存 している 配 送 先 情 報 と 支 払 い 情 報 にアクセスして 購 入 を 完 了 します このガイドでは Amazon ログイン & ペイメントと 呼 ばれるAPIベースのインテグレーションの 詳 細 について 説 明 します Amazon ログイン & ペイメントにより セラーの 支 払 い 条 件 に 応 じた 柔 軟 なカスタマイズが 可 能 になります 重 要 な 前 提 条 件 注 :Amazon ログイン & ペイメントサービスは Webブラウザー 内 のみでの 使 用 を 目 的 に 設 計 および 開 発 されています このサービスは (ios Android RIM Windowsのオペレーティングシステムを 含 むがこれに 限 定 されない)ネイティブアプリケーションでは 使 用 できません Amazon ログイン & ペイメントは ネイティブアプリケーション 内 でこのサービスを 実 装 しているAmazonのサービスのい かなるユーザーの 支 払 いアカウントを 一 時 的 に 停 止 する 権 利 を 留 保 します Amazon ログイン & ペイメントサービスの 前 提 条 件 は 次 のとおりです アプリケーション 開 発 用 のHTML JavaScript XMLの 使 用 経 験 WebサービスAPIの 使 用 経 験 セラーセントラルポータルに 精 通 していること セラーIDは( 別 名 マーチャントID)はAmazon ログイン & ペイメントのセラーアカウントで す Amazon ログイン & ペイメントセラーアカウントは Amazon ログイン & ペイメントサービス を 設 定 しておく 必 要 があります Amazon ログイン & ペイメントのセラーアカウントを 作 成 または 既 存 のセラーアカウントをAmazon ログイン & ペイメント 用 に 設 定 するには Amazon ログイン & ペイ メント Webサイト( ログイン & ペイメ ントの 導 入 に 関 するお 問 い 合 わせから 登 録 します AmazonマーケットプレイスWebサービス(Amazon MWS)のアクセスキーと 秘 密 キーでアクセスします こ れらのキーを 取 得 するには Amazon MWSに 登 録 するか 開 発 者 のキーを 使 用 してセラーの 代 わりに 開 発 者 が 呼 び 出 しできるように 認 証 します 詳 しくは Amazon MWS 開 発 者 ガイドの Amazon MWS 利 用 へ の 登 録 を 参 照 してください WebサイトをAmazonログインアプリケーションコンソールのアプリケーションとして 登 録 します 詳 し くは Amazonログインスタートガイド( 英 語 資 料 :Login with Amazon Getting Started Guide fo r Websitesを 参 照 ) を 参 照 してください クライアント 識 別 子 (クライアントID)は Webサイトを 登 録 すると 設 定 されます この 識 別 子 はインテグレーションに 必 要 になります 購 入 者 のブラウザーでJavaScriptを 有 効 にする 必 要 があります 購 入 者 のブラウザーでCookieを 有 効 にする 必 要 があります Amazon ログイン & ペイメントの 仕 組 み Amazon ログイン & ペイメントは 既 存 のWebサイトに 直 接 埋 め 込 まれ 購 入 者 とAmazon ログイン & ペイメ ントとのすべてのやり 取 りは 埋 め 込 みウィジェットで 行 われるため 購 入 者 はセラーのサイトから 移 動 する 必 要 がありません 購 入 者 は Amazonログイン 認 証 を 使 用 して 配 送 先 住 所 と 支 払 方 法 を 選 択 してから 注 文 を 確 定 できます Amazon ログイン & ペイメントと 購 入 者 のすべてのやり 取 りは 埋 め 込 みウィジェットで 行 われるため 購 入 者 はセラーのサイトから 移 動 する 必 要 がありません 選 択 したインテグレーションボタンのオプションに 応 じて 購 入 者 はセラーのサイトでチェックアウトプロセスを 開 始 する 前 開 始 中 または 開 始 した 後 に 認 証 できます 購 入 者 は Amazonログインを 使 用 してセラーのサイトにサインインするか ゲスト 用 のチェッ クアウトプロセスを 使 用 できます どちらの 場 合 も 購 入 者 はAmazonアカウントの 配 送 先 情 報 と 支 払 い 情 報 を 使 用 して チェックアウトプロセスを 完 了 できます Amazon ログイン & ペイメント インテグレーションガイド 4

5 Amazon ログイン & ペイメント インテグレーションガイド 5 重 要 な 概 念 Amazon ログイン & ペイメントのエンドツーエンドのエクスペリエンスは 購 入 者 のチェックアウトとセラ ーへの 支 払 い 処 理 を 簡 単 で 安 全 にすることを 目 的 としています インテグレーションを 開 始 する 前 に この サービスに 関 するいくつかの 重 要 な 概 念 を 理 解 しておいてください ボタンウィジェット Amazon ログイン & ペイメントとのインテグレーションを 開 始 するには 購 入 者 のログインとチェックアウ ト 用 のボタンウィジェットをセラーのサイトに 埋 め 込 みます 選 択 したボタンウィジェットに 応 じて 購 入 者 がセラーのサイトでチェックアウトプロセスを 開 始 する 前 開 始 中 または 開 始 した 後 に 名 前 Eメー ルアドレス 郵 便 番 号 などの 購 入 者 情 報 を 取 得 できます 次 の 表 では ボタンウィジェットのオプションに ついて 詳 しく 説 明 します ボタン Amazonログイン Login with Amazon ユースケース このボタンを 使 うことで 購 入 者 はサイトにログインでき Amazonアカウントを 利 用 し て 支 払 えます 購 入 者 は 注 文 処 理 を 開 始 する 前 開 始 中 または 開 始 した 後 にログ インすることができます 購 入 者 はAmazonアカウントに 登 録 されているプロファイル 情 報 ( 名 前 Eメールアドレス 郵 便 番 号 ) 配 送 先 住 所 支 払 情 報 をサイトでの 購 入 を 完 了 するために 共 有 できます 購 入 者 がAmazonアカウント 認 証 でログインした 後 : 購 入 者 の 名 前 Eメールアドレスを 含 むAmazonプロファイルの 情 報 を 受 信 しま す 購 入 者 の 購 入 エクスペリエンスのカスタマイズや 参 照 履 歴 の 追 跡 を 行 うた めに この 情 報 を 利 用 することができます 購 入 者 はログインしてから55 分 間 は Amazonアカウントに 登 録 されている 配 送 と 支 払 情 報 をアクセスしたサイト 上 にあるペイメントウィジェットで 使 用 する ことができます 55 分 経 てば 認 証 されたトークンの 有 効 期 限 が 切 れます 購 入 者 にもう 一 度 ログイン 要 求 する 必 要 があります 購 入 者 が 配 送 先 住 所 を 選 択 したとき クリックしてすぐに 完 全 な 配 送 先 住 所 に アクセスできます このボタンを 以 下 の 例 のように 利 用 されるべきです: 購 入 者 は 購 入 履 歴 の 確 認 やサイト 上 の 特 別 なお 得 な 情 報 が 必 要 な 場 合 です 購 入 者 がログインしてから1 時 間 内 で Amazonに 登 録 されている 配 送 先 と 支 払 情 報 を 使 ってたくさんの 商 品 をたったの2クリックで 購 入 することができます 購 入 者 がチェックアウト( 注 文 する)ボタンをクリックし 注 文 処 理 中 にAmazo nログインを 使 って 認 証 し それからAmazonアカウントに 登 録 されている 配 送 先 と 支 払 情 報 にアクセスして2クリックで 注 文 処 理 を 完 了 します 購 入 者 が 注 文 履 歴 にアクセスや 商 品 の 追 跡 ができるように 注 文 処 理 の 最 後 に サイトへ 登 録 するオプションを 与 えたい 場 合 です 購 入 者 はサイトにAmazonアカウントで 初 回 ログインした 場 合 は 同 意 画 面 が 表 示 されま す 同 意 画 面 は 次 の 購 入 者 情 報 をセラーのサイトで 共 有 する 権 限 を 要 求 します : 購 入 者 の 名 前 Eメールアドレス 郵 便 番 号 購 入 者 の 注 文 前 に 選 択 された 配 送 先 住 所 購 入 者 が 情 報 を 共 有 しないと 決 めた 場 合 は 認 証 トークンはaccess_deniedのレスポン スメッセージを 投 げ 購 入 者 はAmazonアカウントからの 支 払 と 配 送 先 の 情 報 を 登 録 する ことができません Amazon ログイン & ペイメント インテグレーションガイド 5

6 Amazon ログイン & ペイメント インテグレーションガイド 6 Amazonペイメント(ゲスト 注 文 ) Pay with Amazon (guest checkout) このボタンを 利 用 することで 処 理 を 完 了 する 前 に 個 人 情 報 を 共 有 せずに 購 入 者 がAmaz onアカウントに 登 録 されている 配 送 先 と 支 払 情 報 を 使 いゲストのように 処 理 を 完 了 でき ます 購 入 者 がAmazonアカウントから 配 送 先 住 所 にアクセスするためにサインインし 消 費 税 と 配 送 料 を 計 算 する 目 的 のために 市 区 町 村 国 郵 便 番 号 を 受 け 取 れます Amazonアカウントを 使 用 してチェックアウト 処 理 を 完 了 させた 後 に 購 入 者 の 名 前 E メールアドレス 配 送 先 住 所 を 受 け 取 れます 購 入 者 がチェックアウト 処 理 を 完 了 しな かった 場 合 は 顧 客 情 報 を 受 け 取 れません Amazonを 使 用 してサインインするときは 購 入 者 に 同 意 画 面 が 表 示 されません Amazonペイメント( 完 全 な 配 送 先 住 所 にアクセス) Pay with Amazon (access to full sh ipping address) このボタンを 利 用 することで 処 理 が 完 了 する 前 でプロファイル 情 報 と 完 全 な 配 送 先 情 報 を 共 有 している 間 は 購 入 者 がAmazonアカウントでセラーのサイトにログインと 支 払 ができます 購 入 者 がAmazonでログインした 後 : 購 入 者 のAmazonプロファイルから 名 前 とEメールアドレスを 含 む 情 報 を 受 け 取 れ ます 購 入 者 の 購 入 体 験 や 閲 覧 履 歴 の 追 跡 をカスタマイズするためにこの 情 報 を 利 用 できます 購 入 者 はログインしてから55 分 間 は Amazonアカウントに 登 録 されている 配 送 と 支 払 情 報 をアクセスしたサイト 上 にあるペイメントウィジェットで 使 用 する ことができます 55 分 経 てば 認 証 されたトークンの 有 効 期 限 が 切 れ 購 入 者 に もう 一 度 ログイン 要 求 する 必 要 があります 購 入 者 が 配 送 先 住 所 を 選 択 したとき クリックしてすぐに 完 全 な 配 送 先 住 所 に アクセスできます このボタンを 以 下 の 例 のように 利 用 されるべきです: 購 入 者 がカートページから 支 払 処 理 を 開 始 Amazonアカウントに 登 録 されてい る 配 送 先 と 支 払 情 報 にアクセスしたい 場 合 フルフィルメントのための 完 全 な 配 送 先 住 所 や 処 理 の 完 了 前 に 消 費 税 計 算 する 必 要 がある 場 合 購 入 者 はサイトにAmazonログインで 初 回 サインインした 場 合 は 同 意 画 面 が 表 示 されま す 同 意 画 面 は 次 の 購 入 者 情 報 を 共 有 する 権 限 を 要 求 します : 購 入 者 の 名 前 Eメールアドレス 郵 便 番 号 購 入 者 の 注 文 前 に 選 択 された 配 送 先 住 所 アクセストークン ユーザーがサイトにログインすると オーソリサーバーによってアクセストークンが 付 与 されます アクセ ストークンは クライアント ユーザー およびアクセススコープに 固 有 です クライアントは アクセス トークンを 使 用 して 購 入 者 のプロファイルデータを 取 得 し 配 送 先 情 報 と 支 払 い 情 報 にアクセスできるよ うにする 必 要 があります 支 払 いオブジェクト 支 払 いオブジェクトは Amazon ログイン & ペイメントの 支 払 いプロセスをサポートする 請 求 ブロックで す このガイドでは 次 のオブジェクトについて 説 明 します Order Referenceオブジェクト このオブジェクトは 購 入 者 の 支 払 い 処 理 に 必 要 な 重 要 な 属 性 の 記 録 です 配 送 先 住 所 や 支 払 い 方 法 など これらの 属 性 の 一 部 はチェックアウトプロセス 中 に 購 入 者 が 指 定 し 合 計 金 額 や 注 文 IDなど 注 文 に 関 する 情 報 はセラーが 設 定 します Authorizationオブジェクト このオブジェクトは 選 択 した 支 払 い 方 法 で 決 済 が 可 能 かどうかを 表 し キャプチャーリクエストを 使 用 して 今 後 の 回 収 のために 資 金 を 取 り 置 きます Captureオブジェクト このオブジェクトは 購 入 者 の 支 払 い 方 法 からセラーのAmazon ペイメントセラー アカウントへの 資 金 の 動 きを 表 します Refundオブジェクト このオブジェクトは 返 金 が 発 生 した 場 合 に 以 前 Caputureされた 資 金 を 購 入 者 のアカウントに 戻 す 動 きを 表 します Amazon ログイン & ペイメント インテグレーションガイド 6

7 Amazon ログイン & ペイメント インテグレーションガイド 7 これらの 各 オブジェクトは 一 意 の 識 別 子 によって 識 別 され それぞれステータスが 割 り 当 てられます これらのオブジェクトの 使 用 については このガイドの 次 の 章 で 詳 しく 説 明 します ウィジェット ウィジェットとは セラーのサイトに 埋 め 込 み 可 能 なAmazonホストコントロールです ウィジェットによ り 購 入 者 はセラーのサイトへのログイン Amazonクレデンシャルを 使 用 した 認 証 Amazonアカウントに 保 存 している 住 所 と 支 払 い 方 法 の 表 示 購 入 で 使 用 する 住 所 と 支 払 い 方 法 の 選 択 が 可 能 になります 選 択 した 住 所 と 支 払 い 方 法 の 情 報 は Order Referenceオブジェクトに 保 存 されます Amazon ログイン & ペイメントとのインテグレーションでは 次 の4つのウィジェットを 使 用 できます Amazonアカウントでログイン ボタンウィジェット:このウィジェットでは チェックアウトプロ セスの 開 始 前 開 始 中 または 開 始 後 に 購 入 者 がAmazonアカウントを 使 用 して セラーのサイトにログ インできます このウィジェットは セラーのサイトのホームページなどの 目 立 つ 場 所 に 配 置 することを お 勧 めします 次 のイメージは Amazonアカウントでログイン ボタンウィジェットを 示 しています Amazonアカウントでお 支 払 い ボタンウィジェット:このウィジェットでは 購 入 者 が 支 払 いにA mazon ペイメントを 選 択 し Amazonで 認 証 できます このウィジェットは ショッピングカートや 製 品 の 詳 細 ページなど 通 常 は 購 入 者 がチェックアウトプロセスを 開 始 するページに 配 置 します 次 のイメ ージは Amazonアカウントでお 支 払 い ボタンウィジェットを 示 しています AddressBookウィジェット:AddressBookウィジェットには 購 入 者 のAmazonアカウントに 保 存 している 住 所 が 表 示 されます このウィジェットにより 購 入 者 から 住 所 を 収 集 するのに 使 用 する 手 入 力 のフォ ームが 不 要 になります 次 のイメージは AddressBookウィジェットを 示 しています Amazon ログイン & ペイメント インテグレーションガイド 7

8 Amazon ログイン & ペイメント インテグレーションガイド 8 Walletウィジェット:Walletウィジェットには 購 入 者 のAmazonアカウントに 保 存 している 支 払 い 方 法 が 表 示 されます このウィジェットにより 購 入 者 から 支 払 い 方 法 の 情 報 を 収 集 するのに 使 用 する 手 入 力 のフォームが 不 要 になります 次 のイメージは Walletウィジェットを 示 しています アプリケーションプログラミングインタフェース(API) Amazon ペイメントとセラーの 内 部 システム 間 で 情 報 と 命 令 を 交 換 するには Off-Amazon Payments API セクションのオペレーションを 呼 び 出 します たとえば 購 入 者 プロファイル 情 報 の 取 得 Amazonへの 購 入 者 請 求 のリクエスト 返 金 購 入 者 の 配 送 先 情 報 の 取 得 注 文 内 容 のキャンセルには これらのオ ペレーションを 呼 び 出 します 詳 しくは Off-Amazon Payments APIセクションリファレンスを 参 照 して ください インスタントペイメント 通 知 (IPN) Amazonでは 支 払 いリクエスト(Authorize Capture およびRefundリクエスト)を 非 同 期 で 処 理 します Amazonがリクエストを 処 理 すると インスタントペイメント 通 知 (IPN)と 呼 ばれる 通 知 がセラーに 送 信 さ れ リクエストの 最 終 ステータスが 通 知 されます また 支 払 いオブジェクトのステータスは セラーによって 送 信 されたリクエストまたは 内 部 のAmazonビジ ネスルールにより 変 更 される 場 合 があります 支 払 いオブジェクトのステータスが 変 更 されると Amazonか らセラーにIPNが 送 信 され セラーは 自 社 システムとAmazon ペイメントとの 同 期 を 保 つことができます 詳 しくは システムとAmazon ペイメントの 同 期 を 参 照 してください Amazon ログイン & ペイメント インテグレーションガイド 8

9 Amazon ログイン & ペイメント インテグレーションガイド 9 購 入 者 エクスペリエンスの 概 要 Amazon ログイン & ペイメントでは 数 回 クリックするだけで 購 入 者 がセラーのサイトで 購 入 を 完 了 できます 以 下 は Amazon ログイン & ペイメントでの 購 入 者 エクスペリエンスの 例 です Amazon ログインでの 購 入 者 エクスペリエンス Amazon ペイメントでの 購 入 者 エクスペリエンス Amazon ログインでの 購 入 者 エクスペリエンス 1. 購 入 者 は チェックアウト をクリックし チェックアウトプロセスを 開 始 します Amazon ログイン & ペイメント インテグレーションガイド 9

10 Amazon ログイン & ペイメント インテグレーションガイド 購 入 者 は Amazonアカウントでログイン( 下 図 :Login with Amazon) ボタンをクリックし ログイン して 支 払 います Login and Pay with Amazonインテグレーションガイド 10

11 Amazon ログイン & ペイメント インテグレーションガイド 購 入 者 はAmazonのユーザー 名 とパスワードを 使 用 してサインインします Login and Pay with Amazonインテグレーションガイド 11

12 Amazon ログイン & ペイメント インテグレーションガイド 購 入 者 は 購 入 者 情 報 をセラーと 共 有 することに 同 意 します(セラーのサイトの 初 回 ログイン 時 にのみ 必 要 ) Login and Pay with Amazonインテグレーションガイド 12

13 Amazon ログイン & ペイメント インテグレーションガイド 購 入 者 はAddressBookウィジェットから 配 送 先 住 所 Walletウィジェットから 支 払 い 方 法 を 選 択 し 注 文 します Login and Pay with Amazonインテグレーションガイド 13

14 Amazon ログイン & ペイメント インテグレーションガイド 14 Amazon ペイメントでの 購 入 者 エクスペリエンス 1. 購 入 者 は Amazonアカウントでお 支 払 い( 下 図 :Pay with Amazon) ボタンをクリックし チェッ クアウトプロセスを 開 始 します Login and Pay with Amazonインテグレーションガイド 14

15 Amazon ログイン & ペイメント インテグレーションガイド 購 入 者 はAmazonのユーザー 名 とパスワードを 使 用 してサインインします Login and Pay with Amazonインテグレーションガイド 15

16 Amazon ログイン & ペイメント インテグレーションガイド 購 入 者 が 購 入 者 情 報 をセラーと 共 有 することに 同 意 すると(セラーのサイトの 初 回 ログイン 時 にの み 必 要 ) セラーは 購 入 者 の 完 全 な 配 送 先 住 所 を 取 得 します Amazonアカウントでお 支 払 いボタン のゲスト 用 チェックアウトを 使 用 している 場 合 購 入 者 にはこの 画 面 は 表 示 されません Login and Pay with Amazonインテグレーションガイド 16

17 Amazon ログイン & ペイメント インテグレーションガイド 購 入 者 がAddressBookウィジェットから 配 送 先 住 所 Walletウィジェットから 支 払 い 方 法 を 選 択 し 注 文 します Login and Pay with Amazonインテグレーションガイド 17

18 Amazon ログイン & ペイメント インテグレーションガイド セラーから 購 入 者 に 注 文 確 認 が 送 信 されます 上 記 のシナリオでは 購 入 者 はチェックアウトプロセスを 開 始 し Amazonアカウントでログイン ボタ ンまたは Amazonアカウントでお 支 払 い ボタンをクリックします 次 に 購 入 者 はAmazonアカウントに サインインして プロファイル 情 報 ( 名 前 とEメールアドレス)を 共 有 し 支 払 い 情 報 と 配 送 先 情 報 にアクセ スして 処 理 を 完 了 します これらのシナリオでは 購 入 者 はプロファイル 情 報 を 共 有 しており セラーは セラーのWebサイトにアカウントを 作 成 できます Amazon ログイン & ペイメントとのインテグレーション では Amazonアカウントでお 支 払 い ボタンをゲスト 用 のチェックアウトとして 使 用 し 購 入 者 がログ インすることなく セラーのサイトで 支 払 いすることもできます このボタンは チェックアウトプロセ スの 開 始 前 開 始 中 または 開 始 後 に 購 入 者 がアクセスするセラーのWebサイトの 任 意 のページに 追 加 でき ます 購 入 者 がAmazon ログインですでにログインしている 場 合 は Amazonアカウントでお 支 払 い ボ タンをチェックアウトボタンとして 使 用 できます 購 入 者 は 再 度 サインインする 必 要 はありません セラーのサイトで Amazonアカウントでログイン ボタンを 使 用 するメリットについて 詳 しくは ボタ ンウィジェット を 参 照 してください Amazonアカウントでログイン ボタンの 配 置 のサンプルイメージと 使 用 については スタイルのガイ ドライン を 参 照 してください Login and Pay with Amazonインテグレーションガイド 18

19 Amazon ログイン & ペイメント インテグレーションガイド 19 インテグレーションの 概 要 以 下 は セラーのWebサイトにAmazon ペイメントを 設 定 し 簡 単 なシナリオの 支 払 いを 回 収 するにあたって の 一 般 的 なプロセスの 概 要 です 各 ステップは 購 入 の 有 効 化 と 支 払 い 処 理 の2つの 部 分 に 分 けられます こ れらのステップについて 詳 しくは このガイドで 後 述 します Amazon ログイン & ペイメントでの 購 入 の 有 効 化 1. 購 入 者 がチェックアウトフローを 開 始 するページ(アカウントの 作 成 ページ ショッピングカート 製 品 の 詳 細 ページなど)に Amazonアカウントでログイン ボタンまたは Amazonアカウントでお 支 払 い ボ タンを 追 加 します このボタンを 使 って 購 入 者 はAmazonで 認 証 できます 2. 購 入 者 が 認 証 に 成 功 したら 配 送 先 住 所 を 収 集 するページにAmazon AddressBookウィジェット 支 払 い 情 報 を 収 集 するページにWalletウィジェットを 表 示 します 3. GetOrderReferenceDetailsオペレーションを 呼 び 出 して 配 送 先 住 所 を 取 得 し 税 金 と 配 送 費 を 計 算 しま す 配 送 費 と 税 金 の 金 額 を 購 入 者 に 表 示 します 4. オプションで 読 み 取 り 専 用 バージョンのAddressBookウィジェットとWalletウィジェットをセラーの 注 文 内 容 確 認 ページに 表 示 します 5. SetOrderReferenceDetailsオペレーションを 呼 び 出 し 注 文 合 計 とその 他 のオプションの 情 報 をAmazon に 通 知 します 6. 購 入 者 が 注 文 したら ConfirmOrderReferenceオペレーションを 呼 び 出 し 注 文 を 確 定 してAmazonに 通 知 します 7. Amazonアカウントでお 支 払 い ボタンをゲスト 用 のチェックアウトオプションとして 使 用 している 場 合 は GetOrderReferenceDetailsオペレーションを 呼 び 出 し Amazonから 完 全 な 配 送 先 住 所 を 取 得 しま す 8. 注 文 のお 礼 を 記 載 した 注 文 確 認 のメールを 購 入 者 に 送 信 します 支 払 いがオーソリ 処 理 された こと を 伝 えるEメールもAmazonから 購 入 者 に 送 信 されます 注 : 支 払 いがオーソリ 処 理 された ことを 伝 えるEメールは セラーが 注 文 内 容 を 確 定 してA mazonに 通 知 すると 購 入 者 に 送 信 されます このEメールで Amazon ペイメントを 使 用 して 購 入 の 支 払 いがオーソリ 処 理 されたことを 購 入 者 に 通 知 します このEメールは 注 文 時 点 ま たは 注 文 後 にセラーが 送 信 するAuthorizeリクエストとは 関 係 ありません Login and Pay with Amazonインテグレーションガイド 19

20 Amazon ログイン & ペイメント インテグレーションガイド 20 次 のイメージは Amazon ログインとAmazon ペイメントを 使 用 して 購 入 を 有 効 化 する 方 法 を 示 しています Login and Pay with Amazonインテグレーションガイド 20

21 Amazon ログイン & ペイメント インテグレーションガイド 21 次 のイメージは Amazon ペイメントを 使 用 して 購 入 を 有 効 化 する 方 法 を 示 しています 支 払 いの 処 理 1. Authorizeオペレーションを 呼 び 出 し 購 入 者 の 支 払 いをオーソリ 処 理 するようにAmazonにリクエス トします 2. オーソリインスタントペイメント 通 知 (IPN)でオーソリリクエストの 処 理 ステータスを 確 認 します Login and Pay with Amazonインテグレーションガイド 21

22 Amazon ログイン & ペイメント インテグレーションガイド 22 注 :Amazonでは Authorizeオペレーションに 同 期 モードと 非 同 期 モードの 両 方 を 用 意 しています 同 期 モードでは OpenまたはDeclinedの 即 時 処 理 ステータスがセラーに 通 知 されます 非 同 期 モ ードでは オーソリオブジェクトで 最 初 にPendingステータスが 通 知 されます 非 同 期 モード 処 理 が 完 了 すると インスタントペイメント 通 知 (IPN)でAmazonからセラーに 最 終 的 な 処 理 ステー タスが 通 知 されます 非 同 期 モードを 使 用 している 場 合 は Amazonから 最 終 的 な 処 理 ステータスが 通 知 されるまで セ ラーのサイトで 購 入 者 が 注 文 確 認 を 長 時 間 待 たされることがないようにしてください 注 文 を 確 定 してAmazonに 通 知 したら ただちに 注 文 確 認 ページを 購 入 者 に 表 示 するようにしてください ( 上 記 のステップ6) 3. 注 文 を 出 荷 し Captureオペレーションを 呼 び 出 して 支 払 いをキャプチャーします 4. キャプチャーIPNでキャプチャーリクエストの 処 理 ステータスを 確 認 します キャプチャーが 正 常 に 処 理 さ れると Amazonから 購 入 者 に 請 求 通 知 のEメールが 送 信 されます 5. 必 要 な 注 文 金 額 を 回 収 したら CloseOrderReferenceオペレーションを 呼 び 出 し Order Referenceオブジ ェクトをClosedとマークします Amazonでは この 情 報 を 使 用 して この 注 文 の 支 払 いが 完 了 した 旨 を 購 入 者 に 通 知 します 6. 返 金 が 必 要 な 場 合 は Refundオペレーションを 呼 び 出 すことで 返 金 できます 7. 返 金 IPNで 返 金 リクエストの 処 理 ステータスを 確 認 します 返 金 が 正 常 に 処 理 されると Amazonから 購 入 者 に 返 金 通 知 のEメールが 送 信 されます 次 のイメージは 支 払 いの 処 理 方 法 を 示 しています Login and Pay with Amazonインテグレーションガイド 22

23 Amazon ログイン & ペイメント インテグレーションガイド 23 作 業 の 開 始 作 業 の 開 始 手 順 注 :このガイドで 説 明 する 手 順 とサンプルコードを 利 用 すれば Amazon ログイン & ペイメントウ ィジェットをセラーのWebサイトに 埋 め 込 み Amazon ログイン & ペイメントテストモードでAPI 呼 び 出 しの 実 行 を 準 備 できます このテスト 環 境 では エンドツーエンドのインテグレーションをす ぐに 開 始 できます 本 番 環 境 への 切 り 替 えの 準 備 ができるまで Amazon ログイン & ペイメント 購 入 者 向 けの 要 素 を 公 開 する 必 要 はありません Amazon ログイン & ペイメントテストモードについ て 詳 しくは テスト 環 境 とのインテグレーションのテスト を 参 照 してください テスト 環 境 か ら 本 番 環 境 に 切 り 替 えるには 次 のように 変 更 します パラメーター テスト 環 境 の 値 本 稼 働 環 境 の 値 Amazon MWS endpoint ents_sandbox/ / ayments/ / Widgets.js URL Profile API endpoint es/g/09/ep/offamazonpayments/sandbox/prod/lp a/js/widgets.js azonpayments/jp/lpa/js/widgets.js certcn sns.amazonaws.com sns.amazonaws.com セラーのWebサイトでAmazon ログイン & ペイメントを 構 成 する Amazon ログイン & ペイメントとの 連 携 により 購 入 者 体 験 が 向 上 します Login with Amazonでは 使 用 するボタンオプション(Amazon ログインまたはAmazon ペイメント)に 関 係 なく いくつかの 基 本 構 成 を 実 行 する 必 要 があります Amazon ログイン 構 成 の 設 定 には Amazon ログイン & ペイメント セラーセン トラルページからアクセスします アプリケーションコンソールで 新 規 アプリケーションの 登 録 ボタンをクリックします アプリケーションの 登 録 フォームが 表 示 されます アプリケーション 詳 細 ページで セラーのWebサイトに 関 する 基 本 的 な 詳 細 を 追 加 します これらの 詳 細 は セラーのWebサイトとモバイルアプリ( 利 用 可 能 な 場 合 )に 使 用 されます a. 表 示 用 名 前 ユーザーがセラーのWebサイトと 情 報 を 共 有 することに 同 意 した 場 合 同 意 画 面 に 表 示 される 名 前 です この 名 前 は Android ios Webサイトのバージョンのアプリケーション に 適 用 されます b. 説 明 Amazonログインユーザー 用 のセラーのWebサイトの 説 明 です c. 個 人 情 報 保 護 方 針 のURL プライバシーURLは セラーの 会 社 のプライバシーポリシーの 場 所 です 同 意 画 面 にも 表 示 されます このリンクは セラーのアプリケーションの 初 回 のログイン 時 にユーザ ーに 表 示 されます( 例 : d. ロゴイメージファイル このロゴは Amazon 上 でのセラーのビジネスまたはWebサイトを 表 します ロゴ は 150x150ピクセルのイメージで 表 示 されます 異 なるサイズのファイルをアップロードした 場 合 は この サイズに 合 わせてサイズが 変 更 されます 終 了 したら 保 存 をクリックして 変 更 内 容 を 保 存 します セラーのアプリケーションにWebサイトを 追 加 する 1. アプリケーション 画 面 で ウェブサイト 設 定 をクリックします クライアントIDとクライアントシ ークレットの 値 が 自 動 的 に 割 り 当 てられます クライアントIDでは セラーのWebサイトを 識 別 し ク ライアントシークレットは セラーのWebサイトが 本 物 であることを 確 認 するために 使 用 されます パ Login and Pay with Amazonインテグレーションガイド 23

24 Amazon ログイン & ペイメント インテグレーションガイド 24 スワードなどのクライアントシークレットは 機 密 情 報 として 扱 います クライアントシークレットを 表 示 するには Secretを 表 示 する をクリックします 2. 許 可 済 みJavaScriptオリジンまたは 許 可 済 み 戻 りURLをアプリケーションに 追 加 し 編 集 する をク リックします 注 :WebサイトでAmazon ログインを 使 用 するには 許 可 済 みJavaScriptオリジン( 購 入 者 のポッ プアップログイン 操 作 ) または 許 可 済 み 戻 りURL( 購 入 者 のリダイレクトログイン 画 面 操 作 )のい ずれかを 指 定 する 必 要 があります Amazon ペイメントを 使 用 している 場 合 は いずれかのオプ ションを 指 定 する 必 要 があります a. オリジンとは プロトコル ドメイン 名 およびポートを 組 み 合 わせたものです( 例 : ww.example.com:8443) 許 可 済 みオリジンでは HTTPSプロトコルを 使 用 する 必 要 があります 標 準 ポート(ポート443)を 使 用 している 場 合 は ドメイン 名 のみを 含 める 必 要 があります( 例 :ht tps:// ここにセラーのドメインを 追 加 すると ログインプロセス 中 にJavaScript 用 SDKがセラーのWebサイト と 直 接 通 信 できます Webブラウザーは スクリプトで 明 確 に 許 可 していないかぎり 通 常 はスクリプ ト 間 のクロスオリジン 通 信 をブロックします 複 数 のオリジンを 追 加 するには さらに 追 加 する をクリックします b. セラーのWebサイトがLogin with AmazonオーソリサービスにHTTPS 呼 び 出 しを 実 行 しており 応 答 にredirect_uriを 指 定 している 場 合 は これらのリダイレクトURIを 許 可 済 み 戻 りURLに 追 加 します 戻 りURLには プロトコル ドメイン パス クエリー 文 字 列 が 含 まれます ( 例 : 複 数 の 戻 りURIを 追 加 するには さらに 追 加 する をクリックします 3. 保 存 する をクリックし Amazon ログインの 構 成 を 終 了 します Login and Pay with Amazonインテグレーションガイド 24

25 Amazon ログイン & ペイメント インテグレーションガイド 25 Amazon ログイン & ペイメントウィジェットを 使 用 するための 準 備 埋 め 込 みウィジェットをセラーのサイトに 適 切 に 表 示 するには ハンドラーをonAmazonLoginReadyコ ールバックに 指 定 し Amazon ログイン & ペイメント JavaScriptファイルの 参 照 (Widgets.js)をWeb ページのソースコードに 追 加 する 必 要 があります この 操 作 は Amazon ログイン & ペイメントウィ ジェットを 表 示 するページから 実 行 する 必 要 があります onamazonloginreadyコールバックを 定 義 し Amazon ログイン & ペイメント JavaScriptファイルの 参 照 を 追 加 するには 次 のサンプルコードに 示 すように コードを 数 行 追 加 します Amazon ペイメントではベス トプラクティスとして ボタン アドレス およびWalletの 各 ウィジェットが 表 示 されるセラーのWebペー ジのheadセクションに このコードを 配 置 することを 推 奨 しています またローカルコピーし Amazon 提 供 のJavaScriptの 内 容 を 変 更 すると ウィジェットの 表 示 や 機 能 のエラーなど 予 期 せぬ 結 果 が 発 生 する 場 合 が あるため このような 操 作 は 行 わないようにしてください <head> <script type='text/javascript'> window.onamazonloginready = function() { amazon.login.setclientid('your_client_id_here'); }; </script> <script type='text/javascript' src=' </script> </head> Amazon ログイン & ペイメント JavaScriptファイルの 参 照 をソースコードに 追 加 すると Amazon ロ グイン & ペイメントウィジェットの 埋 め 込 みを 開 始 できます ベストプラクティス 実 行 する 前 にデータをエンコード データのセキュリティはAmazon ペイメントの 一 番 の 関 心 事 です HTML JavaScriptのように 任 意 の 形 式 で 出 力 する 前 に 私 たちから 受 け 取 る 多 くのデータをエンコードすることを 提 案 します また URL 出 力 エンコーディングの 中 で 悪 意 のあるスクリプトや 他 から 挿 入 された 実 行 可 能 なスクリプトを 実 行 できないように 保 証 します WSAPI Open Web Application Security Project (OWASP) APIは 無 償 でオープンソースのWebアプリ ケーションセキュリティコントロールライブラリを 提 供 しています それらは リスクが 低 いアプリ ケーションをより 簡 単 に 作 れます この 標 準 的 なライブラリを 出 力 エンコードに 利 用 ください 次 の 例 はいくつかの 最 も 一 般 的 なタイプのデータエンコード 方 法 を 表 しています: HTML: String safe = ESAPI.encoder().encodeForHTML( request.getparameter( "input" ) ); 幅 名 前 値 のようなHTML 属 性 の 値 : String safe = ESAPI.encoder().encodeForHTMLAttribute( request.getparameter( "input" ) ); URLパラメーターの 値 : String safe = ESAPI.encoder().encodeForURL( request.getparameter( "input" ) ); JavaScriptデータの 値 String safe = ESAPI.encoder().encodeForJavaScript( request.getparameter( "input" ) ); 非 同 期 JavaScript Amazon ペイメントはJavaScriptをWebページに 速 やかに 提 供 するために 非 同 期 ローディングを 限 定 的 に サポートします 非 同 期 ローディングを 使 う 選 択 した 場 合 は Amazon ペイメントのサポートしている 唯 一 の 方 法 はスクリプトタグ 内 の 非 同 期 属 性 です Amazon ペイメントボタンを 非 同 期 でロードするには: Login and Pay with Amazonインテグレーションガイド 25

26 Amazon ログイン & ペイメント インテグレーションガイド window.onamazonpaymentsready 関 数 を 定 義 2. この 関 数 の 中 にOffAmazonPaymentsに 関 連 する 多 くのJavaScriptを 移 動 3. この 定 義 を 以 下 のWidgets.jsスクリプトタグに 追 加 4. Widgets.jsスクリプトタグに 非 同 期 属 性 を 追 加 タイミングの 問 題 を 防 ぐために 上 記 の 方 法 でスクリプトタグを 配 置 する 必 要 があります 例 : <script> window.onamazonpaymentsready = function(){ OffAmazonPayments.Button('LoginWithAmazon', '<Your-Seller-ID>', {... }; </script> <script async type='text/javascript' src=' </script> 注 :テスト 環 境 での 例 です 本 稼 働 環 境 のURLに 応 じてコードを 変 更 してください 詳 しい 非 同 期 属 性 のスクリプトタグの 情 報 は Mozilla Developer Network script tag Summaryを 参 照 してください ( ステップ1 - 購 入 者 の 認 証 用 ボタンウィジェットの 追 加 最 初 に 埋 め 込 む 必 要 がある 購 入 者 向 けのウィジェットは Amazon ログイン & ペイメントボタンウィジェ ットです このウィジェットには 注 文 の 支 払 いにAmazonアカウントを 使 用 できることを 購 入 者 に 通 知 す るボタンが 表 示 されます 必 要 なJavaScriptコードをセラーのWebサイトのheadセクションに 追 加 している 場 合 ( 作 業 の 開 始 セクシ ョンを 参 照 ) 次 のコードを 追 加 することで 選 択 したボタンを 埋 め 込 むことができます Amazon ログイン & ペイメントボタン: <div id="amazonpaybutton"/> <script type="text/javascript"> var authrequest; OffAmazonPayments.Button("AmazonPayButton", "YOUR_SELLER_ID_HERE", { type: "ENTER_TYPE_PARAMETER", color: "ENTER_COLOR_PARAMETER", size: "ENTER_SIZE_PARAMETER", authorization: function() { loginoptions = {scope: "ENTER_SCOPES", popup: ENTER_POPUP_PARAMETER}; authrequest = amazon.login.authorize (loginoptions, "YOUR_REDIRECT_URL_HERE"); }, onerror: function(error) { // your error handling code } }); </script> 上 記 のサンプルコードは セラーのWebページ 内 でボタンの 表 示 に 使 用 する 部 分 を 定 義 します このコー ドは ボタンを 表 示 したい 場 所 に 配 置 するようにしてください 登 録 時 に 通 知 されたセラーIDで YOUR_S ELLER_ID_HERE のテキストを 更 新 します セラーIDがわからない 場 合 は セラーセントラルにログイン Login and Pay with Amazonインテグレーションガイド 26

27 Amazon ログイン & ペイメント インテグレーションガイド 27 し 設 定 タブの インテグレーション 設 定 セクションにアクセスして セラーIDを 表 示 します ま た ENTER_TYPE_PARAMETERを 更 新 し 選 択 したボタンイメージを 表 示 します ボタンのcolorとsizeのパラメーターを 任 意 で 指 定 することもできます 次 の 表 は サポートされて いるプロパティーと プロパティーが 指 定 されていない 場 合 デフォルト 設 定 の 一 覧 です パラメーター type LwA Amazonアカウントでログインボタンを 指 定 typeを 指 定 していなかった 場 合 のデフォルトボタン color size Gold DarkGray LightGray デフォルト: Gold small (156px x 32px) medium (195px x 46px) large (312px x 64px) x-large (390px x 92px) デフォルト: medium パラメーター type PwA Amazonアカウントでお 支 払 いボタンを 指 定 color size Gold DarkGray LightGray デフォルト: Gold small (148px x 30px) medium (200px x 45px) large (296px x 60px) x-large (400px x 90px) デフォルト: medium ENTER_SCOPES ENTER_POPUP_PARAMETER およびYOUR_REDIRECT_URL_HEREのテキストも 更 新 してください ENTER_SCOPESパラメーターの 値 では セラーがアクセスできる 購 入 者 の 情 報 を 指 定 します 購 入 者 が 情 報 の 共 有 を 許 可 できるように scopeパラメーターの 値 に 基 づいて 適 切 な 同 意 画 面 が 購 入 者 に 表 示 されま す ENTER_POPUP_PARAMETERでは 購 入 者 に 認 証 用 のポップアップウィンドウを 表 示 するかどうか または 購 入 者 をAmazonの 認 証 ページにリダイレクトするかどうかを 指 定 します 安 全 でないページやスマートフォン 用 に 最 適 化 された 操 作 用 にボタンウィジェットをホストしている 場 合 は リダイレクトの 使 用 をお 勧 めしま す YOUR_REDIRECT_URLは ボタンを 押 して 認 証 が 成 功 した 後 に 購 入 者 がリダイレクトされるページを 指 すパラ メーターです たとえば 認 証 の 成 功 後 に セラーのチェックアウトパイプラインの 次 のページに 購 入 者 をリダイレクトし 配 送 先 住 所 または 支 払 い 方 法 の 詳 細 を 収 集 することができます scopeパラメーターとpopupパラメーターに 指 定 できる 値 のリストについては 次 の 表 を 参 照 してください Login and Pay with Amazonインテグレーションガイド 27

28 Amazon ログイン & ペイメント インテグレーションガイド 28 パラメーター 名 scope 値 profile postal_code payments:widget payments:shipping_address アクセスしたい 購 入 者 プロファイル 情 報 を 指 定 ( 例 : 名 前 Eメ ールアドレス 郵 便 番 号 )し すぐ 後 にサインインしてAmazonAd dressbookウィジェットで 選 択 した 完 全 な 配 送 先 住 所 の 値 paymenta:widget payments:shipping_address 購 入 者 プロファイル 情 報 にアクセスしたくない 場 合 に 指 定 する しかしなが ら AmazonAddressBookウィジェットで 選 択 した 完 全 な 配 送 先 住 所 にアクセ スしたい 場 合 の 値 paymenta:widget サインインしてすぐに 購 入 者 プロファイル 情 報 にアクセスしたくない 場 合 に 指 定 する Amazonから 購 入 が 承 認 された 後 に 完 全 な 配 送 先 住 所 が 参 照 でき る このscopeでは 購 入 者 に 同 意 画 面 を 表 示 しない payments:shipping_address は 購 入 者 の 杯 先 住 所 へのアクセスを 提 供 する 完 全 な 配 送 先 住 所 を 検 索 するために getorderreference Details APIの 呼 び 出 しが 必 要 です 詳 しい 情 報 はOff-Amazon Payme nts APIセクションリファンレンスを 参 照 ください popup true ポップアップダイアログにAmazon 認 証 画 面 を 提 供 しま す デスクトップ 用 ボタンウィジェットはセキュアページ 上 で 提 供 されることを 推 奨 されています この 追 加 の 要 求 は 有 効 な SSL 認 証 されたHTTPSページにボタンを 属 することを 認 識 してく ださい false - 購 入 者 の 同 じブラウザのウィンドウの 中 でAmazonページ がリダイレクトします モバイルデバイス また 非 セキュア ページ 上 でボタンウィジェットをレンダリングする 場 合 に 推 奨 されます リダイレクトURLはHTTPSプロトコルを 使 い 有 効 な SSL 認 証 も 持 つ 必 要 があることを 認 識 してください デフォルト: popup: true 前 述 の 例 のコードを 追 加 して ボタンをクリックすると Amazon ペイメントの 認 証 ウィンドウが 開 き 購 入 者 はAmazonアカウントのEメールアドレスとパスワードを 入 力 するように 求 められます popupパラメ ーターをfalseに 設 定 している 場 合 (popup: false)に ボタンをクリックすると 購 入 者 は 同 じブラウザ ーウィンドウ 内 でAmazon 認 証 ページにリダイレクトされます Amazonでは onerrorハンドラーをコードに 実 装 することも 推 奨 しています 前 述 の 例 では onerrorコードは 任 意 ですが インテグレーションの 問 題 が 発 生 した 場 合 に トラブルシューティングの 手 間 を 大 幅 に 軽 減 で きます 詳 しくは テスト 環 境 とのインテグレーションのテスト を 参 照 してください ボタンを 埋 め 込 み popupパラメーターをtrue (popup:true)に 設 定 してJavaScriptコードを 追 加 すると ポ ップアップウィンドウが 表 示 され 購 入 者 はセラーのWebサイトを 離 れることなく 認 証 できます Login and Pay with Amazonインテグレーションガイド 28

29 Amazon ログイン & ペイメント インテグレーションガイド 29 上 記 のスクリーンショットからもわかるように セラーの 会 社 のロゴを 認 証 ウィンドウに 追 加 することも できます この 操 作 は セラーセントラルの 設 定 タブの インテグレーション 設 定 ページから 実 行 できます ユーザーがログインしたら ログアウト オプション(ハイパーリングの 場 合 が 多 い)をセラーのWeb サイトに 追 加 してください ログアウトオプションでは キャッシュされたトークンを 削 除 し ユーザ ープロファイル 情 報 ( 名 前 など)をセラーのWebサイトから 削 除 します ログアウトすると セラーのWeb サイトにログインボタンを 再 度 表 示 できます JavaScript 用 のLogin with Amazon SDKを 使 用 している 場 合 は amazon.login.logoutメソッドを 呼 び 出 し キャッシュされたトークンを 削 除 できます 例 : <script type="text/javascript"> document.getelementbyid('logout').onclick = function() { amazon.login.logout(); }; </script> これ 以 降 のamazon.Login.authorizeの 呼 び 出 しでは ログイン 画 面 がデフォルトで 表 示 されます ステップ2 - プロファイル 情 報 の 取 得 ( 任 意 ) 最 終 的 に ボタンウィジェットによって 返 されるアクセストークンを 使 用 して Amazonからユーザーのプ ロファイル 情 報 を 取 得 できます ユーザーがサイトにログインすると オーソリサーバーによってアクセ ストークンが 付 与 されます アクセストークンは クライアント ユーザー およびアクセススコープに 固 有 です クライアントは アクセストークンを 使 用 して 購 入 者 のプロファイルデータを 取 得 する 必 要 が あります サーバー 側 のアプリケーションでは /handle_login.phpへのリクエストを 処 理 し アクセストー クンとプロファイルREST APIを 使 用 して プロファイル 情 報 を 取 得 します Login and Pay with Amazonインテグレーションガイド 29

30 Amazon ログイン & ペイメント インテグレーションガイド 30 例 PHPの 例 $c = curl_init(' urlencode($_request['access_token'])); curl_setopt($c, CURLOPT_RETURNTRANSFER, true); $r = curl_exec($c); curl_close($c); $d = json_decode($r); if ($d->aud!= 'YOUR-CLIENT-ID') { // the access token does not belong to us header('http/ Not Found'); echo 'Page not found'; exit; } // exchange the access token for user profile $c = curl_init(' curl_setopt($c, CURLOPT_HTTPHEADER, array('authorization: bearer '. $_REQUEST['access_token'])); curl_setopt($c, CURLOPT_RETURNTRANSFER, true); $r = curl_exec($c); curl_close($c); $d = json_decode($r); echo sprintf('%s %s %s', $d->name, $d-> , $d->user_id); Javaの 例 このサンプルコードを 使 用 するには JacksonとHttpComponentsのライブラリをダウンロードする 必 要 があり ます import com.fasterxml.jackson.core.type.typereference; import co m.fasterxml.jackson.databind.objectmapper; import org.apache.htt p.client.fluent.content; import org.apache.http.client.fluent.request; import java.net.urlencoder; import java.util.map;... // verify that the access token belongs to us Content c = Request.Get( " + URLEncoder.encode(access_token, "UTF-8")).execute().returnContent(); Map<String,String> m = new ObjectMapper().readValue( c.tostring(), new TypeReference<Map<String,String>>(){}); if (!"YOUR-CLIENT-ID".equals(m.get("aud"))) { // the access token does not belong to us throw new RuntimeException("Invalid token"); } // exchange the access token for user profile c = Request.Get(" "bearer " + access_token).execute().returncontent(); m = new ObjectMapper().readValue( c.tostring(), new TypeReference<Map<String,String>>(){}); System.out.println( String.format("%s %s %s", m.get("name"), m.get(" "), m.get("user_id"))); 詳 しくは The Login with Amazon Developer s Guide for Websitesを 参 照 してください Login and Pay with Amazonインテグレーションガイド 30

31 Amazon ログイン & ペイメント インテグレーションガイド 31 ステップ3 - AddressBookウィジェットとWalletウィジェットの 追 加 購 入 者 の 認 証 が 成 功 すると 選 択 した 場 所 にAmazon ログイン & ペイメントのAddressBookウィジェッ トとWalletウィジェットを 表 示 できます AddressBookウィジェットとWalletウィジェットには 購 入 者 がAmazonアカウントに 保 存 している 配 送 先 住 所 と 支 払 い 方 法 がそれぞれ 表 示 されます AddressBookウィジェットをセラーのWebサイトに 埋 め 込 むには 次 のサンプルコードをWebページに 追 加 しま す <!-- please put the style below inside your CSS file --> <style type="text/css"> #addressbookwidgetdiv{width: 400px; height: 228px;} </style> <div id="addressbookwidgetdiv"> </div> <script> new OffAmazonPayments.Widgets.AddressBook({ sellerid: 'YOUR_SELLER_ID_HERE', onorderreferencecreate: function(orderreference) { orderreference.getamazonorderreferenceid(); }, onaddressselect: function(orderreference) { // Replace the following code with the action that you want to perform // after the address is selected. // The amazonorderreferenceid can be used to retrieve // the address details by calling the GetOrderReferenceDetails // operation. If rendering the AddressBook and Wallet widgets on the // same page, you should wait for this event before you render the // Wallet widget for the first time. // The Wallet widget will re-render itself on all subsequent // onaddressselect events, without any action from you. It is not // recommended that you explicitly refresh it. }, design: { designmode: responsive }, onerror: function(error) { // your error handling code } }).bind("addressbookwidgetdiv"); </script> WalletウィジェットをセラーのWebサイトに 埋 め 込 むには 次 のサンプルコードをWebページに 追 加 します <! - please put the style below inside your CSS file --> <style type="text/css"> #walletwidgetdiv{width: 400px; height: 228px;} </style> Login and Pay with Amazonインテグレーションガイド 31

32 Amazon ログイン & ペイメント インテグレーションガイド 32 <div id="walletwidgetdiv"> </div> <script> new OffAmazonPayments.Widgets.Wallet({ sellerid: 'YOUR_SELLER_ID_HERE', design: { size : {width:'400px', height:'260px'} }, onpaymentselect: function(orderreference) { // Replace this code with the action that you want to perform // after the payment method is selected. }, onerror: function(error) { // your error handling code } }).bind("walletwidgetdiv"); </script> 許 可 されたパラメーターの 範 囲 内 である 限 りCSS 内 でウィジェットの 高 さと 幅 を 制 御 することができます 他 のCSSとして 許 可 された 最 小 値 から 最 大 値 の 範 囲 であれば パーセント REM EMのような 単 位 でも 利 用 するこ とができます レスポンシブサイトを 使 っている 場 合 は 次 のステップを 確 認 : 1. それぞれのスマートフォンに 最 適 化 されたページのheadセクションにメタタグを 追 加 します このメタタ グはユーザーが 手 動 でズームを 必 要 とせずにスマートフォン 上 で 読 み 取 り 可 能 な 大 きさでウィジェットを 表 示 します: <meta name="viewport" content="width-device-width, initial-scale=1.0, maximum-scale=1.0"/> 2. 以 下 の 例 ではモバイルファーストデザインをCSSで 構 築 するためのメディアクエリーを 使 うことできます: <style type="text/css"> /* Please include the min-width, max-width, min-height and max-height */ /* if you plan to use a relative CSS unit measurement to make sure the */ /* widget renders in the optimal size allowed. */ #addressbookwidgetdiv {min-width: 300px; max-width: 600px; min-height: 228px; max-height: 400px;} #walletwidgetdiv {min-width: 300px; max-width:600px; min-height: 228px; max-height: 400px;} /* Smartphone and small window */ #addressbookwidgetdiv {width: 100%; height: 228px;} #walletwidgetdiv {width: 100%; height: 228px;} /* Desktop and tablet only screen and (min-width: 768px) { #addressbookwidgetdiv {width: 400px; height: 228px;} #walletwidgetdiv {width: 400px; height: 228px;} Login and Pay with Amazonインテグレーションガイド 32

33 Amazon ログイン & ペイメント インテグレーションガイド 33 } Amazon ログイン & ペイメントのAddressBookウィジェットとWalletウィジェットを 作 成 する 場 合 は width パラメーターとheightパラメーターを 指 定 する 必 要 があります 指 定 しないと ウィジェットは 表 示 されませ ん 1 列 のウィジェットと2 列 のウィジェットで 推 奨 される 有 効 なwidthパラメーターとheightパラメーターを 次 の 表 に 示 します 2カラムウィジェット 1カラムウィジェット パラメーター 推 奨 の 大 きさ 有 効 な 大 きさ 推 奨 の 大 きさ 有 効 な 大 きさ width 400px 400px - 600px 260px 200px - 399px height 260px 228px - 400px 390px 228px - 400px 購 入 者 の 認 証 が 成 功 すると 次 のスクリーンショットのように 指 定 した 場 所 にAddressBookウィジェッ トが 表 示 されます 上 記 のスクリーンショットでは AddressBookウィジェットとWalletウィジェットがセラーのWebサイトに 直 接 表 示 されています 購 入 者 が 住 所 と 支 払 い 方 法 をそれぞれのウィジェットから 選 択 したことを 確 認 するまで チェックアウト ワークフローを 無 効 にすることをお 勧 めします 購 入 者 が 選 択 した 住 所 と 支 払 い 方 法 は それぞれonAddress Selectコールバック 関 数 とonPaymentSelectコールバック 関 数 を 使 用 して Amazonからセラーに 通 知 されます これらの 通 知 に 基 づいて セラーはチェックアウトフローの 次 のステップを 有 効 にできます たとえば 注 文 内 容 確 認 ページが 続 く 場 合 は セラーのWebページで 続 行 ボタンを 有 効 にできます Login and Pay with Amazonインテグレーションガイド 33

34 Amazon ログイン & ペイメント インテグレーションガイド 34 注 :Address Bookウィジェットがページに 表 示 されると Amazon ログイン & ペイメントによっ てDraft 状 態 のOrder Referenceオブジェクトが 作 成 されます(Order Referenceオブジェクトについて 詳 しくは ステップ5を 参 照 ) ステップ5を 完 了 していない 場 合 は DraftのOrder Referenceオブジェ クトがキャンセルされます 購 入 者 がセラーのサイトでボタンをクリックしてから3 時 間 以 内 に 購 入 の 詳 細 を 設 定 し 購 入 を 確 定 してください 注 : 購 入 者 は 注 文 内 容 を 確 定 する 前 に 住 所 と 支 払 い 方 法 の 両 方 を 選 択 しなくてはなりません 購 入 者 が 住 所 と 支 払 い 方 法 を 最 初 に 選 択 した 後 で 住 所 を 変 更 する 場 合 支 払 い 方 法 も 再 選 択 する 必 要 があります つまり 住 所 を 選 択 するごとに(onAddressSelect 通 知 ) onpaymentselect 通 知 を 確 認 す る 必 要 があります AddressBookウィジェットから 住 所 情 報 を 収 集 する 必 要 がない 場 合 は Addre ssbookウィジェットなしのインテグレーション を 参 照 してください Amazonからの 配 送 先 住 所 の 取 得 多 くの 場 合 購 入 者 の 配 送 先 住 所 を 取 得 して 送 料 と 税 金 を 計 算 する 必 要 があります onaddressselect 通 知 の 受 信 後 に セラーはGetOrderReferenceDetailsオペレーションを 呼 び 出 すことで 配 送 と 税 金 に 関 する 複 数 のビジネスルールに 対 応 できます サポートされていない 住 所 を 購 入 者 がウィジェットから 選 択 した 場 合 は ただちに 購 入 者 にフィードバックすることもできます この 場 合 別 の 配 送 先 住 所 をウィジェットから 選 択 する 必 要 がある 旨 のメッセージを 購 入 者 に 表 示 してください 完 全 な 配 送 先 住 所 を 取 得 するには AmazonアカウントでログインボタンまたはAmazonアカウントでお 支 払 いボタン( 完 全 な 配 送 先 住 所 にアクセス)のJavaScriptを 使 用 します( ステップ1 - 購 入 者 の 認 証 用 ボタ ンウィジェットの 追 加 を 参 照 ) Amazonアカウントでお 支 払 いボタン(ゲスト 用 チェックアウト)を 使 用 している 場 合 は 配 送 先 住 所 の 一 部 ( 都 道 府 県 市 区 町 村 郵 便 番 号 国 )がセラーに 送 信 されます 購 入 者 が 選 択 した 住 所 を 取 得 するには onaddressselect 通 知 後 にGetOrderReferenceDetailsオペレーションを 呼 び 出 します 注 :セラーのAPI 呼 び 出 しは 正 常 に 動 作 するようにすべて 署 名 する 必 要 があります APIリクエスト を 署 名 するには Amazon MWSキーが 必 要 です このキーを 取 得 するには セラーセントラルにログイ ンし インテグレーション タブの MWS Access Key セクションを 表 示 します このAmazon MWS キーは Off-Amazon Payments APIセクションのオペレーションのAWSAccessKeyIdリクエストパラメ ーターに 設 定 する 必 要 があります 署 名 済 みAPI 呼 び 出 しのサービスの 構 成 方 法 について 詳 しくは A mazon MWS 開 発 者 ガイドを 参 照 してください 次 の 例 は GetOrderReferenceDetailsオペレーションの 呼 び 出 し 方 法 を 示 しています &Action=GetOrderReferenceDetails &AddressConsentToken=IQEBLzAtAhUAjagYW4Jrgw84pCaaIDjrKoEhZXsEXAMPLE &AmazonOrderReferenceId=S &SellerId=YOUR_SELLER_ID_HERE &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp= T19%3A01%3A11Z &Version= &Signature=CLZOdtJGjAo81IxaLoE7af6HqK0EXAMPLE 注 : 注 文 内 容 にscope payment:shipping_addressを 使 い 注 文 確 認 する 前 に 完 全 な 配 送 先 住 所 を 得 たい 場 合 は 以 下 のパラメーターをリクエストに 挿 入 する 必 要 があります &AddressConsentToken=YOUR_ACCESS_TOKEN リクエストパラメーターと 応 答 要 素 を 含 む GetOrderReferenceDetailsオペレーションについて 詳 し は Off-Amazon Payments APIセクションリファレンスの GetOrderReferenceDetails を 参 照 して ください ステップ4 リダイレクト 認 証 エクスペリエンスの 使 用 ( 任 意 ) 購 入 者 が Amazon ログイン & ペイメント ボタンを 押 した 後 に 認 証 用 のポップアップウィンドウを 購 入 者 に 表 示 したくないシナリオもあります 購 入 者 を 同 じウィンドウ 内 のAmazon 認 証 ページにリダイ レクトしたい 場 合 (ほとんどはモバイルWebアプリケーションを 使 用 ) または Amazonアカウントでログ イン ボタンをhttpページに 配 置 したい 場 合 は Java Scriptを 使 用 してリダイレクト 認 証 を 開 始 する 必 Login and Pay with Amazonインテグレーションガイド 34

35 Amazon ログイン & ペイメント インテグレーションガイド 35 要 があります 作 業 の 開 始 セクションで 説 明 したステップに 加 えて ここでは リダイレクト 認 証 を 有 効 にするため に セラーがサイトに 実 装 する 必 要 がある 追 加 の 変 更 について 説 明 します AddressウィジェットとWalletウィジェットを 表 示 するページで Java Scriptコードを<header>セクシ ョンに 追 加 し ウィジェットで 使 用 するAccess_Tokenを 取 得 してください 例 注 :この 例 はテスト 環 境 を 使 用 しています 本 稼 働 環 境 で 使 用 する 場 合 は 適 切 に 変 更 してくださ い <script type='text/javascript'> function geturlparameter(name, source) { return decodeuricomponent((new RegExp('[? & #]' + name + '=' + '([^&;]+?)(& # ; $)').exec(source) [,""])[1].replace(/\+/g,'%20')) null; } var accesstoken = geturlparameter("access_token", location.hash); if (typeof accesstoken === 'string' && accesstoken.match(/^atza/)) { document.cookie = "amazon_login_accesstoken=" + accesstoken + ";secure";} window.onamazonloginready = function() { amazon.login.setclientid('your_client_id'); amazon.login.setusecookie(true); }; </script> <script src=' /prod/lpa/js/widgets.js' </script> ユーザーがログインしたら ログアウト オプション(ハイパーリンクの 場 合 が 多 い)をセラーのWeb サイトに 追 加 してください ログアウトオプションでは キャッシュされたトークンを 削 除 し ユーザ ープロファイル 情 報 ( 名 前 など)をセラーのWebサイトから 削 除 します ログアウトすると セラーのWeb サイトに ログイン ボタンを 再 度 表 示 できます JavaScript 用 のLogin with Amazon SDKを 使 用 している 場 合 は amazon.login.logoutメソッドを 呼 び 出 し キ ャッシュされたトークンを 削 除 できます リダイレクト 認 証 を 使 用 している 場 合 は Addressウィジェット とWalletウィジェットで 使 用 されているCookieも 削 除 してください 例 : <script type="text/javascript"> document.getelementbyid('logout').onclick = function() { amazon.login.logout(); document.cookie = "amazon_login_accesstoken=; expires=thu, 01 Jan :00:00 GMT"; window.location = 'REDIRECT_URL'; }; </script> これ 以 降 のamazon.Login.authorizeの 呼 び 出 しでは ログイン 画 面 がデフォルトで 表 示 されます ステップ5 - 選 択 した 配 送 先 住 所 と 支 払 い 方 法 の 表 示 ( 任 意 ) 購 入 者 が 配 送 先 住 所 と 支 払 い 方 法 の 両 方 をAmazon ペイメントウィジェットから 選 択 した 後 のオプショ ンのステップは 読 み 取 り 専 用 バージョンのAddressBookウィジェットとWalletウィィジェットを 表 示 し 購 入 者 が 購 入 を 確 定 する 前 に 選 択 内 容 を 最 後 に 確 認 できるようにすることです 注 文 内 容 確 認 ペ ージを 設 定 し 読 み 取 り 専 用 ウィジェットを 表 示 する 場 合 は 確 認 ページを 表 示 する 前 に 購 入 者 が 住 所 と 支 払 い 方 法 を 選 択 したことを 確 認 することをお 勧 めします この 操 作 を 実 行 するには GetOrderRef erencedetailsオペレーションを 呼 び 出 し 応 答 に 制 約 要 素 が 含 まれているかどうかを 確 認 します この 各 制 約 には 適 切 な 是 正 措 置 に 必 要 な 情 報 が 表 示 されます たとえば ShippingAddressNotSet 制 約 ま たはPaymentPlanNotSet 制 約 を 受 信 した 場 合 は 配 送 先 住 所 または 支 払 い 方 法 を 選 択 する 必 要 がある 旨 を 購 入 者 に 通 知 してください また 購 入 者 を 適 切 な 選 択 ページに 自 動 的 にリダイレクトできるよう に セラーのサイトをインテグレーションすることもできます 購 入 者 が 配 送 先 住 所 または 支 払 い 方 法 を 選 択 していない 場 合 は 読 み 取 り 専 用 ウィジェットでも 購 入 者 による 選 択 が 必 要 である 旨 を 通 知 しま す 注 文 内 容 で 制 約 が 返 されない 場 合 は ConfirmOrderReference 呼 び 出 しが 成 功 しています 制 約 につい て 詳 しくは Off-Amazon Payments APIセクションリファレンスの GetOrderReferenceDetails と Login and Pay with Amazonインテグレーションガイド 35

36 Amazon ログイン & ペイメント インテグレーションガイド 36 注 文 内 容 の 制 約 を 参 照 してください 購 入 者 が 注 文 を 確 定 したら 注 文 を 出 荷 し 支 払 いを 回 収 で きます Amazon ログイン & ペイメントの 読 み 取 り 専 用 AddressBookウィジェットとWalletウィジェットを 作 成 する 場 合 は widthパラメーターとheightパラメーターを 指 定 する 必 要 があります 指 定 しないと ウ ィジェットは 表 示 されません 推 奨 される 有 効 なwidthパラメーターとheightパラメーターを 次 の 表 に 示 します パラメーター 推 奨 の 大 きさ 有 効 な 大 きさ Width 400px 290px 600px Height 185px 185px 読 み 取 り 専 用 バージョンのウィジェットを 表 示 する 場 合 は セラーのサイトにウィジェットを 最 初 に 表 示 し たコードと 同 じコードを 使 用 できますが この 場 合 は パラメーターdisplayMode:"Read"をコード 内 に 追 加 し ます 編 集 可 能 なAddressBookウィジェットまたはWalletウィジェットと 同 じページに 読 み 取 り 専 用 ウィジェ ットを 表 示 する 必 要 がある 場 合 は onaddressselect 通 知 またはonPaymentSelect 通 知 を 受 け 取 り その 時 点 で 読 み 取 り 専 用 ウィジェットを 再 表 示 します そうしないと 読 み 取 り 専 用 ウィジェットに 正 しい 情 報 が 表 示 さ れません 以 下 は パラメーターを 追 加 したコードの 例 です <!-- please put the style below inside CSS file --> <style type="text/css"> #readonlyaddressbookwidgetdiv {width: 400px; height: 185px;} #readonlywalletwidgetdiv {width: 400px; height: 185px;} </style> <div id="readonlyaddressbookwidgetdiv"> </div> <div id="readonlywalletwidgetdiv"> </div> <script> new OffAmazonPayments.Widgets.AddressBook({ sellerid: 'YOUR_SELLER_ID_HERE', amazonorderreferenceid: amazonorderreferenceid, // amazonorderreferenceid obtained from Address widget displaymode: "Read", design: { designmode: 'responsive' }, onerror: function(error) { // your error handling code } }).bind("readonlyaddressbookwidgetdiv"); </script> <script> new OffAmazonPayments.Widgets.Wallet({ sellerid: 'YOUR_SELLER_ID_HERE', amazonorderreferenceid: amazonorderreferenceid, // amazonorderreferenceid obtained from Address widget displaymode: "Read", design: { designmode: 'responsive' }, onerror: function(error) { // your error handling code Login and Pay with Amazonインテグレーションガイド 36

37 Amazon ログイン & ペイメント インテグレーションガイド 37 } }).bind("readonlywalletwidgetdiv"); </script> パラメーターを 追 加 すると 次 のスクリーンショットのように 読 み 取 り 専 用 バージョンのウィジ ェットがWebサイトに 表 示 されます ステップ6 - 購 入 の 詳 細 の 設 定 と 購 入 の 確 定 Order Referenceオブジェクト ステップ1に 示 すように 購 入 者 がAmazonで 認 証 すると Order Referenceオブジェクトと 呼 ばれるシステ ムオブジェクトがAmazon ログイン & ペイメントでただちに 作 成 されます このオブジェクトには Amaz on ログイン & ペイメントを 使 用 した 購 入 者 の 支 払 いに 関 連 するすべての 属 性 が 保 存 されます Amazon ログイン & ペイメントチェックアウトプロセスのこの 時 点 で Order Referenceオブジェクトに 購 入 者 の 配 送 先 住 所 と 支 払 い 方 法 の 選 択 内 容 が 入 力 されます 次 に 追 加 の 属 性 をOrder Referenceオブジェクト に 設 定 する 必 要 があります これにより Amazon ログイン & ペイメントの 支 払 いと 追 跡 するその 他 の 詳 細 を 関 連 付 けることができます 購 入 金 額 の 設 定 も 必 要 です トランザクションに 指 定 した 注 文 番 号 など 追 加 の 詳 細 を 設 定 することもできます Login and Pay with Amazonインテグレーションガイド 37

38 Amazon ログイン & ペイメント インテグレーションガイド 38 SetOrderReferenceDetailsオペレーションを 呼 び 出 して これらの 属 性 を 設 定 したら ConfirmOrderReference オペレーションを 呼 び 出 し 購 入 を 確 定 してAmazonに 通 知 する 必 要 があります 購 入 を 確 定 すると 支 払 いがオーソリ 処 理 された 旨 がAmazonから 購 入 者 に 通 知 されます 注 文 の 支 払 いを 処 理 するには 注 文 内 容 を 確 定 する 必 要 があります 注 文 内 容 の 詳 細 の 設 定 Order Referenceオブジェクトの 詳 細 を 設 定 するには SetOrderReferenceDetailsオペレーションを 呼 び 出 しま す この 呼 び 出 し 中 に 購 入 の 合 計 金 額 を 指 定 します これにより 購 入 に 関 する 追 加 の 情 報 をOrder Ref erenceオブジェクトに 含 めることができます この 追 加 情 報 は Amazonから 購 入 者 への 連 絡 と セラーに 返 される 支 払 い 処 理 情 報 の 両 方 に 使 用 されます 次 の 例 は SetOrderReferenceDetailsオペレーションの 呼 び 出 し 方 法 を 示 しています &Action=SetOrderReferenceDetails &AmazonOrderReferenceId=S &OrderReferenceAttributes.OrderTotal.Amount=106 &OrderReferenceAttributes.OrderTotal.CurrencyCode=USD &OrderReferenceAttributes.SellerNote=Lorem%20ipsum%20dolor &OrderReferenceAttributes.SellerOrderAttributes.SellerOrderId= &OrderReferenceAttributes.SellerOrderAttributes.StoreName=CourtAndCherry.com &SellerId=YOUR_SELLER_ID_HERE &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp= T19%3A01%3A11Z &Version= &Signature=2RPzkOgQmDybUjk0dA54maCEXAMPLE Order Referenceの 詳 細 のパラメーターの 設 定 は 支 払 いがオーソリ 処 理 された ことを 伝 えるEメール に 表 示 される 内 容 に 反 映 されます 詳 しくは Eメールに 表 示 されるデータの 処 理 の 支 払 いがオー ソリ 処 理 されたことを 伝 えるEメール セクションを 参 照 してください リクエストパラメーターと 応 答 要 素 を 含 む SetOrderReferenceDetailsオペレーションについて 詳 し は Off-Amazon Payments APIセクションリファレンスの SetOrderReferenceDetails を 参 照 して ください 注 :Amazon ログイン & ペイメントインテグレーションプロセスのこのステップでは 購 入 金 額 を 設 定 する 必 要 があります 選 択 した 住 所 に 基 づいて 購 入 金 額 を 変 更 する 場 合 は onaddresssele ctイベントごとにgetorderreferencedetailsオペレーションを 呼 び 出 し 購 入 金 額 をリセットしま す 購 入 の 詳 細 の 確 認 Order Referenceオブジェクトの 属 性 (SetOrderReferenceDetailsオペレーション 呼 び 出 しで 追 加 する 属 性 を 含 む)を 設 定 したら Order Referenceオブジェクトを 確 認 する 必 要 があります このステップにより 購 入 者 がセラーのサイトで 注 文 したことがAmazonに 通 知 されますが Order Referenceオブジェクトの 確 認 は 資 金 を 保 証 するものでも 資 金 を 保 留 にするものでもありません この 場 合 は 支 払 いのオー ソリ 処 理 と 資 金 のキャプチャーがまだ 残 っています 注 : 購 入 者 が 住 所 または 支 払 い 方 法 を 選 択 できていない 場 合 またはセラーが 金 額 を 設 定 していな い 場 合 は 注 文 内 容 を 確 定 することはできません 注 文 内 容 を 確 定 できない 場 合 は 注 文 内 容 に 制 約 が 発 生 します 注 文 内 容 確 認 ページを 使 用 している 場 合 は 注 文 内 容 確 認 ページを 表 示 して 制 約 を 確 認 する 前 に GetOrderReferenceDetailsオペレーションを 呼 び 出 します 住 所 または 支 払 い 関 連 の 制 約 がある 場 合 は 購 入 者 が 住 所 または 支 払 い 方 法 (あるいは 両 方 )を 選 択 するまで セラーのWebサ イトの 確 定 ボタンは 無 効 にしてください 制 約 のある 注 文 内 容 を 確 定 しようとすると エラー 応 答 が 表 示 され 具 体 的 な 制 約 違 反 が 表 示 されます 制 約 なしでConfirmOrderReferenceオペレーションが 成 功 しないかぎり 注 文 確 認 ページを 購 入 者 に 表 示 しないでください 制 約 について 詳 しくは Off -Amazon Payments APIセクションリファレンスの GetOrderReferenceDetails および 注 文 確 認 Login and Pay with Amazonインテグレーションガイド 38

39 Amazon ログイン & ペイメント インテグレーションガイド 39 の 制 約 のセクションを 参 照 してください Order Referenceオブジェクトを 確 認 するには ConfirmOrderReferenceオペレーションを 呼 び 出 します 次 の 例 は ConfirmOrderReferenceオペレーションの 呼 び 出 し 方 法 を 示 しています &Action=ConfirmOrderReference &AmazonOrderReferenceId=S &SellerId=YOUR_SELLER_ID_HERE &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp= T19%3A01%3A11Z &Version= &Signature=CLZOdtJGjAo81IxaLoE7af6HqK0EXAMPLE リクエストパラメーターと 応 答 要 素 を 含 む ConfirmOrderReferenceオペレーションについて 詳 しくは Off -Amazon Payments APIセクションリファレンスの ConfirmOrderReference を 参 照 してください ConfirmOrderReferenceオペレーションを 正 常 に 呼 び 出 すと Order ReferenceオブジェクトがDraft 状 態 から Open 状 態 になります 状 態 遷 移 について 詳 しくは システムとAmazon Paymentsの 同 期 を 参 照 してく ださい Amazonアカウントでお 支 払 い ボタン(ゲスト 用 チェックアウト)オプションを 使 用 している 場 合 は Co nfirmorderreferenceオペレーションを 呼 び 出 してOrder Referenceオブジェクトを 確 認 するまで 配 送 先 住 所 の 一 部 のみが 表 示 されます この 住 所 の 一 部 を 使 って 税 金 と 配 送 費 を 計 算 します 注 文 の 処 理 と 顧 客 サービスの 提 供 には 購 入 者 に 関 する 詳 細 と 完 全 な 配 送 先 住 所 が 必 要 であるとAmazonでは 認 識 していま す ConfirmOrderRefenceオペレーションを 呼 び 出 して Order Referenceオブジェクトを 確 認 したら GetOrd erreferencedetailsオペレーションを 呼 び 出 して 完 全 な 配 送 先 住 所 を 取 得 し その 住 所 まで 配 送 できるこ とを 確 認 してください Amazonアカウントでお 支 払 い ボタン(ゲスト 用 チェックアウト)オプションを 使 用 している 場 合 は Order Referenceオブジェクトの 確 認 後 に 次 の 顧 客 情 報 を 利 用 できます 購 入 者 詳 細 Buyer name Buyer address Buyer phone number (if available) Recipient name Shipping address 入 手 される 内 容 ConfirmOrderReferenceオペレーションを 呼 び 出 し 成 功 した 後 にGetO rderreferencedetailsオペレーションを 呼 び 出 します ConfirmOrderReferenceオペレーションを 呼 び 出 し 成 功 した 後 にGetO rderreferencedetailsオペレーションを 呼 び 出 します ConfirmOrderReferenceオペレーションを 呼 び 出 し 成 功 した 後 にGetO rderreferencedetailsオペレーションを 呼 び 出 します ConfirmOrderReferenceオペレーションを 呼 び 出 し 成 功 した 後 にGetO rderreferencedetailsオペレーションを 呼 び 出 します 部 分 的 な 住 所 情 報 ( 市 区 町 村 郵 便 番 号 国 コード)は AddressBook ウィジェットで 住 所 を 選 択 した 後 すぐにGetOrderReferenceDetailsオ ペレーションを 呼 び 出 すことで 入 手 することができます 完 全 な 住 所 情 報 ( 地 番 を 含 む 情 報 )は ConfirmOrderReferenceの 呼 び 出 しが 成 功 した 後 に GetOrderReferenceDetailsを 呼 び 出 して 入 手 されます Recipient phone number (if available) ConfirmOrderReferenceオペレーションを 呼 び 出 し 成 功 した 後 にGetO rderreferencedetailsオペレーションを 呼 び 出 します オーソリ 処 理 と 支 払 い 方 法 のキャプチャーの 次 のステップが 処 理 されるまでは 時 間 がかかるため こ の 時 点 では 既 存 の 購 入 者 向 けの 注 文 確 認 ビジネスプロセス( 確 認 のEメール 確 認 のランディングペー ジなど)へ 進 むことを 強 くお 勧 めします Order ReferenceオブジェクトがOpen 状 態 の 場 合 は 購 入 者 の 支 払 いプロセスを 開 始 できます Login and Pay with Amazonインテグレーションガイド 39

40 Amazon ログイン & ペイメント インテグレーションガイド 40 購 入 者 への 注 文 確 認 のEメール Order ReferenceオブジェクトがOpen 状 態 になると Amazonから 購 入 者 にただちにEメールが 送 信 され 購 入 者 がOrder Referenceオブジェクトの 合 計 金 額 の 支 払 いに 同 意 したことが 通 知 されます 注 :Order Referenceオブジェクトは 本 番 モードとテストモードの 両 方 で180 日 間 Open 状 態 のままに なります(ConfirmOrderReferenceオペレーションを 正 常 に 呼 び 出 した 場 合 ) 180 日 を 超 えると Order R eferenceオブジェクトはclosed 状 態 になります オーソリ 処 理 をリクエストできるのは OrderRefer enceオブジェクトがopen 状 態 の 間 のみです 購 入 者 に 送 信 されるサンプルのEメールは 支 払 いがオーソリ 処 理 された ことを 伝 えるEメールで 確 認 で きます 注 : 支 払 いがオーソリ 処 理 された ことを 伝 えるEメールは 注 文 内 容 を 確 定 してAmazonに 通 知 すると 購 入 者 に 送 信 されます このEメールで Amazon Paymentsを 使 用 して 購 入 の 支 払 いがオー ソリ 処 理 されたことを 購 入 者 に 通 知 します このEメールは 注 文 時 点 または 注 文 後 にセラーが 送 信 するAuthorizeリクエストとは 関 係 ありません ステップ7 - オーソリのリクエスト 購 入 を 確 定 し Open 状 態 のOrder Referenceオブジェクトを 正 常 に 作 成 すると 支 払 い 回 収 のプロセスを 開 始 できます 最 初 にAuthorizeオペレーションを 呼 び 出 してAuthorizationオブジェクトを 作 成 し 購 入 者 が チェックアウトプロセス 中 に 選 択 した 支 払 い 方 法 でオーソリを 取 得 する 必 要 があります Authorizationオブジェクト Amazon ログイン & ペイメントでは AuthorizationオブジェクトはOrder Referenceオブジェクトに 関 連 付 けられている 支 払 い 方 法 で 決 済 が 可 能 かどうかを 表 します Authorizationオブジェクトは 常 に 次 の4 つの 状 態 のいずれかになります Pending Authorizationオブジェクトは 同 期 と 非 同 期 の2つのモードで 動 作 します Pendingステータス は 非 同 期 モードを 選 択 した 場 合 にのみ 適 用 されます 詳 しくは オーソリの 同 期 モードと 非 同 期 モ ード を 参 照 してください 非 同 期 モードでは オーソリはリアルタイムで 処 理 されません オーソリリクエストを 初 めて 送 信 したときには Authorizationオブジェクトは 常 にPendingの 状 態 で す セラーには Authorizeオペレーションからのオペレーションステータスの 応 答 を 示 す 応 答 がただち に 送 信 され このステータスが 通 知 されます Authorizationオブジェクトは Amazonによって 処 理 され るまで Pending 状 態 のままです 処 理 時 間 はさまざまで 数 分 で 終 わることもあります 処 理 が 完 了 す ると Amazonから 最 終 的 な 処 理 ステータスが 通 知 されます 最 終 的 なオーソリステータスの 受 信 方 法 に ついて 詳 しくは ステップ7 - オーソリステータスの 取 得 を 参 照 してください Open Authorizationオブジェクトは 支 払 い 方 法 が 正 常 にオーソリ 処 理 されるとすぐにOpen 状 態 にな ります このオーソリに 対 しキャプチャーをリクエストできる 期 間 は 最 大 30 日 です Declined Authorizationオブジェクトは Amazonがオーソリリクエストを 却 下 するとDeclined 状 態 に なります 詳 しくは 支 払 い 拒 否 への 対 応 を 参 照 してください Closed Authorizationオブジェクトは 次 のようなさまざまな 理 由 で Closed 状 態 になる 場 合 がありま す オブジェクトが 本 番 モードで30 日 間 テストモードで2 日 間 Open 状 態 だった 場 合 Openのオーソリに 対 して 全 額 または 一 部 の 金 額 のキャプチャーを 完 了 した 場 合 Amazonでは 1つのオーソリに 対 して1つのキャプチャーしか 許 可 しません オーソリは キャプチャーリクエストが 正 常 に 処 理 されるとただちに 終 了 します オーソリをClosedとマークした 場 合 Order ReferenceオブジェクトをCanceledとマークした 場 合 AmazonがオーソリをClosedした 場 合 Authorizationオブジェクトの 状 態 およびこれらの 状 態 間 の 遷 移 について 詳 しくは システムとAmazon P aymentsの 同 期 を 参 照 してください 次 の 例 は Authorizeオペレーションの 呼 び 出 し 方 法 を 示 しています Login and Pay with Amazonインテグレーションガイド 40

41 Amazon ログイン & ペイメント インテグレーションガイド 41 &Action=Authorize &AmazonOrderReferenceId=S &AuthorizationAmount.Amount=106 &AuthorizationAmount.CurrencyCode=USD &AuthorizationReferenceId=test_authorize_1 &SellerAuthorizationNote=Lorem%20ipsum%20dolor &SellerId=YOUR_SELLER_ID_HERE &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp= T19%3A01%3A11Z &TransactionTimeout=60 &Version= &Signature=WlQ708aqyHXMkoUBk69Hjxj8qdh3aDcqpY71hVgEXAMPLE リクエストパラメーターと 応 答 要 素 を 含 む Authorizeオペレーションについて 詳 しくは Off-Amazon Paymen ts APIセクションリファレンスの Authorize を 参 照 してください ステップ8 - オーソリステータスの 取 得 Authorize 呼 び 出 しへの 応 答 には AuthorizationStatus 応 答 要 素 が 含 まれます この 要 素 は 常 にPendingに 設 定 されます( 非 同 期 モードのオペレーションを 選 択 した 場 合 ) オーソリリクエストの 最 終 的 なステータス (OpenやDeclinedなど)は インスタントペイメント 通 知 サービス 経 由 で 後 でAmazonからセラーに 通 知 され ます インスタントペイメント 通 知 サービスについて 詳 しくは システムとAmazon Paymentsの 同 期 を 参 照 してください 次 に オーソリ 処 理 の 応 答 で 返 されたAmazonAuthorizationIdを 使 用 して GetAuthorizationDetailsオペレー ションを 呼 び 出 すことで Authorizationオブジェクトの 詳 細 のクエリーをオプションで 実 行 できます 正 常 なオーソリ 処 理 に 対 する 資 金 のキャプチャーには この 一 意 の 識 別 子 も 必 要 になります 詳 しくは Off- Amazon Payments APIセクションリファレンスの GetAuthorizationDetails を 参 照 してください 注 : 本 番 モードでは Authorizeオペレーションを 正 常 に 送 信 した 後 に オーソリ 処 理 に 対 して 資 金 を キャプチャーできる 期 間 は30 日 です この 期 間 を 過 ぎると 自 動 的 に 終 了 します テストモードでは 資 金 をキャプチャーできるのは2 日 間 のみです 注 :AuthorizeリクエストのTransactionTimeoutパラメーターを 使 用 すると オーソリの 処 理 までの 最 大 待 機 時 間 を 指 定 できます この 時 点 で 未 処 理 のオーソリ(Pending 状 態 のまま)は Amazonによっ て 却 下 されます 却 下 のメッセージは TransactionTimedOutの 理 由 コードで インスタントペイメ ント 通 知 サービス 経 由 で 通 知 されます TransactionTimeoutを0に 設 定 すると オーソリにOpenまたはDeclinedステータスがオペレーション から 常 に 返 されます この 場 合 同 期 処 理 できないオーソリは TransactionTimedOutの 理 由 コード で 却 下 されます 詳 しくは オーソリの 同 期 モードと 非 同 期 モード を 参 照 してください ステップ9 - キャプチャーのリクエスト Authorizeオペレーションを 正 常 に 呼 び 出 し AuthorizationオブジェクトがOpen 状 態 の 場 合 は このオーソ リに 対 する 資 金 をキャプチャーできます Captureオブジェクト Amazon ログイン & ペイメントでは Captureオブジェクトは 購 入 者 のアカウントからセラーのアカウ ントへの 資 金 の 移 動 を 表 します すべてのCaptureオブジェクトは 作 成 済 みでまだ 有 効 なAuthorizatio nオブジェクトに 関 連 付 けられます Captureオブジェクトは 常 に 次 の4つの 状 態 のいずれかになりま す Login and Pay with Amazonインテグレーションガイド 41