---
title: "Coupon"
source_url: https://docs.rapyd.net/en/coupon.html
lang: en
---

# Coupon

Defines a discount on charges to the customer.

The coupon can be applied to the following objects:

- **Subscription** - All charges in the subscription are subject to the discount described in the coupon. To add a coupon to a subscription, first use [Create Coupon](https://docs.rapyd.net/en/create-coupon.md "Create Coupon"). Next, add the coupon ID to the `coupon` field of the subscription with [Create Subscription](https://docs.rapyd.net/en/create-subscription.md "Create Subscription"), [Update Subscription](https://docs.rapyd.net/en/update-subscription.md "Update Subscription"), or [Create Subscription by Hosted Page](https://docs.rapyd.net/en/create-subscription-by-hosted-page.md "Create Subscription by Hosted Page").
- **Customer** - The discount applies to all charges to the customer. To add a coupon to a customer, first use [Create Coupon](https://docs.rapyd.net/en/create-coupon.md "Create Coupon"). Then add the coupon ID to the `coupon` field of the customer with [Create Customer](https://docs.rapyd.net/en/create-customer.md "Create Customer") or [Update Customer](https://docs.rapyd.net/en/update-customer.md "Update Customer").
- **Order** - The discount applies to a single order. To add a coupon to an order, first use [Create Coupon](https://docs.rapyd.net/en/create-coupon.md "Create Coupon"). The `duration` field of the coupon must be set to **repeating**, and the `duration_in_months` and `discount_duration_in_uses` fields must be set to **1**. Then add the coupon ID to the `coupon` field of the order with [Create an Order](https://docs.rapyd.net/en/create-an-order.md "Create an Order") or [Update Order](https://docs.rapyd.net/en/update-an-order.md "Update an Order")

A coupon can be applied to one or more customers or subscriptions. However, a subscription can have only one coupon, and the only way to assign two or more coupons to a customer is to assign them to separate subscriptions.

If there is a coupon for the customer and another coupon for the customer's subscription, the subscription coupon takes precedence.

> **Note:**
>
> - For defining the discount, you must choose either a percentage or a fixed amount.
> - The validity of a discount can extend beyond the validity of the coupon it is based on.

You cannot update a coupon after it is created, except for the client-defined metadata. However, you can switch from one coupon to another when you update a customer or subscription. See [Update Customer](https://docs.rapyd.net/en/update-customer.md "Update Customer") and [Update Subscription](https://docs.rapyd.net/en/update-subscription.md "Update Subscription").

Coupon Methods

- [Create Coupon](https://docs.rapyd.net/en/create-coupon.md "Create Coupon").
- [Update Coupon](https://docs.rapyd.net/en/update-coupon.md "Update Coupon")
- [List Coupons](https://docs.rapyd.net/en/list-coupons.md "List Coupons")
- [Retrieve Coupon](https://docs.rapyd.net/en/retrieve-coupon.md "Retrieve Coupon")
- [Delete Coupon](https://docs.rapyd.net/en/delete-coupon.md "Delete Coupon")

Coupon Error Messages

- [Coupon Errors](https://docs.rapyd.net/en/coupon-errors.md "Coupon Errors")