Coupons & Welcome Bonuses

쿠폰은 두 종류입니다. credit 쿠폰은 사용 즉시 잔액에 크레딧이 적립됩니다. fee_discount 쿠폰은 잔액을 늘리지 않고, 충전 시점에 적용해 충전 수수료를 할인합니다. 두 종류 모두 사용에는 로그인 세션(JWT)이 필요합니다.

credit 쿠폰 사용#

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

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

amount_krw는 적립된 금액, balance_krw는 적립 후 총 잔액입니다.

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

fee_discount 쿠폰 미리보기#

충전 전에 fee_discount 쿠폰을 소진하지 않고 검증합니다. 쿠폰 코드를 경로 파라미터로 전달합니다.

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

valid가 true이면 discount_percent가 적용 가능한 할인율입니다. 사용할 수 없으면 valid가 false가 되고 reason에 사유가 담깁니다.

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

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

실제로 할인을 적용하려면 충전/결제 요청에 쿠폰 코드를 fee_coupon_code로 전달하세요. 충전 수수료가 그만큼 할인됩니다.

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

웰컴 보너스#

쿠폰과 별개로, 두 가지 웰컴 보너스가 자동으로 지급됩니다(API 없음). 두 보너스 모두 비현금성이며 환불 가능 잔액에서 제외됩니다.

가입 보너스 1,000 PLM — 신규 개인 계정이 소셜 계정을 연동하면 신원당 1회 지급됩니다.

첫 결제 보너스 5,000 PLM — 첫 충전이 완료되면 지급됩니다. 단, 계정이 기업이 아니고, 소셜 계정이 연동되어 있으며, 동일한 실물 카드가 아직 이 보너스를 받은 적이 없어야 합니다.