Skip to content
Nappai Documentation

Stripe Coupon

Stripe Coupon manages the discount coupons in your Stripe account. A coupon can take off a percentage or a fixed amount, and apply once, forever or for several months. From a flow you can create, look up and delete them.

When to use it

  • You want to create a welcome coupon every time a new customer signs up.
  • You launch a campaign and want to generate a coupon with a maximum number of uses.
  • You want to review the coupons you have in Stripe.
  • A promotion has ended and you want to delete its coupon.

Configuration

You need a Stripe API credential with the secret key of your Stripe account. See Credentials.

FieldWhat it does
Credential (required)The Stripe API credential of your account.
Operation (required)The action the component performs. Defaults to Create. See Operations.
Get ModeOnly in Get. By ID looks up one coupon; All returns the list of coupons. Defaults to By ID.
Coupon IDThe coupon’s identifier in Stripe. Required in Get with By ID and in Delete.
NameName of the coupon your customers will see. Only in Create.
DurationHow long the discount applies: once, forever or repeating (several months). Defaults to once. Only in Create.
Duration in MonthsNumber of months the discount applies when Duration is repeating. Defaults to 1. Only in Create.
Percent OffPercentage discount, from 1 to 100. Only in Create.
Amount OffFixed discount in the smallest unit of the currency, for example cents: 500 is 5.00. Used together with Currency. Only in Create.
CurrencyThe currency of the fixed discount, such as eur or usd. Defaults to usd. Only in Create.
Max RedemptionsMaximum number of times the coupon can be used. Only in Create.
Redeem ByDate after which the coupon can no longer be used, as a Unix timestamp (number of seconds). Only in Create.
LimitOnly in Get with All. Maximum number of coupons returned, between 1 and 100. Defaults to 100.

In Create you must fill in Percent Off or Amount Off. If you fill in both, the percentage is used.

Operations

  • Create: creates a new coupon with the given discount and duration.
  • Delete: deletes a coupon so it can no longer be used.
  • Get: with By ID returns one coupon; with All returns the list of coupons.

Output

The Data output returns the coupon that was created, looked up or deleted. With Get and All, it returns one item per coupon. Each item includes the coupon’s identifier, which is what your customers or your flows use to apply it.

You can connect it to an email for the customer or to a spreadsheet where you log your coupons. The component can also be connected to an Agent as a tool, so the agent decides when to use it. See Tool Mode.

Example

An online shop wants to give a 15% discount on the first purchase to every customer who subscribes to the newsletter.

  1. When a new sign-up arrives, add Stripe Coupon with Operation set to Create.
  2. Set Percent Off to 15, Duration to once and Max Redemptions to 1.
  3. In Name, write “Welcome 15%”.
  4. Connect the Data output to a welcome email that includes the coupon’s identifier.