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
Chargeback AmazonChargebackId

ChargebackAmount

ChargebackStatus

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