Coupons

A coupon is a code buyers type at payment to get a discount: LANCAMENTO20, BEMVINDO10, ALUNO2026. It's for launches, partnerships, campaigns, and winning back people who gave up.

#What it's for

#How it works

#Types

#Duration (for subscriptions)

On a product sold once, the duration makes no difference: there's only one charge.

#Limits

Through the API, a coupon also takes: a minimum order amount, a maximum discount, first purchase in the community only, subscriptions only, one-time products only, excluded products, and whether it can be combined with another coupon.

#How the discount works at payment

1. At checkout, the buyer clicks I have a coupon, types the code and clicks Apply. The screen shows "Coupon LANCAMENTO20 applied · −R$ 25.80" and the duration ("Discount on the first charge only.").
2. The discount is calculated before the fee: the platform fee applies to the amount after the discount.
3. On an order with a plan and add-ons, a fixed-amount coupon is taken once off the order, split across the items in proportion to each one's amount; a percentage applies equally to each item it covers.
4. No item can go below R$ 1.00 after the discount.
5. The use is recorded when the payment is confirmed. An open order (an unpaid boleto, for example) holds a use for up to 7 days.
6. On renewals, forever and repeating coupons keep applying for the agreed time.
7. With a downsell, the downsell discount comes first, then the coupon's.

The Free Trial type isn't accepted at payment ("This type of coupon cannot be used at checkout").

#Status

The list shows each coupon with its uses, validity and status:

#Who can

Create, edit, pause and delete: owner and admin. Finance sees the coupons and their usage history.

#Step by step: create a coupon

Role: owner or admin.

1. Monetization › Coupons › Create Coupon.
2. Code *: what the customer types (e.g. LANCAMENTO20). Unique within the community.
3. Name *: for the staff (e.g. March launch — 20%).
4. Type * and Discount Value *.
5. Duration *: once, forever or repeating (with the Months).
6. Start Date * and, if you want, End Date.
7. Maximum Uses and Maximum per User, if you want to limit it.
8. Under Applicable Products, tick where it applies, or leave it empty to apply everywhere.
9. Create.

To pause it, change the status to Inactive. Deleting a coupon that has been used affects reports: the screen tells you how many times it was used.

#Examples with numbers

The platform fee is 6.99% + R$ 2.49 on the amount charged, after the discount.

LANCAMENTO20: 20% once, on Growth Monthly (R$ 129). First monthly payment: R$ 129.00 − R$ 25.80 = R$ 103.20. Fee: R$ 7.21 + R$ 2.49 = R$ 9.70. The community keeps R$ 93.50. From the second payment on, R$ 129.00.

ANUAL10: 10% forever, on Student Monthly (R$ 49). Every month: R$ 44.10. Fee: R$ 3.08 + R$ 2.49 = R$ 5.57. The community keeps R$ 38.53 a month, for as long as the subscription lasts.

PARCEIRO30: R$ 30 repeating for 3 months, on Resident (R$ 890). Months 1 to 3: R$ 860.00. From month 4 on: R$ 890.00.

A R$ 50 fixed amount on a plan + add-on order (R$ 129 + R$ 450 = R$ 579). The discount is R$ 50 on the order, split proportionally: R$ 11.14 on the plan and R$ 38.86 on the add-on. Total: R$ 529.00.

A R$ 100 fixed amount on a R$ 49 plan. Refused: the item would go below R$ 1.00.

#Good practices

• One code per campaign. INSTAGRAM20 and NEWSLETTER20 with the same discount show where each sale came from, in the Uses column.
• Always set an end date on campaigns: a forgotten coupon becomes a permanent discount.
• Maximum Uses on partnerships, so a leaked code doesn't become the rule.
• Prefer "once" or "repeating" to "forever": "forever" reduces every renewal for as long as the person stays.
• Test before you promote it: apply the code at checkout with a member account and check the total.

#Messages buyers can see

#Common errors when creating

#Frequently asked questions

Does the coupon apply on renewal? Forever and repeating coupons do, for the agreed time. Once coupons apply only to the first charge.

Can two coupons be used? Only if both can be combined. By default, one coupon per order.

Does the coupon reduce the platform fee? The fee is calculated on the discounted amount: a lower price also means a lower fee in reais.

Can a member use a coupon when adding an extension later, from the Billing page? Not for now; coupons apply when buying the plan and on the last-chance offer.

How do I know how many times a coupon was used? In the Uses column of the list, and in the coupon's usage history.

#In the API

POST /api/coupons, PUT .../coupons/{id}, PATCH .../coupons/{id}/status, GET .../coupons/{id}/usage and POST .../coupons/validate (code, productId, amount). At checkout, couponCode in POST /api/checkout/calculate-price and in POST /api/checkout. See Coupons.

#Related

• Downsell
• Checkout
• Platform fee