Setting up delivery notifications
Provide shipment tracking information to Amazon Pay using Create Delivery Tracker so that Amazon Pay can notify buyers on Alexa when shipments are out for delivery and when they are delivered. This API is channel-agnostic. That means that anywhere you use Amazon Pay, you can use the Delivery Tracker API.
Buyer experience
Here is what your buyer will experience:
Customer: Alexa, read my notifications.
Out for delivery notification Alexa: You have one new notification, from Amazon Pay. A shipment from [yourstorename] is scheduled to arrive by [date].
Delivery notification Alexa: You have one new notification, from Amazon Pay. Your shipment from [yourstorename] has been delivered.
Ecommerce plugins
You can either integrate the Delivery Tracker APIs yourself, or use one of the pre-built solutions for your region below.
Ecommerce solution
|
Resources
|
Min. plugin version
|
Magento 1 | Installation steps and documentation | 3.0.14 |
Magento 2 | Installation steps and documentation | 1.0.0 |
Ecommerce solution
|
Resources
|
Min. plugin version
|
Magento 1 | Installation steps and documentation | 3.0.14 |
Magento 2 | Installation steps and documentation | 1.0.0 |
PrestaShop | Installation steps and documentation | 2.3.2 (PrestaShop 1.6) 3.3.0 (PrestaShop 1.7) |
JTL Shop 4 | Installation steps and documentation | 1.0.0 |
Integration steps
1. Create a Delivery Tracker
Call Create Delivery Tracker with the Amazon chargePermissionID
, shipping company carrierCode
, and trackingNumber
to enable delivery notifications.
Request
Request parameters
Name
|
Location
|
Description
|
amazonOrderReferenceId - or - chargePermissionId (required) Type: string |
Body
|
The Amazon Order Reference ID or Charge Permission ID associated with the order for which the shipments need to be tracked
|
carrierCode (required) Type: string |
Body
|
The shipping company code used for delivering goods to the customer. Download carrierCode list
|
trackingNumber (required) Type: string |
Body
|
The tracking number for the shipment provided by the shipping company
|
Response
{
"amazonOrderReferenceId": "P00-0000000-0000000",
"deliveryDetails": [{
"trackingNumber": "1Z999AA10123456784",
"carrierCode": "UPS"
}]
}
2. Test your integration
You will need an Alexa-enabled device for end-to-end testing.
Sandbox testing
You can ensure a fully functional integration by executing an end-to-end test in Sandbox but no Delivery Notification will be sent. To test in Sandbox:
- Create a test order and save the
chargePermissionID
ororderReferenceID
- Call Create Delivery Tracker using the
ChargePermissionID
orOrderReferenceID
, a random tracking code, and a carrier code of one of the supported carriers. - Verify that the API calls returns a HTTP 200 (OK) status.
Live testing (optional)
A successful sandbox test is sufficient for ensuring the integration will work as expected but Live testing is the only way to trigger the full experience including a notification on your Alexa-enabled device. Prerequisites:
- Your Alexa-enabled device must be connected to the Amazon account you’re using for the Live order
- You must enable delivery and out for delivery notification under Settings → Notifications → Amazon Shopping in the Alexa app. Note that for customer outside of the US, the account must have at least one order fulfilled by Amazon to be enrolled for notifications, otherwise you will not see the settings.
Call Create Delivery Tracker once the order has been shipped and a real tracking code has been generated. You should receive a notification on your Alexa-enabled device when the order is shipped and when the order is delivered. Note that tracking codes can only be used once.