Mayson Monorepo Documentation
    Preparing search index...

    A coupon contains information about a percent-off or amount-off discount you might want to apply to a customer. Coupons may be applied to subscriptions, invoices, checkout sessions, quotes, and more. Coupons do not work with conventional one-off charges or payment intents.

    interface Coupon {
        id: string;
        object: "coupon";
        amount_off: number;
        applies_to?: Stripe.Coupon.AppliesTo;
        created: number;
        currency: string;
        currency_options?: { [key: string]: Stripe.Coupon.CurrencyOptions };
        deleted?: void;
        duration: Stripe.Coupon.Duration;
        duration_in_months: number;
        livemode: boolean;
        max_redemptions: number;
        metadata: Metadata;
        name: string;
        percent_off: number;
        redeem_by: number;
        times_redeemed: number;
        valid: boolean;
    }
    Index

    Properties

    id: string

    Unique identifier for the object.

    object: "coupon"

    String representing the object's type. Objects of the same type share the same value.

    amount_off: number

    Amount (in the currency specified) that will be taken off the subtotal of any invoices for this customer.

    applies_to?: Stripe.Coupon.AppliesTo
    created: number

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

    currency: string

    If amount_off has been set, the three-letter ISO code for the currency of the amount to take off.

    currency_options?: { [key: string]: Stripe.Coupon.CurrencyOptions }

    Coupons defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.

    deleted?: void

    Always true for a deleted object

    One of forever, once, or repeating. Describes how long a customer who applies this coupon will get the discount.

    duration_in_months: number

    If duration is repeating, the number of months the coupon applies. Null if coupon duration is forever or once.

    livemode: boolean

    Has the value true if the object exists in live mode or the value false if the object exists in test mode.

    max_redemptions: number

    Maximum number of times this coupon can be redeemed, in total, across all customers, before it is no longer valid.

    metadata: Metadata

    Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

    name: string

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

    percent_off: number

    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 $ (or local equivalent)100 invoice $ (or local equivalent)50 instead.

    redeem_by: number

    Date after which the coupon can no longer be redeemed.

    times_redeemed: number

    Number of times this coupon has been applied to a customer.

    valid: boolean

    Taking account of the above properties, whether this coupon can still be applied to a customer.