Attributes

Attribute

Description

id int

Unique identifier for the object.

name string

Name of the coupon displayed to customers on for instance invoices or receipts.

code string

The code the customer can redeem the coupon with.

percent_off float

Percent that will be taken off the subtotal of any invoices for this customer for the duration of the coupon. For example, a coupon with percent_off of 50 will make a $100 invoice $50 instead.

duration string

Can either be forever, or once. Describes how long a customer who applies this coupon will get the discount.

redeem_by timestamp

Date of the last day this coupon can be used.

max_redemptions int

The maximum number of times the coupon can be redeemed.

plans array

An array of plan IDs that are associated to this coupon. An attempt to create a subscription with a plan that is not part of the associated coupons with the plan will fail.

created_at timestamp

Time at which the object was created. Measured in seconds since the Unix epoch.

updated_at timestamp

Time at which the object was last updated. Measured in seconds since the Unix epoch.