plan

Contains details for a subscription billing plan

Request

Property Name

Type

Required

Description

charge-frequency

string

Required

Permitted values:
ONCE
DAILY
WEEKLY
EVERY 2 WEEKS
MONTHLY
EVERY 2 MONTHS
QUARTERLY
EVERY 6 MONTHS
ANNUALLY
EVERY 2 YEARS
EVERY 3 YEARS

charge-on-plan-switch

boolean

Optional

Determines whether subscriptions that are switched to this plan are charged immediately.
true = Immediate charge on switch.
false = Subscription will be charged at the next scheduled recurring payment. (default)

currency

string

Required

Currency code (ISO 4217) of the amount to be charged. See Currency codes.

grace-period-days

integer

Optional

Number of days in the grace period.
For example: 10

In case of payment failure, automatic retries will be attempted during this grace period.
If this property is not set and a payment fails, the subscription will remain active until you cancel it. Make sure you have the

initial-charge-amount

decimal

Optional

Cannot be included in Update Plan requests unless the plan already has an initial charge.

Amount of the initial charge.
For example: 99.00

max-number-of-charges

integer

Optional

Maximum number of charges (after the initial charge) that can be processed for a subscription on this plan.
For example: 12

name

string

Required

Name of the plan. Maximum 199 characters.
For example: Gold Plan

recurring-charge-amount

decimal

Required

Recurring amount to be charged.
For example: 29.99

status

string

Optional

Update Plan requests only

Permitted values:
ACTIVE
INACTIVE

trial-period-days

integer

Optional

Cannot be included in Update Plan requests unless the plan already has a trial period.

Number of days in the trial period.
For example: 14


Response

Property Name

Type

Description

charge-frequency

string

Possible values:
ONCE
DAILY
WEEKLY
EVERY 2 WEEKS
MONTHLY
EVERY 2 MONTHS
QUARTERLY
EVERY 6 MONTHS
ANNUALLY
EVERY 2 YEARS
EVERY 3 YEARS

charge-on-switch

boolean

Determines whether subscriptions that are switched to this plan are charged immediately.

true = Immediate charge on switch.

false = Subscription will be charged at the next scheduled recurring payment. (default)

currency

string

Currency code (ISO 4217) of the amount to be charged. See Currency codes.

grace-period-days

integer

Number of days in the grace period.
For example: 10
In case of payment failure, automatic retries will be attempted during this grace period.

initial-charge-amount

decimal

Amount of the initial charge.
For example: 99.00

max-number-of-charges

integer

Maximum number of charges that can be processed for a subscription on this plan.
For example: 12

name

string

Name of the plan.
For example: Gold Plan

plan-id

integer

BlueSnap identifier for the plan.

recurring-charge-amount

decimal

Recurring amount to be charged.
For example: 29.99

status

string

Possible values:
ACTIVE
INACTIVE

trial-period-days

integer

Number of days in the trial period.
For example: 14