Step 8. Retrieve the shipping address

If your business ships physical goods, you can retrieve the buyer's shipping address by using the Manage Transactions tool in Seller Central under Orders.

You can also retrieve the shipping address by calling the GetOrderReferenceDetails operation. Express integration handles details like SetOrderReferenceDetails and ConfirmOrderReferenceDetails automatically so you can call GetOrderRefernceDetails directly using the orderReferenceId appended to the return URL that you have specified.

You can easily test the GetOrderReferenceDetails operation by using the Amazon MWS Scratchpad tool.

Test the GetOrderReferenceDetails operation

1. Open Amazon MWS Scratchpad and make the following selections under the API Selection:
• API Section: choose Off-Amazon Payments.
• Operation: under OffAmazonPayments-Sandbox, click GetOrderReference Details.
2. Enter your credentials and the Authentication parameters, and then click Submit.

The following example shows a Scratchpad request:

 
POST /OffAmazonPayments/2013-01-01 HTTP/1.1 
Content-Type: x-www-form-urlencoded 
Host: mws.amazonservices.com 
User-Agent:  

AWSAccessKeyId=AKIAJKYFSJU7PEXAMPLE 
&Action=GetOrderReferenceDetails 
&AccessToken=YOUR_ACCESS_TOKEN
&AmazonOrderReferenceId=P01-1234-56EXAMPLE 
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE 
&SellerId=YOUR_SELLER_ID_HERE 
&SignatureMethod=HmacSHA256 
&SignatureVersion=2 
&Timestamp=2012-11-05T19%3A01%3A11Z 
&Version=2013-01-01 
&Signature=CLZOdtJGjAo81IxaLoE7af6HqK0EXAMPLE

The following example shows a Scratchpad response to a GetOrderReferenceDetails operation call.

 
<GetOrderReferenceDetailsResponse 
   xmlns="http://mws.amazonservices.com/schema/OffAmazonPayments/2013-01-01">
  <GetOrderReferenceDetailsResult>
    <OrderReferenceDetails>
    <AmazonOrderReferenceId>S01-8474066-EXAMPLE</AmazonOrderReferenceId>
    <ExpirationTimestamp>2015-08-31T17:27:35.053Z</ExpirationTimestamp>
    <SellerNote>Thank you for your order.</SellerNote>
    <OrderTotal>
      <Amount>15.00</Amount>
      <CurrencyCode>USD</CurrencyCode>
    </OrderTotal>
    <IdList>
      <member>S01-8474066-2115738-EXAMPLE</member>
    </IdList>
    <OrderReferenceStatus>
      <LastUpdateTimestamp>
        2015-03-04T17:27:43.851Z
      </LastUpdateTimestamp>
      <State>Open</State>
    </OrderReferenceStatus>
    <Destination>
      <DestinationType>Physical</DestinationType>
      <PhysicalDestination>
        <Phone>800-000-0000</Phone>
        <PostalCode>60602</PostalCode>
        <Name>Susie Smith</Name>
        <CountryCode>US</CountryCode>
        <StateOrRegion>IL</StateOrRegion>
        <AddressLine2>Suite 2500</AddressLine2>
        <AddressLine1>10 Ditka Ave</AddressLine1>
        <City>Chicago</City>
      </PhysicalDestination>
    </Destination>
    <ReleaseEnvironment>Sandbox</ReleaseEnvironment>
    <Buyer>
      <Email>address@domain.com</Email>
      <Name>Sandbox_tester</Name>
    </Buyer>
    <SellerOrderAttributes>
      <StoreName>Sandbox_test_app</StoreName>
    </SellerOrderAttributes>
    <CreationTimestamp>2015-03-04T17:27:35.053Z</CreationTimestamp>
    </OrderReferenceDetails>
  </GetOrderReferenceDetailsResult>
  <ResponseMetadata>
    <RequestId>181efc0d-a90b-429f-837e-1209bfe4da0e</RequestId>
  </ResponseMetadata>
</GetOrderReferenceDetailsResponse>

See also

GetOrderReferenceDetails in the Amazon Pay API reference guide