Getting started with reports


Settlement window and reserve policy

After you capture payment, funds are deposited into your Amazon Pay account, and these funds will be automatically disbursed to your bank account on the next scheduled settlement date. Generally, Amazon Pay settles your account 14 days after the first payment transaction is completed. After the initial 14-day holding period, your account is settled daily. For more information, see Getting paid.

Additionally, Amazon Pay will withhold a minimum balance in your account to secure payment obligations that may arise after delivery, such as refunds or A-to-z Guarantee claims. We call this minimum balance a reserve. For more information, see Amazon Pay reserve policy.


Report types

Amazon Pay provides two types of reports to help support your business processes: settlement reports and transaction reports.

Settlement reports - A settlement report provides a detailed breakdown of your Seller (also called Merchant) account activity, and the funds disbursed to you, for a given settlement period. You can use this report to support your reconciliation processes.

Visit Amazon Pay Settlement Reports for details.

Transaction reports - A transaction report provides a list of Amazon objects, that were either created or updated, because of a state change during the reporting period. You can use this report to synchronize the status of payment objects with your system, or perform business analysis, such as: determining refund rates, authorization declines, and other info.

Visit Amazon Pay Transaction Reports for details.

Migrating

If you are already consuming Amazon Pay reports via the Marketplace Webservices (MWS) Reports API, please follow our migration guide. The report content is the same for both APIs.

Important note about report contents

Some field names in the reports differ slightly from the API objects, themselves. The terms "seller" and "merchant" are used interchangeably, and other key differences are listed below:

In Settlement reports:

  • "AmazonTransactionId" refers to the chargeId of Charge objects created using one-time Charge Permissions. This will not match the chargeId of Charge objects created using recurring Charge Permissions.
  • "AmazonOrderReferenceId" refers to the chargePermissionId of your Charge Permission objects
  • "SellerOrderId" refers to the merchantReferenceId of your Charge Permission objects

In Transaction reports:

  • "Order Reference" reports contain details about your Charge Permission objects
    • "AmazonOrderReferenceID" refers to the chargePermissionId of your Charge Permission objects
    • "SellerOrderId" refers to the merchantReferenceId of your Charge Permission objects
    • "OrderReferenceStatus" is the state of your Charge Permission objects. It uses the following mapping:
      • "Open" = "Chargeable"
      • "Suspended" = "NonChargeable"
      • "Cancelled" and "Closed" = "Closed"
    • "ReasonCode" and "ReasonDescription" describes the Charge Permission object state. Note the following mapping for "ReasonCode":
      • "SellerClosed" = "MerchantClosed"
  • "Authorization" reports contain details about authorizations for your Charge objects
    • "AmazonAuthorizationID" refers to an internal Amazon ID
    • "AuthorizationStatus" is the state of authorizations for your Charge objects. It uses the following mapping:
      • "Pending" = "AuthorizationInitiated"
      • "Open" = "Authorized"
      • "Declined" = "Declined"
      • "Closed" (reason code = "MaxAmountCaptured") = "Captured"
      • "Closed" (all other reason code) = "Canceled"
    • "ReasonCode" and "ReasonDescription" describes the Charge Permission object state. Note the following mapping for "ReasonCode":
      • "SellerClosed" = "MerchantClosed"
  • The "Capture" reports contain details about captures for your Charge objects
    • "AmazonCaptureID" refers to the chargeId of your Charge objects
    • "CaptureStatus" is the state of captures for your Charge objects. It uses the following mapping:
      • "Pending" = "CaptureInitiated"
      • "Completed" = "Captured"
      • "Declined" = "Declined"
      • "Closed" = "Canceled"
    • "ReasonCode" and "ReasonDescription" describes the Charge object state. Note the following mapping for "ReasonCode":
      • "SellerClosed" = "MerchantCanceled"
  • The "Refund" reports contain details about your Refund objects
    • "AmazonRefundId" refers to the refundId of your Refund objects
    • "RefundStatus" is the state of your Refund objects. It uses the following mapping:
      • "Pending" = "RefundInitiated"
      • "Completed" = "Refunded"
      • "Declined" = "Declined"