WCEX Amazon Pay 決済モジュール

Welcart専用 Amazon Payプラグイン運用マニュアル
Ver. 2.5.0

2022.07.22

アイベック合同会社※Welcartは、コルネ株式会社の商標です。
※Amazon、Amazon.co.jp、Amazon Payおよびそれらの名称及びロゴは、Amazon.com,inc.またはその関連会社の商標
です。

目次

更新履歴

・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・ 3

はじめに・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・ 7

申込方法 ・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・

AmazonPay 決済設定方法

8・・・・・・・・・・・・・・・・・・・・・・・・・・・・・ 9

・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・ 38

接続テスト

・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・ 40

運用方法

チャージバックについて ・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・ 54
予期せぬエラー ・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・ 55
エラー一覧

・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・ 56

Welcart拡張プラグイン対応状況

Copyright© AIVEC LLC.

・・・・・・・・・・・・・・・・・・・・・・・・・・ 61

Amazon Pay プラグイン

2

更新履歴

対応
バージョン

更新日

更新内容

v1.7.8

2019/03/10

・WelcartカートページからAmazon Payへのフローを変更
・カートページの「Amazon Payボタン」の配置（並び替え）設定を追加

2019/04/26

・AIVEC APPS認証確認の「キーの入力」を省略するよう変更

2019/06/05

・プラグイン名を「WCEX Amazon Pay」に変更

2019/06/13

・決済エラーをログに出力するよう修正

2019/07/10

・「WCEX DLseller」利用時のログアウトで警告が表示されるエラーを修正

2019/12/03

・クイック決済ページの「カスタム・オーダーフィールド」と「カスタム・デリバリーフィールド」で「表示する・しない」の設定を決済設定ページに追加
・クイック決済ページのカスタムフィールドで、フィールドキー名にハイフン等が入っている場合正常に表示されない不具合を修正

2020/02/10

・送料設定が2つ以上ある場合、クイック決済時に送料が正しく適用されない不具合を修正・認証確認で、WCEC Amazon Pay を購入したサイトを選択するように変更（Aivec Apps もしくは、wecart.com のどちらかを選択すること）
・クイック決済利用時にクーポンの金額が正しく適用されない不具合を修正（対象：WCEX Coupon 1.0.11）※WCEX Coupon1.0.10以下をご利用の場合は、必ず最新版へアップデートが必要です。

v1.8.02020/02/20

・送料設定が2つ以上ある場合、クイック決済時に送料が正しく適用されない不具合を修正2020/03/26≪機能追加≫
・決済設定ページに処理区分（与信、与信売上計上）の設定を追加
・カートページに「買い物を続ける」ボタンの表示を追加
・クイック決済ページにカスタムフィールドの表示・非表示の設定を追加
・Amazon Payの通常購入フローで、通常課金のコンテンツファイルとサービス商品を購入できる機能を追加（DLSeller商品一部対応）
・新しいフックを追加≪バグ修正≫
・カスタムフィールドでハイフン（-）が入っている場合、表示されない不具合を修正（クイック決済、Amazonアカウントでログインするダイアログ対象）
・Amazon Payのクイック決済ページで配送方法を変更した場合に、送料が再計算されない不具合を修正
・基本設定でAmazon Payを支払方法として登録していなくても、クイック決済が表示される不具合を修正
・DLSeller商品を購入する際、お客様情報画面に「Amazonアカウントをお持ちのお客さま」としてAmazonアカウントの住所を選択する画面が表示されないように修正

v1.8.12021/09/07

Copyright© AIVEC LLC.

・在庫が0の場合、クイック決済で購入が可能となる不具合を修正

Amazon Pay プラグイン

3

更新履歴

対応
バージョン

改訂日

修正内容

v2.0.02020/09/09

・WCEX Amazon Payの更新方法が、WordPressのプラグイン更新方法と同じ方法でアップデートできるよう変更≪機能追加≫=クレジット決済設定画面=
・Amazon Pay APIにアクセスするための公開/秘密キーペアの設定を追加
・購入時に利用する配送先の設定を追加
・Ｗelcart非会員様のお客様情報登録先を指定する設定を追加
・ギフト配送の有無を判断するチェック項目を追加し、ギフト配送などの購入者と発送先が異なる注文の場合には、購入者情報を入力できるよう項目を追加≪仕様変更≫
・決済エラーログ機能を削除し、「usc-e-shop/logs/acting_transaction.log」に記載するように変更・会員情報とAmazonアカウントを連携させることで、Amazonアカウントのみでログインできるように変更（会員情報のメールアドレスとAmazonアカウントのメールアドレスが同一であることが条件）
・Amazon Payの売上計上・キャンセルの処理がWelcartの「対応状況」とは別となり、「対応状況」を変更してもAmazon Payの処理が実行されないように変更
・「Amazonアカウントで登録する」ダイアログにて会員登録を行っていたフローを、ク
イック決済画面にて「Amazonアカウントで会員登録を行う」にチェックを入れるだけで、
Amazonアカウントの情報を会員登録に反映できるように変更≪機能修正≫
・非会員様がクイック決済で購入した場合、登録される氏名が二重になる不具合を修正
・クイック決済ページにテキストエリアのカスタムフィールドが正しく表示されず注文が確定できない不具合を修正
・通常フローに不定期で発生する以下エラーを修正-「支払い方法を選択してください。」-「購入者はAmazonのアドレス帳ウィジェットからの配送先住所が選択されていません」≪既存機能削除≫
・ 受注リストの「一括売上計上」、「キャンセル」を削除
・会員登録時に、会員情報入力ページに「Amazonログインボタン」を表示する機能を削除
・通常の購入フローの際に、お客様情報入力ページに「Amazonログインボタン」を表示する機能を削除・Amazonに登録されている氏名ではなく、入力した氏名を登録する機能を削除（設定項目名：お名前入力フィールド）v2.1.02020/10/16≪機能追加≫
・ギフト配送の有無を判断するチェック項目を追加し、ギフト配送などの購入者と発送先が異なる注文の場合には購入者情報を入力できるよう項目を追加≪機能修正≫
・「wc_templates」 の入っていない独自テーマを使用した場合に、Amazon Payでの注文
確定後に完了ページにリダイレクトされない不具合を修正

