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

# Receipt

A **Receipt** is a record of entitlements generated by Monime whenever a payment completes successfully.\
It serves as proof of what the customer is entitled to claim — such as tickets, vouchers, credits, or digital rights.\
Receipt links a **payment** via an order to **entitlement claims**, enabling both verification and controlled redemption via APIs.

### Use Cases

* **Purchase Verification**\
  Confirm that a customer’s payment went through and display transaction details in your app without manual reconciliation.

* **Ticket & Voucher Redemption**\
  Use receipts as redeemable proof of access — for example, scanning a receipt at an event gate or validating a voucher at checkout.

* **Partial Consumption**\
  Support use cases where receipts hold multiple entitlements, such as ride credits or digital assets, and allow them to be redeemed incrementally.

<ResponseExample>
  ```json JSON Model theme={null}
  {
      "status": "not_redeemed",
      "orderName": null,
      "orderNumber": null,
      "orderAmount": {
          "currency": null,
          "value": null
      },
      "createTime": null,
      "updateTime": null,
      "entitlements": [],
      "metadata": null
  }
  ```
</ResponseExample>

<ResponseField name="📋" type="Properties">
  <ResponseField name="status" type="enum<string>">
    Lifecycle status of the receipt.

    Available options: <code>not\_redeemed</code> <code>partially\_redeemed</code> <code>fully\_redeemed</code>
  </ResponseField>

  <ResponseField name="orderName" type="string">
    Human friendly name of the order.
  </ResponseField>

  <ResponseField name="orderNumber" type="string">
    Human-friendly order number.
  </ResponseField>

  <ResponseField name="orderAmount" type="object">
    Total order amount in minor units and currency.

    <Expandable title="properties">
      <ResponseField name="currency" type="string">
        The [3-letter](https://en.wikipedia.org/wiki/ISO_4217) ISO currency code. Currently supported: 'SLE', 'USD'
      </ResponseField>

      <ResponseField name="value" type="integer">
        The value representation in the currency's minor unit. E.g. For 1 Leone (SLE 1), the value should be 100, denoting cents, the minor unit.
      </ResponseField>
    </Expandable>
  </ResponseField>

  <ResponseField name="createTime" type="string">
    The timestamp when the receipt was created.
  </ResponseField>

  <ResponseField name="updateTime" type="string">
    The last timestamp when the receipt was updated.
  </ResponseField>

  <ResponseField name="entitlements" type="array">
    Entitlements granted by this receipt; each can be redeemed until exhausted.
  </ResponseField>

  <ResponseField name="metadata" type="object">
    Optional metadata for attaching context or tracking info.
  </ResponseField>
</ResponseField>