StripeAPI.Types.Coupon

Contains the types generated from the schema Coupon

Documentation

data Coupon

Defines the data type for the schema coupon

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 invoices or orders. Coupons do not work with conventional one-off charges.

Constructors

Coupon

Fields

• couponAmountOff :: Maybe Integer

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

• couponCreated :: Integer

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

• couponCurrency :: Maybe Text

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

• couponDuration :: CouponDuration'

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

• couponDurationInMonths :: Maybe Integer

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

• couponId :: Text

  id: Unique identifier for the object.

  Constraints:

  • Maximum length of 5000
• couponLivemode :: Bool

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

• couponMaxRedemptions :: Maybe Integer

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

• couponMetadata :: CouponMetadata'

  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.

• couponName :: Maybe Text

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

  Constraints:

  • Maximum length of 5000
• couponObject :: CouponObject'

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

• couponPercentOff :: Maybe Double

  percent_off: 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 %s100 invoice %s50 instead.

• couponRedeemBy :: Maybe Integer

  redeem_by: Date after which the coupon can no longer be redeemed.

• couponTimesRedeemed :: Integer

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

• couponValid :: Bool

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

Instances

Eq Coupon

Defined in StripeAPI.Types.Coupon

Methods

(==) :: Coupon -> Coupon -> Bool

(/=) :: Coupon -> Coupon -> Bool

Show Coupon

Defined in StripeAPI.Types.Coupon

Methods

showsPrec :: Int -> Coupon -> ShowS

show :: Coupon -> String

showList :: [Coupon] -> ShowS

ToJSON Coupon

Defined in StripeAPI.Types.Coupon

Methods

toJSON :: Coupon -> Value

toEncoding :: Coupon -> Encoding

toJSONList :: [Coupon] -> Value

toEncodingList :: [Coupon] -> Encoding

FromJSON Coupon

Defined in StripeAPI.Types.Coupon

Methods

parseJSON :: Value -> Parser Coupon

parseJSONList :: Value -> Parser [Coupon]

data CouponDuration'

Defines the enum schema couponDuration'

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

Constructors

CouponDuration'EnumOther Value

CouponDuration'EnumTyped Text

CouponDuration'EnumStringForever

CouponDuration'EnumStringOnce

CouponDuration'EnumStringRepeating

Instances

Eq CouponDuration'

Defined in StripeAPI.Types.Coupon

Methods

(==) :: CouponDuration' -> CouponDuration' -> Bool

(/=) :: CouponDuration' -> CouponDuration' -> Bool

Show CouponDuration'

Defined in StripeAPI.Types.Coupon

Methods

showsPrec :: Int -> CouponDuration' -> ShowS

show :: CouponDuration' -> String

showList :: [CouponDuration'] -> ShowS

ToJSON CouponDuration'

Defined in StripeAPI.Types.Coupon

Methods

toJSON :: CouponDuration' -> Value

toEncoding :: CouponDuration' -> Encoding

toJSONList :: [CouponDuration'] -> Value

toEncodingList :: [CouponDuration'] -> Encoding

FromJSON CouponDuration'

Defined in StripeAPI.Types.Coupon

Methods

parseJSON :: Value -> Parser CouponDuration'

parseJSONList :: Value -> Parser [CouponDuration']

data CouponMetadata'

Defines the data type for the schema couponMetadata'

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.

Constructors

CouponMetadata'

Instances

Eq CouponMetadata'

Defined in StripeAPI.Types.Coupon

Methods

(==) :: CouponMetadata' -> CouponMetadata' -> Bool

(/=) :: CouponMetadata' -> CouponMetadata' -> Bool

Show CouponMetadata'

Defined in StripeAPI.Types.Coupon

Methods

showsPrec :: Int -> CouponMetadata' -> ShowS

show :: CouponMetadata' -> String

showList :: [CouponMetadata'] -> ShowS

ToJSON CouponMetadata'

Defined in StripeAPI.Types.Coupon

Methods

toJSON :: CouponMetadata' -> Value

toEncoding :: CouponMetadata' -> Encoding

toJSONList :: [CouponMetadata'] -> Value

toEncodingList :: [CouponMetadata'] -> Encoding

FromJSON CouponMetadata'

Defined in StripeAPI.Types.Coupon

Methods

parseJSON :: Value -> Parser CouponMetadata'

parseJSONList :: Value -> Parser [CouponMetadata']

data CouponObject'

Defines the enum schema couponObject'

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

Constructors

CouponObject'EnumOther Value

CouponObject'EnumTyped Text

CouponObject'EnumStringCoupon

Instances

Eq CouponObject'

Defined in StripeAPI.Types.Coupon

Methods

(==) :: CouponObject' -> CouponObject' -> Bool

(/=) :: CouponObject' -> CouponObject' -> Bool

Show CouponObject'

Defined in StripeAPI.Types.Coupon

Methods

showsPrec :: Int -> CouponObject' -> ShowS

show :: CouponObject' -> String

showList :: [CouponObject'] -> ShowS

ToJSON CouponObject'

Defined in StripeAPI.Types.Coupon

Methods

toJSON :: CouponObject' -> Value

toEncoding :: CouponObject' -> Encoding

toJSONList :: [CouponObject'] -> Value

toEncodingList :: [CouponObject'] -> Encoding

FromJSON CouponObject'

Defined in StripeAPI.Types.Coupon

Methods

parseJSON :: Value -> Parser CouponObject'

parseJSONList :: Value -> Parser [CouponObject']