Coupons & First-Payment Bonus

쿠폰으로 크레딧을 증정받거나 구독권을 등록하고, 첫 결제 보너스로 크레딧을 받습니다.

쿠폰은 두 종류입니다. credit 쿠폰은 사용 즉시 잔액에 크레딧이 적립됩니다. subscription_months 쿠폰(구독권 n개월)은 활성 구독이 있으면 기간을 연장하고, 없으면 결제 없는 구독을 시작합니다. 두 종류 모두 같은 등록 엔드포인트를 쓰며 로그인 세션(JWT)이 필요합니다.

credit 쿠폰 사용#

POST/v1/coupons/{code}/redeem

쿠폰 코드를 경로 파라미터로 전달합니다. 본문은 비워 둡니다. 적립된 크레딧은 비현금성이며 환불 가능 잔액에서 제외됩니다.

파라미터	타입	필수	설명
code	string (path)	필수	쿠폰 코드. 경로에 직접 넣습니다 — 요청 본문은 없습니다.

redeem

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

kind는 쿠폰 종류, amount_krw는 적립된 금액, balance_krw는 적립 후 총 잔액입니다.

200 OK (credit)

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

과거의 fee_discount(수수료 할인) 쿠폰과 /fee-preview 엔드포인트는 2026-08-31에 폐지됐습니다. 보유한 수수료 쿠폰은 더 이상 사용할 수 없습니다.

구독권 n개월 쿠폰#

구독권 쿠폰은 발급 시점에 플랜과 개월이 고정됩니다. 등록하면 활성 개인 구독이 있을 때 그 기간을 n개월 연장하고(연장 구간에는 정기결제가 일어나지 않습니다), 없으면 결제 없는 구독이 생성됩니다 — 이 구독은 기간이 끝나면 자동으로 해지되며 카드를 요구하지 않습니다. 구독 크레딧 지급분(플랜별 월 지급액 × 개월)은 한 번에 적립되며 구독 기간이 끝나면 소멸됩니다.

plan_id·months는 등록된 구독권의 플랜과 개월, subscription_end는 새 구독 기간의 종료 시각, amount_krw는 즉시 지급된 크레딧입니다.

200 OK (subscription_months)

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

첫 결제 보상#

쿠폰과 별개로, 첫 결제 보상이 첫 충전 완료 시 자동으로 지급됩니다(API 없음). 금액은 충전 크레딧의 10%(최대 5,000 크레딧)이며 비현금성이라 환불 가능 잔액에서 제외됩니다.

첫 결제 보상: 충전 크레딧의 10%(최대 5,000 크레딧) — 첫 충전이 완료되면 지급됩니다. 단, 계정이 기업이 아니고, 동일한 실물 카드가 아직 이 보상을 받은 적이 없어야 합니다.

보상은 환불 시 가장 먼저 차감되며, 비현금성이라 직접 현금으로 환불되지 않습니다.