2021/01/12

Copyright© AIVEC LLC.

・IE11で決済できない不具合を修正

Amazon Pay プラグイン

4

更新履歴

対応
バージョン

改訂日

v2.2.02021/02/17

修正内容≪機能追加≫=クレジット決済設定画面=
・Welcartの「対応状況」をAmazon Payの「売上計上」や「キャンセル」とリンクするオプ
ションを追加≪機能修正≫
・権限グループが編集者と編集者（設定権限無し）のユーザーの場合でも、決済処理で売上計
上／返金／取消を行えるよう修正
・「処理区分」のデフォルトを「与信売上計上」に修正≪バグ修正≫
・会員規約同意のチェック制御の不具合を修正
・firefox及びsafariにおいて、「注文確定」ボタンをクリックして必須項目入力エラーが表示された場合、注文確定ボタンが再度押せなくなる不具合を修正

v2.2.12021/03/12

・ Welcart Basicの子テーマ（一部）を利用時、通常フローで支払方法をAmazonPayにした場合、決済できない不具合を修正

v2.3.02021/04/13≪機能追加≫
・会員様がクイック決済利用時、内容確認ページで会員情報とAmazonアカウントを連携させる
チェックボックスを追加
・ Amazonアカウントで会員登録を行ったときの入会完了メールの内容に、仮パスワード使用の内容と仮パスワードを追加≪機能修正≫
・通常フローでの利用時、DLSeller商品の内容確認ページにある「配送日時指定はこちら」の文言を「戻る」に修正

v2.3.12021/04/15

・Welcart v2.2.0の修正（会員登録・パスワード変更時のパスワードポリシーに対応）内容をAmazonPayでも対応するように修正

v2.4.02021/05/19≪機能追加≫
・Welcart対応のTCDテーマを追加対応
・会員ログインページの「Amazon Payログインボタン」の表示設定を追加≪機能修正≫
・非会員様がクイック決済で商品を購入した際にポイントが付与されてしまう不具合を修正

v2.4.12021/11/17≪機能修正≫
・決済状況ステータスの「返金」の表記を「返金済」に修正
・フックが重複していたバグを修正するに伴い、新たにフィルターを追加≪仕様変更≫
・認証確認の仕様変更
・クイック決済による新規会員登録でも、ポイントが付与されるように変更

Copyright© AIVEC LLC.

Amazon Pay プラグイン

5

更新履歴

対応
バージョン

改訂日

修正内容

v2.4.22022/04/04

AmazonPay購入後の設定が未設定の場合、Welcartの会員ログインページにエラーが表示される
不具合を修正いたしました。（会員ログインページにAmazonPayボタンが表示されるテーマが影響範囲の対象となります）

v2.5.02022/07/22≪機能追加≫
・Welcartのバージョンが2.7に更新されるのに伴い、対応いたしました。
≪機能修正≫
・「新規受注見積登録」画面にて、デバックモード時に表示されていたPHPの注意事項を表示
されないように修正いたしました。
・APIを呼び出す際にURL末尾に”/”が存在しない場合、”/”を追加する設定がされているとサーバにリダイレクトされエラーになる事象を修正いたしました。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

6

はじめに
≪概要≫
「Amazon Pay」の最大の特長は、Amazonアカウント※1でのログインを貴社ECサイトに導入することで、単なる決済手段にとどまらない、マーケティング効果が期待できる決済ソリューションであるという点です。
支払いに、Amazon Payを選択されると、Amazonに登録されているクレジットカードで決済されます。
配送先や連絡先も同じくAmazonに登録されている情報が用いられます。
初めて利用するショッピングサイトなどでは、名前・配送先・クレジット情報など入力の手間がかかります
が、Amazon Payプラグインを使用すると、名前・配送先・クレジットカード番号入力などの手間が大幅に省くことができ、カゴ落ち対策やCVR改善に有効です。

≪安全性≫
Amazon.co.jpはお客様のアカウントを保護するための予防措置を講じています。
お客様がログインするときには、安全なサーバー接続（https://）が使用されます。その際、安全なサーバー保護の業界標準である128ビット暗号化を用いたSSL（Secure Socket Layer）を使用しています。
お客様のアカウントは、お客様が設定した固有のパスワード※2によっても保護されています。

