maton stripe coupon create
maton stripe coupon create [flags]
Create a coupon. Provide one of –percent-off or –amount-off (with –currency). Duration is one of ‘once’, ‘forever’, or ‘repeating’ (with –duration-in-months).
Options
-
--amount-off <string> - Fixed-amount discount in cents (requires --currency)
-
--connection <string> - Connection ID to route through (Maton-Connection header)
-
--currency <string> - Three-letter currency code (required with --amount-off)
-
--dry-run - Print the request that would be sent without executing it
-
--duration <string> - Duration: once, forever, repeating (required)
-
--duration-in-months <string> - Months to apply (required when --duration=repeating)
-
--id <string> - Custom coupon ID (auto-generated if omitted)
-q,--jq <expression>- Filter JSON output using a jq expression
-
--json - Output raw JSON
-
--max-redemptions <string> - Max times the coupon may be redeemed
-
--metadata <stringArray> - Metadata key=value pair (repeatable)
-
--name <string> - Display name (shown to customers)
-
--paginate - Follow next_cursor and concatenate all pages (list commands only)
-
--percent-off <string> - Percentage discount (1-100)
-
--redeem-by <string> - Unix timestamp after which the coupon can no longer be redeemed
-t,--template <string>- Format JSON output using a Go template; see "maton help formatting"
Options inherited from parent commands
-p,--profile <string>- Profile to use for this invocation (overrides the active profile; also reads MATON_PROFILE)
Examples
$ maton stripe coupon create --percent-off 25 --duration once
$ maton stripe coupon create --amount-off 500 --currency usd --duration once --id WELCOME5
$ maton stripe coupon create --percent-off 10 --duration repeating --duration-in-months 3