---
title: Getting started with reports
url: amazon-pay-reports/getting-started.html
---

<!-- prettier-ignore-start -->
* TOC
{:toc}
{::options toc_levels="3" /}

***
<!-- prettier-ignore-end -->

### 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 <a href="https://pay.amazon.com/help/201212470" target="_blank" rel="noopener noreferrer">Getting paid</a>.

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 <a href="https://pay.amazon.com/help/201212470" target="_blank" rel="noopener noreferrer">Amazon Pay reserve policy</a>.

---

### 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](../amazon-pay-reports/settlement-reports.html) 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](../amazon-pay-reports/transaction-reports.html) for details.

### Migrating

If you are already consuming Amazon Pay reports via the Marketplace Webservices (MWS) Reports API, please follow our [migration guide](./migrate-from-mws.html). 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"