≪要件≫
PHP5.6以上※3
WordPress5.1以上
SSL必須（SHA-2）≪注意事項≫
通常、Welcartを利用する場合はHTTPSプラグインを使用しないでください。
常時SSLにする場合は、一般設定画面にて「WordPressアドレス（URL）」と「サイトアドレス（URL）」
を、 https:// にするだけでSSLにすることができます。
また、常時SSLにした場合は、Welcart管理画面のシステム設定画面にて「SSLの切り替えを行う」のチェッ
クを外してください。

※1 Amazon Payは、Amazon.co.jp（日本のAmazon）のアカウントをお持ちのお客様のみご利用可能です。
※2 パスワードに一般的な単語や語句を使用することは避けてください。パスワードは、大文字、小文字、数字をすべて含めて6文字以上にしてください。
※3 PHP5.3、PHP5.4のサポートはAmazon SDKで廃止予定です。推奨バージョン以下では正常に動作しない
可能性があります。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

7

申込方法

Amazon Payプラグインの使用するには、事前に販売事業者の登録が必要になります。
ECプラットフォームはWelcart（プラグイン）を選択してください。（登録費用無料）
https://pay.amazon.com/jp/signup
Amazon Payのご導入に際しては、一定の条件があります。
日本に拠点のある法人（登記簿をご提出いただく可能性があります。）、Amazon Pay規定の禁止ビジネスカテゴリー、または導入サイト内に禁止商材を取り扱っていない販売事業者であることが挙げられます。
詳しくは、Amazon Payサービス利用規定をご覧ください。
https://pay.amazon.com/jp/help/6023

Amazon Pay プラグイン使用料
初期費用

無料

月額費用

5,500円

決済手数料

Copyright© AIVEC LLC.

物理的商品・サービス等

3.9%

デジタルコンテンツ

4.5%

トランザクション料なし

Amazon Pay プラグイン

8

Amazon Pay 決済設定方法
1. プラグインのインストールから決済設定
Amazon Payプラグインのインストール後、「WelcartShop クレジット決済設定」画面のクレジッ
ト決済モジュール選択タブで「Amazon Pay」を選択し、「利用中のクレジット決済モジュール」のエリアにドラッグ＆ドロップします。
「利用するモジュールを更新する」をクリックして更新すると、「Amazon Pay」のクレジット決済設定タブが表示され、Amazon Payの設定ができるようになります。

▽ 画面：WelcartShop – クレジット決済設定①ドラッグ＆ドロップ

Copyright© AIVEC LLC.

Amazon Pay プラグイン

9

設定方法
2. Amazon Payプラグインの設定
Amazon Payから発行される「MWSアクセスキー」情報を元に、Amazon Pay クレジット決済の設定を行います。
MWS Access Keysは、セラーセントラルから取得できます。
※MWS Access Keysは、テスト環境（SAND BOX）と本番環境共通です。

MWSアクセスキー情報をコピーします

Copyright© AIVEC LLC.

Amazon Pay プラグイン

10

設定方法
2. Amazon Payプラグインの設定

前ページでコピーしたMWSアクセスキー情報を該当項目に貼り付けます

Copyright© AIVEC LLC.

Amazon Pay プラグイン

11

設定方法
3. 秘密鍵設定
WelcartShopクレジット決済設定画面の「Amazon Pay」タブを選択し、Amazon Pay APIにアクセスするのに必要な公開/秘密キーペアを設定します。
※キーペアの作成方法については次ページを参照してください。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

12

設定方法
3. 秘密鍵設定
キーペアは、本番環境用、テスト環境用それぞれで作成する必要があります。
（本番環境のみご利用の場合、テスト環境のキーペアを作成する必要はありません。）▽キーペア作成方法①Amazon Pay インテグレーションセントラルに接続します
https://sellercentral-japan.amazon.com/gp/pyop/seller/integrationcentral/②アカウントを選択します（本番環境 or テスト環境）③ドロップボックスから「自社開発」を選択して「手順を見る」をクリックします

Copyright© AIVEC LLC.

Amazon Pay プラグイン

13

設定方法
3. 秘密鍵設定⑤APIセクション（「手順を見る」ボタン以下）に移動して、「キーペアの作成」をクリック
します⑥ダイアログが起動してから「API呼び出しに必要な情報の生成」を選択します⑦APIキーにつける名前を入力して「キーの作成」をクリックします

手順⑥

手順⑦

Copyright© AIVEC LLC.

Amazon Pay プラグイン

14

設定方法
3. 秘密鍵設定⑧秘密鍵（.pem）が自動でダウンロードされるので、第三者と共有しない安全な場所 （任意） へ保存します※秘密鍵にアクセスできなくなった場合は、新しくキーペアを作成する必要があります⑨既存のAPIキーセクションにある作成したAPIキーの公開鍵IDをコピーして、設定方法 3. 秘密鍵
設定「公開鍵暗号ID」項目へ記入します※APIキーは、本番環境用とテスト環境用があります。お間違えの無いようにご注意ください。

公開鍵IDをコピーする

・各環境ごとに表記が異なります－ テスト環境用：「SANDBOX」－ 本番環境用 ：「本番」⑩ダウンロードした秘密鍵（.pem）をエディタで開いて記載内容すべてをコピーし、設定方法
3. 秘密鍵設定「秘密鍵」項目へ貼り付けます※「-----BEGIN PRIVATE KEY-----」から「-----END PRIVATE KEY-----」まで
すべてをコピーしてください※貼り付け後、「秘密鍵」項目に「-----BEGIN PRIVATE KEY-----」から「-----END PRIVATE KEY-----」まですべてを記入したことを確認してください

