Coupons & First-Payment Bonus

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. Credited amounts must be used within 30 days of the grant date.

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

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.

plan_id and months identify the activated subscription, subscription_end is the new term end, and amount_krw is the credit added by the redemption, which is 0 for subscription coupons.

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

First-payment reward#

Separately from coupons, a first-payment reward is granted automatically when you complete your first top-up (no API). It pays 10% of your topped-up credit (capped at 5,000 credits) and is non-cash, excluded from your refundable balance. Reward credit must be used within 30 days of the grant date.

First-payment reward: 10% of your topped-up credit (capped at 5,000 credits) — granted on your first completed top-up, provided the same physical card hasn't already earned it.