Amazon Pay and Login with Amazon integration guide

Custom data fields

Custom data fields are available for your use. They can be sent to Amazon in an API call, and they are returned to you via an IPN message. Amazon does not parse the data or attempt to interpret it. As long as the content is syntactically correct (opening and closing tags are spelled the same, no tags are improperly nested, and so on), the content is accepted as-is and is returned to you in the same way.

Because the custom data is not parsed, you don't need to send Amazon an XSD or otherwise define your custom data fields.

The following table lists the available fields and the data types that they're associated with:

Data type

Custom data fields

OrderReferenceAttributes

SellerNote

SellerOrderAttributes

SellerOrderId

StoreName*

CustomInformation

Authorize

AuthorizationReferenceId

SellerAuthorizationNote

SoftDescriptor

Capture

CaptureReferenceId

SellerCaptureNote

SoftDescriptor

Refund

RefundReferenceId

SellerRefundNote

SoftDescriptor

*Note: This value is set during registration when you associate your application with Login with Amazon.

Note that there are restrictions on some of the data fields, and some are required or strongly recommended as they appear in emails to buyers, in buyer accounts, and in merchant transaction reports.

For more information, see Buyer-facing email content that you can provide.


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.