Copyright© AIVEC LLC.

Amazon Pay プラグイン

15

設定方法
4. 利用配送先設定

クイック決済を使用せず「Amazon Pay」での注文を行う場合、Amazonアカウントの配送先を優先する「Amazonアカウントから選択する配送先を利用する」を選択していると、注文手続き時に配送先を入力していても、強制的にAmazonアカウントの配送先に上書きして反映されます。
そのため、注文手続き時に入力した配送先情報を優先して反映させたい場合には「購入者が入力する配送先を利用する」を選択します。
※「Amazonアカウントから選択する配送先を利用する」を選択した場合にのみ、Amazonからの保証があるため強制的に配送先が反映されるようになっています。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

16

設定方法
4. 利用配送先設定▽「Amazonアカウントから選択する配送先を利用する」を選択した場合

配送先情報を入力し、「amazonpay」ボタンをクリックします

Copyright© AIVEC LLC.

Amazon Pay プラグイン

17

設定方法
4. 利用配送先設定▽「Amazonアカウントから選択する配送先を利用する」を選択した場合

変更せずに続行ボタンをクリック

Copyright© AIVEC LLC.

Amazon Pay プラグイン

18

設定方法
4. 利用配送先設定▽「購入者が入力する配送先を利用する」を選択した場合入力した配送先ではなく、Amazonアカウントの配送先が反映されます

Copyright© AIVEC LLC.

Amazon Pay プラグイン

19

設定方法
4. 利用配送先設定▽「購入者が入力する配送先を利用する」を選択した場合

配送先情報を入力し、「amazon pay」ボタンをクリックしますCopyright© AIVEC LLC.

Amazon Pay プラグイン

20

設定方法
4. 利用配送先設定▽「購入者が入力する配送先を利用する」を選択した場合支払い方法のみ表示されます

Amazonアカウントの配送先ではなく、入力した内容が反映されます。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

21

設定方法
5. 「対応状況」と「決済処理」を連動「連動する」に設定すると、WelcartManagement 受注データ編集画面の「対応状況」のステータ
スに応じて決済処理が行えるようになります。
※自動継続課金の受注分については対象外となります。

「対応状況」のステータスを変更して「決済状況」が反映される

売上計上処理を行っていない受注分の「対応状況」ステータスを更新すると、「対応状況」に応じた決済処理が行われます。※1,2（「対応状況」の変更による「決済状況」のステータス更新の詳細については、P22の表を参照してください。）※1 一度「発送済み」または「キャンセル」に更新した場合、それ以降、対応状況のステータスを更新しても、Amazon Payの決済処理が更新されることはありません。
※2 再度決済処理を行う場合や、返金処理を行う場合は、Amazon Payセラーセントラルから操作を行って下さい。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

22

設定方法
5. 「対応状況」と「決済処理」を連動

処理区分

対応状況
ステータス

対応状況ステータス
変更後の決済処理

受注リストの決済状況

新規受付

－※

与信

取り寄せ中

－※

与信

キャンセル

取消

取消

発送済み

売上計上

売上計上

与信

与信売上計上※

購入時に売上計上処理が行われるため、対応状況を変更しても決済処理に連動されません

売上計上－（ハイフン）の場合、決済処理は何も行われません。

受注リストの決済状況

Copyright© AIVEC LLC.

Amazon Pay プラグイン

23

設定方法
5. 「対応状況」と「決済処理」を連動▽処理区分「与信」で、対応状況を「発送済み」に更新した場合「売上計上」が行われます

Copyright© AIVEC LLC.

Amazon Pay プラグイン

24

設定方法
5. 「対応状況」と「決済処理」を連動▽処理区分「与信」で、対応状況を「キャンセル」に更新した場合「キャンセル」に更新することで「取消」が行われます

Copyright© AIVEC LLC.

Amazon Pay プラグイン

25

設定方法
5. 「対応状況」と「決済処理」を連動▽処理区分が「与信売上計上」の場合
購入確定時点で、Amazon Pay の売上計上処理が行われるため、「対応状況」を「発送済み」または「キャンセル」にしても、Amazon Pay の決済処理は行われません。

ステータスを更新しても、既に売上計上処理が行われているため、決済処理が行われません

購入時の売上計上処理によるものであり、対応
状況ステータスを変更した影響はありません。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

26

設定方法
6. 「Amazonアカウントでログイン」ボタンを表示

Amazonアカウントでログインボタンを「表示する」を選択すると、ログイン画面にAmazonア
カウントでログインするボタンが表示されます。
Amazonアカウントでのログインを有効にするには、マイページでAmazonアカウントと会員情報を連携させる必要があります。
（運用方法 5.会員情報とAmazonアカウントの連携 参照）

Amazonアカウントでログインボタン
を「表示する」に選択した場合

Copyright© AIVEC LLC.

Amazon Pay プラグイン

27

設定方法
7. 処理区分設定
売上計上を行うタイミングを設定します。
「与信」：購入時点では未計上（仮売上）であるため、計上する際は手動で実売上（売上計上）を更新する必要があります。（売上計上する方法は次ページを参照してください）「与信売上計上」：購入時点で自動的に計上されます。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

28

