Vouchers
Help Center
Commerce

Vouchers

Create discount codes like HEMAT10, with a percentage or fixed amount, limits and dates, and apply them to orders in chat, from the dashboard and through the API.

View as Markdown

Commerce → Vouchers holds your discount codes. The AI agent applies a code the customer types in chat, your team applies one when it creates or edits an order, and the API and the MCP server apply it with voucher_code. The agent never suggests a code, so sharing them stays up to you. Asks checks the code's rules and counts each use with the order. Owners and admins create and change vouchers; members can see them.

Commerce → Vouchers with Read more in docs and New voucher at the top, the subtitle that your team, the AI agent and the API can apply the codes, the Search code or description box and the All vouchers filter, and one voucher: HEMAT10 with the description 10% untuk pelanggan baru, a 10% discount with a Rp50.000 maximum, no minimum subtotal, 2 used and 1 per customer, No end date, its switch on with an Active badge, and edit and delete buttons
Your voucher codes, their rules and how often they've been used.

Create a voucher

Open the form

Click New voucher.

Set the code and the discount

Enter the Code: 3 to 30 letters, digits, - or _, such as HEMAT10. Codes aren't case-sensitive: hemat10 is the same voucher. Pick the Discount type:

  • Percentage: Percentage off (1 to 100), with an optional Maximum discount in rupiah.
  • Fixed amount: Amount off in rupiah.

Add a Description if it helps your team, such as 10% off for new customers.

The New voucher dialog: Code HEMAT10, Discount type Percentage selected next to Fixed amount, the description 10% untuk pelanggan baru, Percentage off 10, Maximum discount Rp50.000, an empty Minimum subtotal, empty Starts and Ends date fields with the note that times are in WIB (Asia/Jakarta), Total uses left Unlimited, Uses per customer 1 with the note Counted per customer, the Turned on switch, Cancel and Create voucher
A 10% voucher, capped at Rp50.000, once per customer.
Set the limits

All optional:

  • Minimum subtotal: the items subtotal an order needs before the code applies.
  • Starts and Ends: when the code is valid, in WIB.
  • Total uses and Uses per customer: how many orders can use it, in total and per customer. A per-customer limit needs the customer's phone or email on the order.
Save

Keep Turned on switched on and click Create voucher.

How a voucher applies

  • The discount comes off the items subtotal, on every product. It never covers shipping or tax, and a percentage is rounded down to whole rupiah.
  • A voucher adds to any manual discount on the order; together they can't exceed the subtotal.
  • A use counts when the order is created. It's given back when the order is cancelled or its payment expires unpaid, and counted again if a new payment link is issued for it.
  • In chat, the agent shows the discount in the order summary, or tells the customer why the code doesn't apply. On Create order, type the code in Voucher and click Apply. If it can't be used, the field says why: it doesn't exist, it's turned off, it isn't valid yet or has ended, the subtotal is below the minimum, or it's used up for everyone or for this customer.
  • Editing an unpaid order keeps its voucher and checks the minimum subtotal and limits again; you can remove it or apply another code.
  • The order shows the code and its discount under Voucher & invoice, and the invoice or receipt lists it on the discount line.

Statuses

StatusMeaning
ActiveTurned on and usable now.
ScheduledTurned on, but its start date hasn't come yet.
EndedIts end date has passed.
Used upIt reached its Total uses.
OffTurned off. Switch it back on at any time.

To pause a voucher, turn it off. Delete voucher removes it for good; orders that already used it keep their discount. Voucher codes aren't readable through the API, so you can share them only where you choose.

← Previous
Products
Next →
Payments & settings
Chat on WhatsApp