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 Subscription Charge Failure IPN enabled to be notified when a subscription payment fails. |
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 |