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.