---
updatedAt: 2026-01-27T20:34:29.000Z
agentTools:
  siteIndex: https://docs.affirm.com/llms.txt
  projectIndex: https://docs.affirm.com/developers/llms.txt
---

# The Discount Object

## Attributes

| Attribute                                                                  | Data type | Description                                                                                                                                                                                                                                                         |
| :------------------------------------------------------------------------- | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **discount\_code**                                                         | *string*  | The name of your discount code is the name of the object that describes the amount and display name for that discount. For example, `RETURN5` is the name of the discount code, so it is represented here as the name of the first discount in the discount object. |
| **discount\_amount** <span style={{ color: "red" }}>required</span>        | *integer* | Amount of the discount being applied in USD or CAD cents. This value is not used to calculate the total.                                                                                                                                                            |
| **discount\_display\_name** <span style={{ color: "red" }}>required</span> | *string*  | Friendly name of the discount being applied.                                                                                                                                                                                                                        |

<div class="rdmd-pinned">
  ```json
  "discounts":{
        "RETURN5":{
           "discount_amount":500,
           "discount_display_name":"Returning customer 5% discount"
        },
        "PRESDAY10":{
           "discount_amount":1000,
           "discount_display_name":"President's Day 10% off"
        }
     }
  ```
</div>

# Sibling pages

* [The Merchant Object](https://docs.affirm.com/developers/reference/the-merchant-object.md)
* [The Metadata Object](https://docs.affirm.com/developers/reference/the-metadata-object.md)
* [The Store Object](https://docs.affirm.com/developers/reference/the-store-object.md)
* [The Item Object](https://docs.affirm.com/developers/reference/the-item-object.md)
* [The Itinerary Object](https://docs.affirm.com/developers/reference/the-itinerary-object.md)
* [Shipping & Billing Objects](https://docs.affirm.com/developers/reference/shipping-billing-object.md)
* [Name Object](https://docs.affirm.com/developers/reference/name.md)
* [Address Object](https://docs.affirm.com/developers/reference/address.md)