設定方法
7. 処理区分設定▽処理区分を「与信」にした場合
受注リストの対象明細から「決済情報」ボタンをクリックすると、ダイアログを表示して決済履歴が確認できます。
ダイアログ内のボタンをクリックして表示されている決済に対して以下の処理が行えます。
・「取消」：注文自体の取消ができます。
・「売上計上」：未計上の決済を売上計上することができます。
※「売上計上」ボタンを手動で押されない限り、未計上のままとなるため計上する際は必ずボタンをクリックしてください

Copyright© AIVEC LLC.

Amazon Pay プラグイン

29

設定方法
7. 処理区分設定▽処理区分を「与信売上計上」にした場合
受注リストの対象明細から「決済情報」ボタンをクリックすると、ダイアログを表示して計上済みの決済履歴が確認できます。
ダイアログ内の「返金する」ボタンを押すと、表示されている決済に対して返金処理が行えます。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

30

設定方法
8. Amazon Pay（クイック決済）利用設定
Welcart非会員のお客様がクイック決済で注文する際に、「お客様情報」にAmazonアカウントの配送先を登録することができます。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

31

設定方法
8. Amazon Pay（クイック決済）利用設定▽「Amazonアカウントの配送先で登録する」を選択した場合「発送先」に加えて、「お客様情報」にもAmazonアカウントの配送先情報を追加します。

「お客様情報」にも配送先が追加されます

Copyright© AIVEC LLC.

Amazon Pay プラグイン

32

設定方法
8. Amazon Pay（クイック決済）利用設定▽「Amazonアカウントの配送先で登録しない」を選択した場合「発送先」のみ登録し、「お客様情報」には登録されるのは、Amazonアカウントの氏名とメール
アドレスのみになります。

「お客様情報」にはAmazonアカウントの配送先情報が追加されません

Copyright© AIVEC LLC.

Amazon Pay プラグイン

33

設定方法
9. 支払い方法の登録

クレジット決済の設定完了後、WelcartShop 基本設定画面より支払い方法の設定を行います。

②

①
⑤

③

④

①支払方法名Amazon Payプラグインをご利用の場合は、必ず「Amazon Pay」と入力してください。

「Amazon[半角スペース]Pay」②説明
自由に説明を入力できます。
③決済種別
決済種別は、「Amazon Pay決済」を選択してください。
④決済モジュール
決済モジュールは空白のままにしてください。
⑤使用/停止支払方法を表示する場合は「使用」、表示しない場合は「停止」を選択します。
使わなくなった場合は「停止」を選択後、クレジット決済設定画面にて「利用しない」に設定
してください。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

34

設定方法
10. Amazon ログインへの登録
Amazon Payプラグインでは「Amazonログイン」するため、JavaScriptの登録が必要になります。

①セラーセントラルにログインし、「インテグレーション」- 「インテグレーションセントラル」
を選択します。

②ページ下部にある「アプリケーションを確認する」ボタンをクリックします。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

35

設定方法
10. Amazon ログインへの登録③「クライアントID/Store ID設定の管理」画面にある「編集する」を選択します。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

36

設定方法
10. Amazon ログインへの登録②「許可されたJavaScriptオリジン」の項目にWebサイトのURLを登録します。
※URLの最後に「/（スラッシュ）」を入れずに、正確に入力してください。
「/（スラッシュ）」があると正常に動作しませんので注意してください。

追加する場合は、「別のURLの追加」をクリックして入力し、完了したら「変更を保存する」ボタンをク
リックしますCopyright© AIVEC LLC.

Amazon Pay プラグイン

37

接続テスト1. テスト環境と本番環境の切り替え

セラーセントラルで、本番環境またはテスト環境へ切り替えるには、サイト上部のアカウントの選択（ドロップダウンボックス）から、「Amazon Pay(本番環境)」または「Amazon Pay(テスト環境)」を選択します。
（https://sellercentral.amazon.co.jp )▽ 動作環境がテスト環境の場合
テスト用購入者アカウントのユーザー名とパスワードでのみ使用できます。
※ 本物のAmazon購入者アカウントや販売事業者用アカウントのユーザー名とパスワードは使用できませんのでご注意ください。
テスト用購入者アカウントは、セラーセントラルでアカウントを「Amazon Payテスト環境」を選択し、インテグレーション - テストアカウントで作成できます。
動作を確認する場合は、WelcartShop クレジット決済設定画面から、「テスト環境」を選択してください。その際には、公開鍵暗号ID・秘密鍵をテスト環境用に変更してください。

※本番稼働するときは「本番環境」を選択して、公開鍵暗号IDと秘密鍵も本番環境用に変更する必要があります。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

38

接続テスト1. テスト環境と本番環境の切り替え

本番環境と同じようにAmazon Payでの取り引きをテストすることができます。
実際の請求等は発生することはありません。
テスト環境を使用するには、セラーセントラルの「インテグレーション」タブにある「テスト用購
入者アカウント」ページでテスト用の購入者アカウントを作成します。

テスト環境では、ロゴのボタンにテスト環境を示す「SANDBOX」の「S」を加えたロゴマークが表示されます。
これは、テスト担当者に注文が本物ではないことをわかりやすく知らせるためのものです。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

39

運用方法
1. 受注リストの決済状況
Amazon Payで決済があった場合、「入金状況」項目ではなく「決済状況」が更新されます。
（表示される決済状況の内容については以下表を参照してください）

決済状況

決済状況
与信

