Coupons & Action Rewards

There are two kinds of coupon. A credit coupon adds credit to your balance the moment you redeem it. A subscription_months coupon extends an active subscription term or starts a payment-free subscription. Both kinds share one redeem endpoint and 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>"

kind is the coupon type, amount_krw is the credited amount and balance_krw is your total balance after crediting.

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

Subscription-months coupons#

A subscription-months coupon locks its plan and months at issue time. When redeemed, it extends an active personal subscription by n months (no billing occurs during the extended term) or creates a payment-free subscription — one that never charges a card and is canceled automatically when the term ends. The subscription credit grant (monthly plan grant × months) is credited up front and expires when the term ends.

plan_id and months identify the activated subscription, subscription_end is the new term end, and amount_krw is the credit granted immediately.

{
  "kind": "subscription_months",
  "amount_krw": 30000,
  "balance_krw": 40000,
  "plan_id": "personal_19900",
  "months": 3,
  "subscription_end": "2026-12-01T09:00:00+00:00"
}

Action rewards#

Separately from coupons, four action rewards are granted automatically as you complete each action (no API). Sign-up, identity verification and the first API call pay fixed amounts, and the first payment pays 10% of your topped-up credit (capped at 5,000 credits). 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 500 credits — granted on your first successful API call with an issued key.

First-payment reward: 10% of your topped-up credit (capped at 5,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.