Amazon Pay APIの代理実行

事業者に変わってAmazon Pay APIを代理実行する場合は、V2 Authorization Token(以下、V2AuthToken)をヘッダーに追加します。ヘッダーのキーはX-Amz-Pay-AuthTokenです。

サポートされている操作:

Create Authorization Token - GET https://pay-api.amazon.com/:environment/:version/authorizationTokens/:mwsAuthToken?merchantId=:merchantId

Create Authorization Token - GET https://pay-api.amazon.eu/:environment/:version/authorizationTokens/:mwsAuthToken?merchantId=:merchantId

Create Authorization Token - GET https://pay-api.amazon.jp/:environment/:version/authorizationTokens/:mwsAuthToken?merchantId=:merchantId

V2AuthTokenの生成

MWS認証トークンを利用してV2AuthTokenを生成します。

リクエスト

リクエストボディ

curl "https://pay-api.amazon.com/:environment/:version/authorizationTokens/:mwsAuthToken?merchantId=:merchantId"
-X GET
-H Authorization: AMZN-PAY-RSASSA-PSS PublicKeyId=f4fc06fc-c5a7-11e7-abc4-cec278b6b50a, SignedHeaders=content-type;x-amz-pay-date, Signature=4164128ec5d1b9da1700167ab2ccda8125f472c8bb9de447cebf5d741ee317c8

リクエストパラメーター

名前
ロケーション
説明
mwsAuthToken
(必須)

Type: string
パスパラメータ
ソリューションプロバイダーが事業者に代わってCV1 API呼び出しを行うために現在使用しているMWS認証トークン。
merchantId
(必須)

Type: string
クエリパラメータ
Amazon Pay 事業者アカウント識別子

レスポンス

処理が成功した場合、 HTTP 200 (OK) ステータスを返します。

HTTP/1.1 200 OK 
Host: pay-api.amazon.com
Content-type: application/json
{
  "authorizationToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}

エラーコード

一般的なエラーはこちらを参照してください。

HTTPステータスコード
理由コード
エラー説明
400 InvalidHeaderValue API呼び出しのヘッダーパラメータの少なくとも1つに無効な値を送信しました

詳細については、APIレスポンスのメッセージ内容を確認してください
400 InvalidParameterValue API呼び出しのパラメータの少なくとも1つに無効な値を送信しました

詳細については、APIレスポンスのメッセージ内容を確認してください
400 InvalidRequestFormat 無効なJSON形式でリクエストを送信しました。リクエストの本文の形式を確認してください
401 UnauthorizedAccess 指定された事業者アカウントは、このリクエストを実行する権限がありません
403 InvalidRequestSignature API呼び出しのAuthorizationヘッダーの署名が無効です

詳細については、APIレスポンスのメッセージ内容を確認してください
403 InvalidAuthorizationToken The token and merchantId combination specified is invalid. リクエストで渡されたauthorization tokenとmerchantIdの組み合わせが無効です
404 ResourceNotFound 要求されたリソースが見つかりませんでした
405 RequestNotSupported HTTPメソッドはサポートされていません

詳細については、APIレスポンスのメッセージ内容を確認してください
500 InternalServerError 不明なエラーが発生しました

リクエストを再試行してください。ただし、再試行しても正常なレスポンスが保証されるわけではありません
503 ServiceUnavailable 一時的な過負荷またはメンテナンスのため、現在リクエストを処理できません

リクエストを再試行してください