説明
仮売上状態であり、手動での売上計上待ち状態です

売上計上

売上の計上が完了しています

取消

注文の取消が完了しています

返金済

返金処理が完了しています

返金(処理中)Amazonが返金処理を行っている状態です（完了すると自動的に「返金済」になります）

返金拒否

返金処理でAmazonから返金拒否された状態です

継続課金

通常購入ではなく、継続課金であることを示しています（詳細にて継続課金の決済状況をご確認いただけます)

Copyright© AIVEC LLC.

Amazon Pay プラグイン

40

運用方法
2.決済直前ログ
Amazon Payセラーセントラルの注文ステータスに決済が発生しているにも関わらず、Welcart の受
注リストにデータが記録 されていない場合、以下の方法で受注データの復旧ができます。

①Welcart Management 受注リスト画面にて、「操作フィールド表示」を選択して「決済直前ログ
一覧」ボタンをクリックします。
※「決済直前ログ一覧」ボタンが表示されない場合は、シス テム設定＞「決済直前ログより受注データ再作成」を「利用する」にしてください。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

41

運用方法
2.決済直前ログ②「詳細」ボタンをクリックして、Amazon Payセラーセントラル注文ステータスにある「購入者Ｅメールアドレス」と「合計注文金額」が一致するデータを検索します。
※現時点ではリンクキーとAmazonリファレンスIDは紐づいていないため、リンクキーでの検索が行えません。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

42

運用方法
2.決済直前ログ③決済直前ログ詳細ダイアログで内容を確認し、「受注データ登録」ボタンを押すと、その内容で受注データが登録されます。
※その際、受注日時をログの登録された日時か、データ復旧処理を行った日時かを選択できます。

受注データ復旧した場合、Amazon Payで決済での入金状況は常に「空」で登録されます。
復旧後は必ずAmazon Payセラーセントラルにて手動で売上請求処理等を行ってください。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

43

運用方法
3.決済情報エラー確認
手動での売上計上、もしくは返金処理を行う際にエラーが表示された場合は、「処理結果」項目に表示されたエラーをクリックするとエラーの詳細内容が確認できます。

（例）合計金額を超える金額で売上計上した場合

Copyright© AIVEC LLC.

Amazon Pay プラグイン

44

運用方法
3.決済情報エラー確認（例）売上計上した金額の115％を超える金額で返金処理をした場合

Copyright© AIVEC LLC.

Amazon Pay プラグイン

45

運用方法
4.Amazonアカウントによる会員登録
Amazonアカウントがあり購入サイトの会員登録が未登録の場合、Amazon Payを利用して商品を購入する際に「Amazonアカウントで会員登録を行う」にチェックを入れると、情報を入力せずにAmazonアカウントの登録情報を購入サイトの会員登録に反映させることができます。

①「Amazon Pay」ボタンをクリックしてください。
※ボタンが表示されていない場合は、WelcartShop クレジット決済設定画面の「Amazon Pay（
クイック決済）」の利用するを選択すると表示されます。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

46

運用方法
4.Amazonアカウントによる会員登録②Amazonに登録しているEメールアドレスとパスワードを入力してください。

③使用するAmazonアカウント情報に間違いがないかを確認し、問題なければ「続行」をクリックします。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

47

運用方法
4.Amazonアカウントによる会員登録④内容確認ページ下部の「Amazonアカウントで会員登録を行う」にチェックを入れて「注文を確定する」をクリックします。
注文確定と同時に、Amazonアカウントの会員情報をもとに購入サイトの会員登録も完了します。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

48

運用方法
4.Amazonアカウントによる会員登録⑤ 「Amazonアカウントで会員登録を行う」にチェックを入れて注文確定後に自動送信される入会完了のご連絡メール（自動送信）の文頭に、仮パスワード使用の内容及び仮パスワードが追記されます。

入会完了のご連絡メール（自動送信）のヘッダ内容の文頭に追記されます。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

49

運用方法
5.会員情報とAmazonアカウントの連携
Welcart会員ログイン後、マイページ画面の 「会員情報編集」にて、すでに会員であるお客様の会
員情報とAmazonアカウントを連携させることができます。
（なお、連携を解除したい場合は「しない」を選択し、「実行」を選択してください）
連携後、会員ログインページからAmazonアカウントのみでログインできるようになります。
また、ログインしていない状態からカートページで「Amazon Pay」のボタンを押すとWelcartの会
員ログインも自動的に行えるようになります。
※ただし、 Welcart会員情報とAmazonアカウントの登録メールアドレスが同一であることが条件となります。

会員情報を入力せず、連携している
Amazonアカウントのみでログインが行えます。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

50

運用方法
5.会員情報とAmazonアカウントの連携「連携しない」を選択した場合、「Amazonアカウントでログイン」ボタ
ンをクリックしてもこのようなエラーが表示されます。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

51

運用方法
5.会員情報とAmazonアカウントの連携

Welcart会員にログイン中で、Amazonアカウントと会員情報の登録メールアドレスが同一であり、マイページの「Amazonアカウントでログイン」が「しない」の場合、クイック決済利用時の内容確認ページに、会員情報とAmazonアカウントを連携させるチェックボックスが表示されます。

「Amazonアカウントでログイン」が「しない」の他に・Welcart会員にログイン中・Welcart会員情報とAmazonアカウントの登録メール
アドレスが同一が条件となります。

