Step8:売上請求のリクエスト | Amazon Pay Japan

Step8:売上請求のリクエスト

いつでも購入者に請求や定期ロジックごとに請求リクエストできます。Billing Agreementは運用ルールにて要求された頻度(週次、月次、年次など)で調整可能な金額を柔軟に請求することを許可します。

AuthorizeOnBillingAgreement処理の呼び出しに成功し、オーソリオブジェクトがOpen状態になった後、オーソリに対応する資金を売上請求することができます。直ちに資金を売上請求するために、AuthorizeOnBillingAgreement処理をCaptureNowパラメータに True をセットして呼び出すことができます。別の方法としては、個別に売上請求をリクエストしなければなりません。

売上請求オブジェクト

売上請求オブジェクトは購入者からの資金をアカウントに移動することを意味します。すべての売上請求オブジェクトは前もって作成された有効なオーソリオブジェクトに関連されます。売上請求オブジェクトは次の4つのステータスの内のどれかになります。

  • Pending - 売上請求オブジェクトはAmazonによって処理されるまでPending状態中です。売上請求処理の同期レスポンスはPending状態を返します、また、リクエストがAmazonによって処理されるまで、このステータスが存続します。処理が完了した後は、Amazonは処理ステータスを通知します。最終の売上請求ステータスを受け取る方法の詳細な情報は、下記「売上請求ステータスの取得」を参照してください。
  • Declined - Amazonが売上請求リクエストを断った時に、売上請求オブジェクトはDeclined状態です。詳しい情報は「Declinedとなった売上請求」を参照してください。
  • Completed - 購入者の売上請求が成功した時に、売上請求オブジェクトはCompleted状態になります。
  • Closed - Amazonが購入者アカウントに問題を確認した、売上請求の最大金額がすでに返金された、売上請求に対して10回の部分返金がリクエストされた場合に、売上請求オブジェクトはClosed状態に遷移します。返金できる最大額は売上請求金額の15%もしくは8,400円のどちらか低い額を加算した金額までです。

Declinedとなった売上請求

売上請求処理がDeclinedとなった場合、レスポンスに以下の2つの理由コードの内の1つが含まれ参照できます。

AmazonRejected

AmazonRejectedは売上請求の処理はAmazonによって失敗になったことを示します。Amazonが売上請求を拒否した場合は、オーソリオブジェクトとBilling AgreementオブジェクトはClosedになります。オーソリがClosedの場合は、売上請求リクエストは失敗になります。Billing AgreementがまだOpen状態の場合は、新しいオーソリをリクエストし、それからオーソリから売上請求をリクエストします。

ProcessingFailure

ProcessingFailureはAmazonの内部処理エラーのためにトランザクションを処理できなかったことを示します。1、2分以内にリクエストをリトライしてください。

このケースでは、Billing AgreementオブジェクトはまだOpenであり、Amazonは新しいAuthorizeOnBillingAgreement処理を呼び出し確認し、続いて新しい売上請求処理の呼び出しを推奨します。

売上請求オブジェクトの状態遷移についての詳しい情報は、「システムと Amazon Payの同期」を参照してください。

オーソリオブジェクトで指定された資金を回収するためには、売上請求処理の呼び出しを、本番環境モードではオーソリに成功してから 30日以内に、Sandboxモードでは2日以内にしなければなりません。

次のサンプルは売上請求処理を呼び出す方法を表します。

 
https://mws.amazonservices.com/OffAmazonPayments_Sandbox/2013-01-01  
?AWSAccessKeyId=AKIAFBM3LG5JEEXAMPLE  
&Action=Capture  
&AmazonAuthorizationId=S23-1234567-1234567-0000001  
&CaptureAmount.Amount=94.50  
&CaptureAmount.CurrencyCode=USD  
&CaptureReferenceId=test_capture_1  
&SellerCaptureNote=Payment%20for%20Blue%20Shoes  
&SellerId=YOUR_SELLER_ID_HERE  
&SignatureMethod=HmacSHA256  
&SignatureVersion=2  
&Timestamp=2013-11-19T19%3A01%3A11Z  
&Version=2013-01-01  
&Signature=WlQ708aqyHXMkoUBk69Hjxj8qdh3aDcqpY71hVgEXAMPLE  
    

売上請求の処理、含まれるリクエストパラメータ、レスポンス要素についての詳しい情報は、 Amazon Pay APIリファレンスのCaptureを参照してください。

売上請求ステータスの取得

売上請求リクエストを実行した場合、Amazon Payは直ちにそれを処理します。売上請求リクエストに対するレスポンスは、CompletedDeclined状態を示します。

処理が完了した後、Amazon Payはインスタント支払通知(IPN)サービスを経由して処理状態を通知します。Amazon Payで売上請求リクエストが完了できなかった場合は、Declinedメッセージを受け取ります。インスタント支払通知(IPN)サービスについての詳しい情報は、「システムとAmazon Payの同期」を参照してください。

売上請求レスポンスで返されたAmazonCaptureIdを利用してGetCaptureDetails処理を呼び出すことで、売上請求オブジェクトの詳細について追加要求できます。完了した売上請求に対する資金を返金するために、この識別子が必要になります。詳しい情報は、Amazon Pay APIリファレンスガイドGetCaptureDetailsを参照してください。

売上請求成功の購入者メール

売上請求が成功した場合いつでも、Amazon Payは購入者に売上請求についての詳細を請求通知メールにて送信します。

注意:Amazon Payは、送信されるメール内の各種情報を指定することを許可します。例えば、販売事業者のカスタマーサービスメール、電話番号、メモです。これらの詳しい情報は、このガイド内の「提供可能な購入者向けのメールコンテンツ」を参照してください。