---
title: "Record the marketplace receipt for a charge (internal producers)"
method: POST
path: "/v1/outcomes/charges/{chargeId}/receipts"
---

# Record the marketplace receipt for a charge (internal producers)

`POST /v1/outcomes/charges/{chargeId}/receipts`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/outcomes/charges/{chargeId}/receipts`
- Auth: HTTP bearer

Internal. After billing the charge's outcome dimension on Microsoft or AWS Marketplace, the producer records the one receipt (decionis.outcomes.receipt/1). The identical receipt again answers 200; any other receipt for the same charge is 409 charge_already_billed, so a charge is never billed twice.

## Request body

- OutcomeChargeReceipt
  - `version` 'decionis.outcomes.receipt/1', required
  - `platform` 'microsoft' | 'aws', required
  - `subscription_id` string, required
  - `plan_id` string, required
  - `dimension` string, required
  - `quantity` number, required
  - `unit_minor` integer, required
  - `status` 'ACCEPTED' | 'DUPLICATE' | 'NOTHING_TO_BILL', required
  - `usage_reference` string, nullable, required
  - `reported_at` string, date-time, required

## Response `200`

The identical receipt was already recorded.

- OutcomeChargeReceipt
  - `version` 'decionis.outcomes.receipt/1', required
  - `platform` 'microsoft' | 'aws', required
  - `subscription_id` string, required
  - `plan_id` string, required
  - `dimension` string, required
  - `quantity` number, required
  - `unit_minor` integer, required
  - `status` 'ACCEPTED' | 'DUPLICATE' | 'NOTHING_TO_BILL', required
  - `usage_reference` string, nullable, required
  - `reported_at` string, date-time, required

## Other responses

- `201`: Recorded.
- `400`: Structured API error
- `401`: Structured API error
- `403`: Structured API error
- `404`: Structured API error
- `409`: Structured API error
- `503`: Structured API error

---

[API](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api.md) · [All operations](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/revisions/357f5e459d0c?raw)