チェックを入れ、注文を確定させることで、以降、会員ログインページにはAmazonアカウントのみでログインできるようになります。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

52

運用方法
6.ギフト配送
ギフト配送のように購入者様と発送先が異なる場合、「内容確認」ページにある「ギフト配送」項
目にチェックを入れます。
チェックを入れると入力項目が下に表示されるので、「購入者様」の情報を入力します。
※Welcart会員ログインをしていない場合、会員情報が取得できないため「購入者様」情報を入力する必要があります。
ログインしている場合は、会員情報が取得可能なためチェック自体表示されません。

※発送先ではなく、購入者様情報の入力項目となります。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

53

Amazon Pay チャージバックについて
チャージバックについて
WCEX Amazon Payでは、チャージバックに対応しております。
※設定ページで「購入者がAmazonアカウントから選択する配送先を利用する」を設定を行わないと、チャージバック対象外となりますのでご注意ください。
（設定方法については、P14.設定方法 - 4. 優先配送先設定を参照してください）
詳しくは「チャージバックに関するよくある質問」をご覧ください。
https://pay.amazon.co.jp/help/201749690

Copyright© AIVEC LLC.

Amazon Pay プラグイン

54

予期せぬエラー
正常決済を行っているのにエラーとなってしまう場合は、以下の点を確認します。
・クレジット決済設定「MWS Access Keys」に誤りがないか・Login with AmazonへのJavaScriptの登録に誤りがないか
・SSL証明書は正常か
・秘密鍵設定に誤りがないか・Basic認証やIPアドレスによるアクセス制限をしていないか
・他のプラグイン（メンテナンスモードを含めて）を停止して動作確認してみる・テーマをWelcart Default テーマに切り替えてみる
・Welcart の推奨システム要件の確認（PHPバージョン、サーバースペック等）

注意事項
・Wordpressのマルチサイトへは、ご利用いただけません。
・他社プラグインと競合して正常に動作しない報告が多発しています。
（特にinternet explorer 11（IE11）やバージョンが古いブラウザ等）
特に注意するプラグイン等（2021年2月15日現在）– Really Simple SSL– zipaddr-jp– Google reCAPTCHA v3（旧ブラウザ）

Copyright© AIVEC LLC.

Amazon Pay プラグイン

55

エラー一覧
一般的なエラーについて
下記のエラーは「usc-e-shop/logs/amazon_pay.log」に記載されるエラーです。

コード

コード名

購入者向け
メッセージ

INVALID_PARAMETER_VALUE

InvalidParameterValue

技術的なエラーが発生しました。

INVALID_HEADER_VALUE

InvalidHeaderValue

技術的なエラーが発生しました。

INVALID_REQUEST_FORMAT

InvalidRequestFormat

技術的なエラーが発生しました。

INVALID_REQUEST

InvalidRequest

技術的なエラーが発生しました。

MISSING_HEADER_VALUE

MissingHeaderValue

技術的なエラーが発生しました。

MISSING_PARAMETER_VALUE

MissingParameterValue

技術的なエラーが発生しました。

UNRECOGNIZED_FIELD

UnrecognizedField

技術的なエラーが発生しました。

DUPLICATE_IDEMPOTENCY_KEY

DuplicateIdempotencyKey

技術的なエラーが発生しました。

CURRENCY_MISMATCH

CurrencyMismatch

技術的なエラーが発生しました。

UNAUTHORIZED_ACCESS

UnauthorizedAccess

技術的なエラーが発生しました。

INVALID_ACCOUNT_STATUS

InvalidAccountStatus

技術的なエラーが発生しました。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

56

エラー一覧
一般的なエラーについて

コード

コード名

購入者向け
メッセージ

INVALID_REQUEST_SIGNATURE

InvalidRequestSignature

技術的なエラーが発生しました。

RESOURCE_NOT_FOUND

ResourceNotFound

技術的なエラーが発生しました。

REQUEST_NOT_SUPPORTED

RequestNotSupported

技術的なエラーが発生しました。

UNSUPPORTED_OPERATION

UnsupportedOperation

技術的なエラーが発生しました。

AMAZON_INTERNAL_SERVER_ER
RORInternalServerError

技術的なエラーが発生しました。

TOO_MANY_REQUESTS

TooManyRequests

技術的なエラーが発生しました。

SERVICE_UNAVAILABLE

ServiceUnavailable

Amazonのサーバーに技術的な問題が発生しています。もう一度お試しくだ
さい。

AMAZON_PAY_SDK_CLIENT_EXCE
PTION

Amazon PaySDKClientException

Amazon Payの設定に問題があります。管理画面から再確認した上でもう一度お試しください。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

57

エラー一覧
決済エラーについて
下記のエラーは「usc-e-shop/logs/acting_transaction.log」に記載されるエラーです。

■取引情報を更新するAPI

コード

購入者向け
メッセージ

コード名

RESOURCE_NOT_FOUND

ResourceNotFound

セッション期限切れです。注文処理を最初からやり直してください。ご不便をおかけしてしまい申し訳ございません。

INVALID_CHECKOUT_SESSION_STATUS

InvalidCheckoutSessionSt
atus

注文処理をできない状態になっています。注文手続
きを最初からやり直してください。ご不便をおかけしてしまい申し訳ございません。

CONSTRAINT_CHECKOUT_RE
SULT_RETURN_URL_NOT_SE
T

