Create a billing plan
Creates a recurring billing plan. Subscriptions are tied to a plan and inherit its amount, interval, and dunning settings.
Amount and interval are immutable after creation. To change them, create a new plan and migrate subscribers using the Change Plan endpoint.
Authorizations
Your PayBridgeNP API key. Obtain one from the dashboard under Settings → API Keys. Prefix: sk_test_ for testing, sk_live_ for production.
Body
"Pro Monthly"
Recurring charge in paisa.
99900
day, week, month, quarter, year "month"
How many intervalUnits per billing cycle. 2 + month = every 2 months.
Days after due date before triggering overdue action.
metered bills on reported usage (see POST /v1/billing/subscriptions/{id}/usage). Set at creation; immutable afterwards.
per_unit, metered How usage records aggregate per period on metered plans.
sum, max, last_ever Free trial period in days (0–365).
14
esewa, khalti, fonepay Send payment reminder this many days before invoice due date (0–30).
3
Repeat overdue reminders every N days (0–30).
Action to take when a subscription goes overdue.
keep_active, mark_past_due, pause, cancel Response
Plan created.
"bpl_01j9x2k3m4n5p6q7r8s9t0u1v2"
plan "Pro Monthly"
Recurring amount in paisa.
99900
"NPR"
day, week, month, quarter, year 1
3
14
esewa, khalti, fonepay metered plans bill on reported usage.
per_unit, metered Usage aggregation for metered plans.
sum, max, last_ever, null true when created with a live key, false for sandbox.