Coupons & Action Rewards

There are two kinds of coupon. A credit coupon adds credit to your balance the moment you redeem it. A fee_discount coupon does not add balance — you apply it at checkout to discount your top-up fee. Both kinds require a logged-in session (JWT).

Redeem a credit coupon#

Pass the coupon code as a path parameter; the body is empty. Redeemed credit is non-cash and is excluded from your refundable balance.

curl -X POST https://apirouter.pleum.ai/v1/coupons/WELCOME5000/redeem \
  -H "Authorization: Bearer <SESSION_JWT>"

amount_krw is the credited amount and balance_krw is your total balance after crediting.

{
  "amount_krw": 5000,
  "balance_krw": 12500
}

Preview a fee-discount coupon#

Validates a fee_discount coupon without consuming it before you top up. Pass the coupon code as a path parameter.

curl -X POST https://apirouter.pleum.ai/v1/coupons/HALFFEE/fee-preview \
  -H "Authorization: Bearer <SESSION_JWT>"

When valid is true, discount_percent is the discount you can apply. If it cannot be used, valid is false and reason explains why.

{
  "valid": true,
  "discount_percent": 50,
  "reason": null
}

{
  "valid": false,
  "discount_percent": 0,
  "reason": "expired"
}

To actually apply the discount, pass the coupon code as fee_coupon_code in your top-up/checkout request. The top-up fee is discounted accordingly.

{
  "amount_krw": 50000,
  "fee_coupon_code": "HALFFEE"
}

Action rewards#

Separately from coupons, five action rewards are granted automatically as you complete each action (no API). The total is capped at 5,000 credits, and all of them are non-cash and excluded from your refundable balance.

Signup reward 500 credits — granted once per identity when you verify your email and complete sign-up.

Identity verification reward 500 credits — granted once per identity when a personal account links a social account, or a business account completes verification.

First API call reward 1,000 credits — granted on your first successful API call with an issued key.

First-payment reward 2,000 credits— granted on your first completed top-up, provided the account is non-business, has a linked social account, and the same physical card hasn't already earned it.

Onboarding completion reward 1,000 credits — granted on top when you finish all the actions above within 30 days of signing up.