CheckoutResultReturnUrl
NotSet

技術的なエラーが発生しました。

CONSTRAINT_CHARGE_AMO
UNT_NOT_SET

ChargeAmountNotSet

技術的なエラーが発生しました。

CONSTRAINT_PAYMENT_INTEPaymentIntentNotSet
NT_NOT_SET

技術的なエラーが発生しました。

CONSTRAINT_BUYER_NOT_A
SSOCIATED

Copyright© AIVEC LLC.

CONSTRAINT_BUYER_N Amazonアカウントからお支払い方法を選択してかOT_ASSOCIATED
らもう一度お試しください。

Amazon Pay プラグイン

58

エラー一覧
決済エラーについて
下記のエラーは「usc-e-shop/logs/acting_transaction.log」に記載されるエラーです。

■取引情報を完了するAPI

コード

コード名

購入者向け
メッセージ

管理者向け
メッセージ

CHECKOUT_SESSI
ON_CANCELEDCHECKOUT_SESSION 選択された支払い方法に問題があり_CANCELEDました。もう一度お試しください。

お支払い方法は拒否されたか、それとも処理中に取引はキャンセルされました。

CURRENCY_MISM
ATCH

CurrencyMismatch

内部処理エラー。取引を処理できませんでした。もう一度お試しください。

購入手続きを始めた時の通貨
は取引完了する動作に使った通貨と異なります。

最高取引金額を超えています。別ウィンドウ・タブで商品追加や数量変更を行っていれば、それらのウィン
ドウ・タブを閉じてからもう一度お試しください。

最高取引金額を超えています。

ResourceNotFound

セッションは期限切れです。注文処理を最初からやり直してください。

「Checkout Session」を使った時から30日間が立っている。どの動作を行っていてもこのエラーが返却されます。

AMOUNT_MISMAT
CH

AmountMismatch

取引金額が変更されました。別ウィ
ンドウ・タブで商品追加や数量変更を行っていれば、それらのウィンド
ウ・タブを閉じてからもう一度お試しください。

購入確定した時の金額は取引完了する動作に指定した金額と異なります。

INVALID_CHECKOUT_SESSION_STA
TUS

InvalidCheckoutSessio
nStatus

内部処理エラー。取引を処理できませんでした。もう一度お試しください。

取引のステータスにより、実行しようとした処理が無効です。

INVALID_CHARGE_STATUSInvalidChargeStatus

内部処理エラー。取引を処理できませんでした。もう一度お試しください。

取引のステータスにより、実行しようとした処理が無効です。

TransactionAmountExc
TRANSACTION_AM
eeded
OUNT_EXCEEDEDRESOURCE_NOT_FOUND

Copyright© AIVEC LLC.

Amazon Pay プラグイン

59

エラー一覧
決済エラーについて

コード

コード名

購入者向け
メッセージ

管理者向け
メッセージ
支払いはソフトに却下されました。
繰り返し再試行しても失敗する場合
は、購入者に連絡して、別の支払い方法を選択してもらいます。

SOFT_DECLINED

SoftDeclined

お支払い方法は拒否されました。別の支払い方法を選択してもう一度お試しください。

HARD_DECLINED

HardDeclined

お支払い方法は拒否されました。別の支払い方法を選択してもう一度お試しください。

支払いは却下されました。再試行はできないため、購入者に連絡し別の支払い方法を選択してもらいます。

PAYMENT_METHO
D_NOT_ALLOWED

PaymentMethodNotAllo
wed

お支払い方法は拒否されました。別の支払い方法を選択してもう一度お試しください。

購入者が選択した支払い方法は、この請求では許可されていません。

AMAZON_REJECTED

AmazonRejected

お支払い方法は拒否されました。別の支払い方法を選択してもう一度お試しください。

アマゾンが請求を拒否しました。関連する課金許可もキャンセルされます

MFA_NOT_COMPLETEDMFANotCompleted

内部処理エラー。取引を処理できませんでした。もう一度お試しください。

このトランザクションを処理するには、購入者が多要素認証（MFA）を完了する必要があります。

TransactionTimedOut

取引はタイムアウトエラー、Amazonが注文を処理できませんでした。もう一度お試しください。ご不便をおかけしてしまい申し訳ございません。

Amazonが承認を処理するのに十分な時間がなかったため、請求は拒否されました。

ProcessingFailure

Amazonが注文を処理できませんでした。もう一度お試しください。ご不便をおかけしてしまい申し訳ございません。

内部処理エラーのため、Amazonは請求を処理できませんでした。充電
許可が充電可能状態にある場合にのみ、充電を再試行する必要があります。

TRANSACTION_TI
MED_OUTPROCESSING_FAI
LURE

Copyright© AIVEC LLC.

Amazon Pay プラグイン

60

Welcart拡張プラグイン対応状況
Welcart拡張プラグインのサポート

Welcart 拡張プラグイン

対応状況

wcex_coupon◯

wcex_dlseller※△

wcex_multiprice◯wcex_sku_select◯wcex_auto_delivery✕

wcex_mobile◯

wcex_multiple_shipping✕

wcex_widget_cart◯※通常課金のDLSeller商品（コンテンツファイル、サービス）であれば使用可能ですが、継続課金に関しては使用ができません。

Copyright© AIVEC LLC.

Amazon Pay プラグイン

61