BillingPlan Data Members
Web Session Object
Transaction Object
Token Object
Season Set Object
Refund Object
RatePlan Object
Product Object
Payment Provider Object
Payment Method Object
NameValuePair Object
GiftCard Object
Entitlement Object
Chargeback Object
Campaign Object
BillingPlan Object
AutoBill Object
Address Object
Activity Object
Account Object
BillingPlan Data Members
The following tables list and describe the data members of the BillingPlan object and its subobjects.
Table 5-1: BillingPlan Object Data Members
Data Members |
Data Type |
Description |
billingStatementIdentifier |
string |
The transaction description on the customer’s billing statement from the bank when the customer is charged through this BillingPlan object. This field’s value and its format are constrained by your payment processor; consult with Vindicia Client Services before setting the value. If GlobalCollect, MeS, Chase Paymentech or Litle is your payment processor, see Custom Billing Statement Identifier Requirements in the CashBox Programming Guide. |
daysBeforeSeasonToBill |
int |
If the Billing Period set repeats for multiple Seasons, this value defines the number of days before the Season begins that the Account should be billed. (Default is 0.) |
DaysEntitledAfterSeason |
int |
Defines the number of days after a Season ends that Entitlements will remain Active. |
daysEntitledBeforeSeason |
int |
Defines the number of days before the Season begins that Entitlements will become Active. |
description |
string |
Your description of the Billing Plan. |
endOfLifeTimestamp |
dateTime |
Optional. A time stamp that specifies the expiration date for this BillingPlan object. This value is for your information only, and does not affect CashBox operations. |
entitledOffSeason |
Boolean |
A Boolean flag that, if set to true, sets Entitlements to remain Active in the off-season. (Default is false.) |
entitlementsValidFor |
string |
The length of time for which Entitlements are valid after the last Billing date. |
merchantBillingPlanId |
string |
Your unique identifier for this BillingPlan object. This value enables you to look up a BillingPlan object with the fetchByMerchantBillingPlanId method. Reference the plan with this ID when making a call that requires you to specify a billing plan. |
merchantEntitlementIds |
MerchantEntitlementId[] |
An array of identifiers, specified by you, to define the customer’s entitlements. These IDs have special meaning in your application. For example, your application might contain logic such that the Gold Access ID enables a customer to access certain special features of your service. CashBox returns these IDs to you inside Entitlement objects along with the dates till which they are considered valid for a given customer. |
nameValues |
NameValuePair[] |
Optional. An array of name–value pairs, each of which enables you to include BillingPlan information other than that in the description field. |
periods |
BillingPlanPeriod[] |
An array of items that describe the billing. The AutoBill object uses this array sequentially for actual billing transactions, enabling the creation of complex billing plans in numerous currencies, for example, one free month, followed by three months at $9.99/month, and then 12 months for $15.99/month. For example, a Billing Plan may define a free trial period, followed by a monthly subscription service; or it may define a Seasonal Billing Plan, whereby a customer is billed only during the Season to which they are subscribed. |
prenotifyDays |
int |
Optional. The number of days before an AutoBill object’s billing date to notify yourself or the customer of an impending billing. |
repeatEvery |
string |
If a Billing Period set repeats, this value defines the length of time after the first billing that the set should repeat. |
seasonSet |
SeasonSet |
The SeasonSet to which the Billing Plan applies. (May be null.) |
skipInitialFreeWhenRepeating |
Boolean |
A Boolan flag that, if set to true, excludes initial free periods when repeating a Billing Period set. (Default is true.) |
status |
BillingPlanStatus |
An enumerated string value that describes the current state of the BillingPlan object. This value is for your information only, and does not affect CashBox operations. See the BillingPlanStatus Subobject. |
timesToRun |
string |
The number of times the sequence of Billing Periods should be repeated. Valid input includes positive integers, or “unlimited.” (Default is null.) |
VID |
string |
Vindicia's Globally Unique Identifier (GUID) for this object. When creating a new BillingPlan object, leave this field blank; it will be automatically populated by CashBox. |
taxClassification |
string |
A string that defines your tax classification for this BillingPlan. A null value in this field causes CashBox to use the tax classification associated with the Product. If you put a dash (–) in this field, no tax classification is sent to Avalara, and Avalara will use whatever system default you have set. |
For Users
Learn More