Coupons & Action Rewards

クーポンは2種類あります。credit クーポンは使用した瞬間に残高へクレジットが 加算されます。subscription_months クーポン（サブスク権 nか月）はアクティブな サブスク期間を延長するか、支払いのないサブスクを開始します。どちらも同じ登録エンドポイントを 使い、ログインセッション（JWT）が必要です。

credit クーポンの使用#

クーポンコードをパスパラメータとして渡します。ボディは空です。加算されたクレジットは非現金であり、返金可能残高から除外されます。

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

kind はクーポンの種類、amount_krw は加算された 金額、balance_krw は加算後の合計残高です。

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

サブスク月数クーポン#

サブスク月数クーポンは発行時にプランと月数が固定されます。使用すると、アクティブな個人サブスクの 期間を nか月延長するか（延長期間中は定期決済なし）、支払いのないサブスクを 生成します — カード請求は一切なく、期間終了時に自動解約されます。サブスククレジット （プランの月次付与 × 月数）は一括で加算され、期間終了時に失効します。

plan_id と months は有効化されたサブスクの プランと月数、subscription_end は新しい期間の終了時刻、 amount_krw は即時付与されたクレジットです。

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

アクション報酬#

クーポンとは別に、アクションを完了するたびに4つのアクション報酬が自動的に付与されます （API なし）。登録・本人確認・初回 API コールは固定額、初回決済はチャージクレジットの10%（最大 5,000 クレジット）で、いずれも非現金であり、 返金可能残高から除外されます。

登録報酬 500 クレジット — メール認証を完了し登録を終えると、識別子ごとに1回 付与されます。

本人確認報酬 500 クレジット — 個人アカウントがソーシャルアカウントを連携する、 または法人アカウントが事業者確認を完了すると、識別子ごとに1回付与されます。

初回 API コール報酬 500 クレジット — 発行したキーで初回の API コールに 成功すると付与されます。

初回決済報酬：チャージクレジットの10%（最大 5,000 クレジット） — 初回チャージが 完了した時点で付与されます。ただしアカウントが法人でなく、ソーシャルアカウントが連携されており、 同じ実物カードがまだこの報酬を獲得していないことが条件です。