Amazon Pay and Login with Amazon integration guide

Buyer-facing email content that you can provide

Amazon sends an email to buyers in the following situations:

  • When an Order Reference object is confirmed
  • Any time that funds are captured
  • Any time that a refund is issued
  • Any time that a payment method is changed

Amazon supplies most of the content for the emails, but there are several elements within the body of the message that you can provide. The following table lists the buyer-facing email content that you can define based on account settings and API operation parameters:

Email field

Source

Seller customer service email address

Specified when you set up your Amazon merchant account or from the Seller Central Settings section under Account Info.

Seller customer service phone number

Specified when you set up your Amazon merchant account or from the Seller Central Settings section under Account Info.

Seller store name

Specified when you set up your Amazon merchant account or from the Seller Central Settings section under Account Info. Can be overridden by specifying the StoreName request parameter of the SetOrderReferenceDetails operation.

Seller order identifier

Specified in the SellerOrderId request parameter of the SetOrderReferenceDetails operation.

Total order amount

Specified in the OrderTotal request parameter of the SetOrderReferenceDetails operation.

Order date

The date and time when the Order Reference object is confirmed and moves to the Open state.

Seller note

Specified in the SellerNote request parameter of the SetOrderReferenceDetails operation, the Authorize operation, the Capture operation, or the Refund operation.

Best practices

As a best practice, we recommend that you set the following information in your API calls:

  • Order total
  • Store name
  • Seller order ID
  • Seller note

Setting the Store Name and Seller information affects the details that appear in the following:

  • Buyer emails and account status
  • Information that is returned to you in IPN messages
  • Settlement and transaction reports

Settlement reports can be filtered by Store Name if you have multiple stores/sites.

You can compare and reconcile reports with your SellerOrderId.

Payment initiated emails

When your buyer authenticates with Amazon, Amazon Pay and Login with Amazon creates a system object called the Order Reference object, and you then call the SetOrderReferenceDetails operation to set additional attributes in the Order Reference object.

The screenshot below shows a part of a Payment initiated email that is sent to a buyer. Note the numbered fields and the corresponding parameter in the Order Reference object that is used to populate that field.

Notes:

  • You specify the Seller Information email address and phone number (shown in the screenshot as "customerservice@courtandcherry.co.uk" and "0800 321 5678" respectively) when you set up your Amazon merchant account or anytime from Seller Central in the Settings section under Account Info. The SetOrderReferenceDetails API call cannot override them.
  • The Payment initiated email is not sent in two cases:
    • When the merchant cancels the transaction (CancelOrderReference) within 5 minutes of confirmation (ConfirmOrderReference).
    • When OrderReference is closed within 5 minutes of confirmation of the OrderReference (ConfirmOrderReference).
1

Seller Information is populated with the Store Name:

&OrderReferenceAttributes.SellerOrderAttributes.StoreName

The store name defaults to one specified during registration if this attribute is not set.

Example:

&OrderReferenceAttributes.SellerOrderAttributes.StoreName=CourtAndCherry.de

2

Order Total is set by two parameters:

&OrderReferenceAttributes.OrderTotal.Amount

&OrderReferenceAttributes.OrderTotal.CurrencyCode

Example:

&OrderReferenceAttributes.OrderTotal.Amount=106

&OrderReferenceAttributes.OrderTotal.CurrencyCode=EUR

3

Seller Order ID:

&OrderReferenceAttributes.SellerOrderAttributes.SellerOrderId

Example:

&OrderReferenceAttributes.SellerOrderAttributes.SellerOrderId=5678-23

4

Note from the Seller (shown here as "Lorem Ipsum dolor", although in actuality it would be something like "Your order for Blue Shoes"):

&OrderReferenceAttributes.SellerNote

Example:

&OrderReferenceAttributes.SellerNote=Your%20order%20for%20Blue%20Shoes

Charge notification emails

Charge notification emails show parameters similar to refund notification emails, as shown in the screenshot below:

Note: Although they cannot be overridden by the SetOrderReferenceDetails API call, the Seller Information email address and phone number (shown in the screenshot as "customerservice@courtandcherry.co.uk" and "0800 321 5678" respectively) are specified when you set up your Amazon merchant account or from Seller Central in the Settings section under Account Info.

1

Seller Information is populated with the Store Name:

&OrderReferenceAttributes.SellerOrderAttributes.StoreName

The store name defaults to one specified during registration if this attribute is not set.

