Skip to main content

Plans

In a nutshell

Plans define what a customer pays, how often they are billed, and whether billing begins immediately or after a trial.

Plan fields

FieldDescription
codePublic plan code, such as PLN_8AbC123x.
namePlan name.
descriptionOptional plan description.
amountAmount in the smallest currency unit.
currencyCurrently NGN.
intervalBilling interval.
intervalCountOptional interval multiplier.
trialPeriodDaysOptional number of trial days.
invoiceLimitOptional maximum number of invoices.
statusactive or inactive.

Supported intervals

  • daily
  • weekly
  • bi-weekly
  • monthly
  • quarterly
  • yearly

Plan updates

When you update a plan, new subscriptions use the latest plan values. You can also request that existing subscriptions pick up the new plan version on their next billing cycle by setting updateExistingSubscriptions to true.

API

See Plans API Reference.