> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexprice.io/llms.txt
> Use this file to discover all available pages before exploring further.

# AWS Marketplace Usage Reporting

> What Flexprice meters to AWS Marketplace and when it reports

## Overview

Once a buyer's agreement is registered, usage reporting runs automatically. You do not call Flexprice again for that buyer unless their subscription changes.

Flexprice computes each mapped subscription's usage for the elapsed period and reports it against your product's single usage dimension. AWS then invoices the buyer and pays you out.

## What Flexprice Meters to AWS

The amount reported to AWS is the same billable amount that appears on that subscription's Flexprice invoice for the same period. It is computed with the same rules, so AWS bills what Flexprice bills.

That means the reported amount already accounts for:

* **Usage-based charges** across every meter on the subscription
* **Commitment amounts**, where the subscription has a committed spend
* **Overage rates**, where usage exceeds the commitment

The amount is reported in cents against your single usage dimension. With the dimension priced at `$0.01` per unit, AWS multiplies it back into the exact amount, down to the cent. See [Create Your AWS Marketplace Listing](/integrations/marketplace-integration/aws/connection-setup#step-1-create-your-aws-marketplace-listing).

## Reporting Cadence

<Note>
  Flexprice reports usage to AWS on a recurring schedule, approximately every 6 hours, not in real time. Do not expect usage to appear in AWS immediately after it happens in Flexprice.
</Note>

### Where Usage Appears in AWS

Reported usage shows up against your product on the buyer's AWS bill, under the **AWS Marketplace** service provider. Use this to confirm usage is reaching AWS.

<Frame>
  <img src="https://mintcdn.com/flexprice/tPI6omBujNd_JL9R/images/docs/marketplace/aws/bills.png?fit=max&auto=format&n=tPI6omBujNd_JL9R&q=85&s=1b3a15673ba6548692d52b81352878ab" alt="AWS bill showing Marketplace charges" width="2812" height="1064" data-path="images/docs/marketplace/aws/bills.png" />
</Frame>

## Retries and Failures

Reporting recovers from transient failures on its own.

* **Reports are safe to retry.** Each report carries a fixed timestamp, so a retry is an identical request and AWS de-duplicates it rather than billing twice.
* **Unaccepted reports are retried.** If AWS does not accept a report, it stays unreported and is retried on the next run. No action is needed from you.
* **A rejected buyer resolves itself.** If AWS reports the buyer has no active agreement, reporting keeps retrying and succeeds once the buyer's agreement is active again.

## Handling Marketplace Lifecycle Events

Flexprice does not learn about AWS-side changes to a buyer's subscription. You handle these.

| Event on AWS                             | What you must do in Flexprice                                      |
| ---------------------------------------- | ------------------------------------------------------------------ |
| Buyer cancels or unsubscribes            | Cancel or end the buyer's Flexprice subscription                   |
| Buyer's agreement expires                | Cancel or end the buyer's Flexprice subscription                   |
| Buyer re-subscribes with a new agreement | Create a new Flexprice subscription and register the new agreement |

<Warning>
  If a buyer cancels on AWS and you leave their Flexprice subscription active, Flexprice keeps computing usage for it and attempting to report it to AWS. Cancel the Flexprice subscription to stop this.
</Warning>

To detect these events, subscribe to your product's AWS SNS topics in your own application. Flexprice does not subscribe to them.

## Troubleshooting

| Symptom                                  | Likely cause                                    | Fix                                                                                                                            |
| ---------------------------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| No usage in AWS at all                   | Agreement never registered                      | Confirm registration succeeded, see [Agreement Registration](/integrations/marketplace-integration/aws/agreement-registration) |
| No usage in AWS for one buyer            | Subscription is not in USD                      | Move the buyer to a USD-denominated plan                                                                                       |
| Usage appears late                       | Expected: reporting is scheduled, not real time | None, see [Reporting Cadence](#reporting-cadence)                                                                              |
| AWS bills the wrong amount               | Dimension not priced at `$0.01` per unit        | Correct the dimension price on your AWS product                                                                                |
| Usage still reporting after cancellation | Flexprice subscription still active             | Cancel the Flexprice subscription                                                                                              |

## Next Steps

<CardGroup cols={2}>
  <Card icon="plug" href="/integrations/marketplace-integration/aws/connection-setup" title="Connection Setup">
    Set up your AWS listing, IAM role, and Flexprice connection.
  </Card>

  <Card icon="link" href="/integrations/marketplace-integration/aws/agreement-registration" title="Agreement Registration">
    Link each buyer's AWS agreement to a Flexprice subscription.
  </Card>
</CardGroup>