Example:

&OrderReferenceAttributes.SellerOrderAttributes.StoreName=CourtAndCherry.de

2

Order Total is set by two parameters:

&OrderReferenceAttributes.OrderTotal.Amount

&OrderReferenceAttributes.OrderTotal.CurrencyCode

Example:

&OrderReferenceAttributes.OrderTotal.Amount=106

&OrderReferenceAttributes.OrderTotal.CurrencyCode=EUR

3

Seller Order ID:

&OrderReferenceAttributes.SellerOrderAttributes.SellerOrderId

Example:

&OrderReferenceAttributes.SellerOrderAttributes.SellerOrderId=5678-23

6

Note from the Seller (shown here as "Lorem Ipsum dolor", though in actuality it would be something like "Payment for Blue Shoes"):

&SellerCaptureNote

Example:

&SellerCaptureNote=Payment%20for%20Blue%20Shoes

7

Total Amount Charged shows in the opening sentence of the email as well as the Total Amount Charged and is set by two parameters:

&CaptureAmount.Amount

&CaptureAmount.CurrencyCode

Example:

&CaptureAmount.Amount=106

&CaptureAmount.CurrencyCode=EUR

Refund notification emails

The screenshot below shows a refund notification email. Note that the Store Name and Seller Order ID come from the Order Reference, and some of the information in the email comes from the call to the refund operation.

Note: Although they cannot be overridden by the SetOrderReferenceDetails API call, the Seller Information email address and phone number (shown in the screenshot as "customerservice@courtandcherry.co.uk" and "0800 321 5678" respectively) are specified when you set up your Amazon merchant account or from Seller Central in the Settings section under Account Info.

1

Seller Information is populated with the Store Name:

&OrderReferenceAttributes.SellerOrderAttributes.StoreName

The store name defaults to one specified during registration if this attribute is not set.

Example:

&OrderReferenceAttributes.SellerOrderAttributes.StoreName=CourtAndCherry.de

3

Seller Order ID:

&OrderReferenceAttributes.SellerOrderAttributes.SellerOrderId

Example:

&OrderReferenceAttributes.SellerOrderAttributes.SellerOrderId=5678-23

6

Note from the Seller (shown here as "Lorem Ipsum dolor", although in actuality it would be something like "Refund for Blue Shoes"):

&SellerRefundNote

Example:

&SellerRefundNote=Refund%20for%20Blue%20Shoes

7

Total Amount Refunded shows in the opening sentence of the email as well as the Total Amount Refunded and is set by two parameters:

&RefundAmount.Amount

&RefundAmount.CurrencyCode

Example:

&RefundAmount.Amount=83.50

&RefundAmount.CurrencyCode=EUR

Payment information updated emails

The payment information updated email parameters are similar to those in the refund notification email, as shown in the screenshot below:

Note: Although they cannot be overridden by the SetOrderReferenceDetails API call, the Seller Information email address and phone number (shown in the screenshot as "customerservice@courtandcherry.co.uk" and "0800 321 5678" respectively) are specified when you set up your Amazon merchant account or from Seller Central in the Settings section under Account Info.

1

Seller Information is populated with the Store Name:

&OrderReferenceAttributes.SellerOrderAttributes.StoreName

The store name defaults to one specified during registration if this attribute is not set.

Example:

&OrderReferenceAttributes.SellerOrderAttributes.StoreName=CourtAndCherry.de

2

Order Total is set by two parameters:

&OrderReferenceAttributes.OrderTotal.Amount

&OrderReferenceAttributes.OrderTotal.CurrencyCode

Example:

&OrderReferenceAttributes.OrderTotal.Amount=106

&OrderReferenceAttributes.OrderTotal.CurrencyCode=EUR

3

Seller Order ID:

&OrderReferenceAttributes.SellerOrderAttributes.SellerOrderId

Example:

&OrderReferenceAttributes.SellerOrderAttributes.SellerOrderId=5678-23

6

Note from the Seller (shown here as "Lorem Ipsum dolor", although in actuality it would be something like "Payment for Blue Shoes"):

&SellerCaptureNote

Example:

&SellerCaptureNote= Payment%20for%20Blue%20Shoes


Copyright © 2009-2017 Amazon.com, Inc. or its affiliates. Amazon and Amazon.com are registered trademarks of Amazon.com, Inc. or its affiliates. All other trademarks are the property of their respective owners.