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
- 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.
- 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