Introduction

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.

Installation / Update

System Requirements

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.

Installation

Add the app to your Shopify store like any other app.

You can access the app via the “Apps” area in your Shopify admin.

Require API Access

The app needs access to the resources “Orders”, “Fulfillments” and “Transactions”.

Orders

The app sets a metafield on orders in order to signal the successful sending of a delivery notification.

Fulfillments

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

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.

Configuration

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.

Account Settings

The account settings are used by the app to connect to your Amazon Pay account to send the delivery tracker notifications.

Region

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.

Public Key ID

Enter the public key ID here which you can get from your Seller Central account.

Private Key

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.

Test credentials

As soon as you enter a private key in the form, you can test your credentials with this button.

Turn on Alexa Delivery Notifications

If you disable this option, no delivery notifications will be send anymore.

Custom Carrier Mappings

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.

Existing Custom Mappings

Here you can see the custom mappings you created.

With the “-” button you can remove your custom mapping.

Create New 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).

Show / Hide all mappings

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

Save

With this button you save your current settings. Please always save your changes for them to become effective.

Operation

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.

Metafields

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.

FAQ

Why do I get a warning message for the format of my private key?

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.

Changelog

v1.0.0 (July 2020)

• Initial Release

Support and Contact

TODO