SetOrderReferenceDetails | Amazon Pay Japan

SetOrderReferenceDetails

注文金額や説明などの注文の詳細をOrder Referenceにセットします。

説明

注文金額、説明、その他の注文属性などの注文の詳細をOrder Referenceに指定するためにSetOrderReferenceDetails処理を呼び出します。

本番環境では、この処理の最大リクエストクォーターは10であり、回復レートは1秒間に1回です。SANDBOX環境では、最大リクエストクォーターは2であり、回復レートは2秒間に1回です。

リクエストパラメータ

パラメータ名 必須 タイプ 説明
AmazonOrderReferenceId 必須 xs:string Order ReferenceのIDです。

この値は購入者がAmazonによって認証に成功した後にAmazonボタンウィジェットから取得されます。
OrderReferenceAttributes 必須 OrderReferenceAttributes Order Referencに販売事業者が指定する属性です。

レスポンス要素

パラメータ名 説明
OrderReferenceDetails Order Referenceオブジェクトの詳細とその現在のステータスが含まれます。

タイプ:OrderReferenceDetails

サンプル

呼び出しリクエストのサンプル

 
POST /OffAmazonPayments/2013-01-01 HTTP/1.1  
Content-Type: x-www-form-urlencoded  
Host: mws.amazonservices.com  
User-Agent: <Your User Agent Header>  
AWSAccessKeyId=0GS7553JW74RRM612K02EXAMPLE  
&Action=SetOrderReferenceDetails  
&AmazonOrderReferenceId=P01-1234567-1234567  
&OrderReferenceAttributes.OrderTotal.Amount=106  
&OrderReferenceAttributes.OrderTotal.CurrencyCode=USD  
&OrderReferenceAttributes.PlatformId=PLATFORM_ID_HERE  
&OrderReferenceAttributes.SellerNote=Lorem%20ipsum  
&OrderReferenceAttributes.SellerOrderAttributes.SellerOrderId=5678-23  
&OrderReferenceAttributes.SellerOrderAttributes.StoreName=YOUR_STORE_NAME  
&SellerId=YOUR_SELLER_ID  
&SignatureMethod=HmacSHA256  
&SignatureVersion=2  
&Timestamp=2012-11-05T19%3A01%3A11Z  
&Version=2013-01-01  
&Signature=2RPzkOgQmDybUjk0dA54maCEXAMPLE

次の点について注意してください。

  • &Actionは&AmazonOrderReferenceIdより先に記載しなければなりません。
  • &SignatureMethod値のHmacSHA256は大文字小文字を区別します。

レスポンスのサンプル

 
<SetOrderReferenceDetailsResponse  
  xmlns="https://mws.amazonservices.com/  
    schema/OffAmazonPayments/2013-01-01">  
<SetOrderReferenceDetailsResult>  
  <OrderReferenceDetails>  
    <AmazonOrderReferenceId>P01-1234567-1234567</AmazonOrderReferenceId>  
    <OrderTotal>  
      <Amount>106</Amount>  
      <CurrencyCode>USD</CurrencyCode>  
    </OrderTotal>  
    <SellerOrderAttributes>  
      <SellerOrderId>5678-23</SellerOrderId>  
    </SellerOrderAttributes>  
    <SellerNote>Lorem ipsum</SellerNote>  
    <CreationTimestamp>2012-11-05T20:21:19Z</CreationTimestamp>  
    <ExpirationTimestamp>2013-05-07T23:21:19Z</ExpirationTimestamp>  
    <OrderReferenceStatus>  
      <State>Draft</State>  
    </OrderReferenceStatus>  
    <Destination>  
      <DestinationType>Physical</DestinationType>  
      <PhysicalDestination>  
        <City>New York</City>  
        <StateOrRegion>NY</StateOrRegion>  
        <PostalCode>10101-9876</PostalCode>  
        <CountryCode>US</CountryCode>  
      </PhysicalDestination>  
    </Destination>  
    <ReleaseEnvironment>Live</ReleaseEnvironment>  
  </OrderReferenceDetails>  
</SetOrderReferenceDetailsResult>  
<ResponseMetadata>  
  <RequestId>f42df4b1-8047-11df-8d5c-bf56a38ef3b4</RequestId>  
</ResponseMetadata>  
</SetOrderReferenceDetailsResponse>