You are viewing the documentation for the older version of our API (V1). Click here for information on upgrading to the latest version (V2).
    Library
You are viewing the documentation for the older version of our API (V1). Click here for information on upgrading to the latest version (V2).

Coupon codes

Coupon codes are used along with existing coupons in Chargebee. You can create a coupon set using a bunch of coupon codes and this coupon set will be associated with an existing coupon. A coupon code can only be applied to a single subscription and cannot be re-used.

Using coupon codes you can distribute several unique codes for a single main coupon, when you are running promotions.

Sample coupon code [ JSON ]

{ "code": "CBCCN345", "coupon_id": "alpha1", "coupon_set_name": "Welcome Offer", "object": "coupon_code" }

Coupon code attributes

code
string, max chars=50
Unique coupon code that can be redeemed only once.
coupon_id
string, max chars=100
Id of the main coupon resource.
coupon_set_name
string, max chars=50
Coupon set name to which this coupon code would be grouped under. If the coupon set with the passed name is not present, a new coupon set will be created.

Create a coupon code for a coupon

Idempotency Supported
Create a new coupon code and associate it to an existing main coupon resource.
Sample Request 
curl  https://{site}.chargebee.com/api/v1/coupon_codes \
     -u {site_api_key}:\
     -d coupon_id="alpha1" \
     -d coupon_set_name="Welcome Offer" \
     -d code="CBCCN345"
copy
curl  https://{site}.chargebee.com/api/v1/coupon_codes \
     -u {site_api_key}:\
     -d coupon_id="alpha1" \
     -d coupon_set_name="Welcome Offer" \
     -d code="CBCCN345"

Sample Response [ JSON ]

Show more...
{"coupon_code": { "code": "CBCCN345", "coupon_id": "alpha1", "coupon_set_name": "Welcome Offer", "object": "coupon_code" }}

URL Format POST

https://{site}.chargebee.com/api/v1/coupon_codes

Input Parameters

coupon_id
required, string, max chars=100
Id of the main coupon resource.
coupon_set_name
required, string, max chars=50
Coupon set name to which this coupon code would be grouped under. If the coupon set with the passed name is not present, a new coupon set will be created.
code
required, string, max chars=50
Unique coupon code that can be redeemed only once.

Returns

coupon_code
always returned
Resource object representing coupon_code

Retrieve a coupon code

Retrieves a specific coupon code details.
Sample Request 
curl  https://{site}.chargebee.com/api/v1/coupon_codes/CBC978B \
     -u {site_api_key}:
copy
curl  https://{site}.chargebee.com/api/v1/coupon_codes/CBC978B \
     -u {site_api_key}:

Sample Response [ JSON ]

Show more...
{"coupon_code": { "code": "CBC978B", "coupon_id": "alpha", "coupon_set_name": "Offer", "object": "coupon_code" }}

URL Format GET

https://{site}.chargebee.com/api/v1/coupon_codes/{coupon_code_code}

Returns

coupon_code
always returned
Resource object representing coupon_code