With the app "Alexa Delivery Notifications" for Shopify, you can automatically notify customers who have paid with Amazon Pay via Alexa that their goods have been shipped.
The app automatically sends the appropriate notifications to Amazon Pay as soon as you create or update a fulfillment for an Amazon Pay paid order and this fulfillment contains a tracking number and a shipping service provider which can be mapped to Alexa.
In return, the app sets a Shopify metafield on the order when the notification was sent successfully.
The app is integrated in your Shopify admin area. It does not affect your storefront.
To use it you require:
An Amazon Pay account (the same account you already use for Amazon Pay transactions)
A standard, ES6 compatible browser (recommended: Chrome) to use the app admin area.
Add the app to your Shopify store like any other app.
You can access the app via the “Apps” area in your Shopify admin.
The app needs access to the resources “Orders”, “Fulfillments” and “Transactions”.
The app sets a metafield on orders in order to signal the successful sending of a delivery notification.
The app extracts the tracking number and shipping service from the fulfillments.
It also uses the contained order ID to acquire transactions belonging to the order.
Transactions need to be accessed to determine the Amazon Pay reference ID of the order.
This reference ID is needed to send the delivery tracker notification to Amazon Pay.
You can access the configuration of the app by opening it via your Shopify admin “Apps” area.
Note that any changes to the configuration only become active after explicitly saving them.
The account settings are used by the app to connect to your Amazon Pay account to send the delivery tracker notifications.
Select the region of your Amazon Pay account here.
Depending on the selected region you can follow the displayed link to get more information on acquiring a public key ID and private key from Amazon Pay.
Enter the public key ID here which you can get from your Seller Central account.
Enter your private key here which you received when creating a new public / private key pair in the Seller Central.
You usually get the private key in a .pem-file. Copy the whole content of that file into the text area.
Note that the app will never show your private key on repeated access to the app interface for security reasons.
It will, however, show a hint if a private key was saved before.
As soon as you enter a private key in the form, you can test your credentials with this button.
If you disable this option, no delivery notifications will be send anymore.
The app initially ships with default mappings for Shopify delivery services and the corresponding Alexa codes.
If for any reason you want to change these mappings or add new ones, you can do this here.
Here you can see the custom mappings you created.
With the “-” button you can remove your custom mapping.
Here you can enter a Shopify carrier code and the select the Alexa code you want to map it to.
Press the “+” button to add your mapping (or override an existing mapping for the same Shopify carrier code).
This button toggles a table that contains all default Shopify carrier codes with their respective default Alexa code mappings (and your custom mappings for them, if any).
With this button you save your current settings. Please always save your changes for them to become effective.
During normal operation of your store you do not need to do anything special. The app works autonomously in the background and is controlled by Shopify webhooks.
The app sets a metafield on orders for which a delivery notification was successfully sent. The metafield has the name “delivery_notification” in the namespace “alexa_delivery” and always has the value “success”.
It is not technically possible for the app to display that metafield within orders in your admin area.
If you want to see metafields in your orders you can use browser extensions which were built for this purpose, like ShopifyFD.
The private key has to be given exactly as it is contained in the PEM file. In particular, the parts ----BEGIN RSA PRIVATE KEY----- and ----END RSA PRIVATE KEY----- have to also be contained in the text area.
Initial Release
TODO