Skip to main content
Vindicia Knowledge Center

AutoBill Data Members

AutoBill Data Members

AutoBill Data Members


The following table describes the data members of the AutoBill object.

Data Members

Data Type




Required. The Account object to which this AutoBill object applies. If you do not specify a valid VID or merchantAccountId, Vindicia Subscribe creates a new Account object.



The day of the month on which to bill the customer, which, if unspecified, defaults to the day of the startTimestamp. The value ranges from 1 to 31. Vindicia Subscribe automatically handles calendaring anomalies. For example, if you set this value to 31 but the month in question contains only 30 days, recurring billing automatically adjusts to day 30 for that month.

This attribute is useful if AutoBill has a yearly or monthly billing plan, and if the customer desires to be billed on a specific day of the month. If the billing plan is in terms of a daily or weekly cycle, the next billing day is determined by the duration and length of the cycle.

Note If the Billing Plan for the AutoBill includes a Season Set, and if the Billing Periods are set to repeat according to Seasons, this data member will be automatically reset by Vindicia Subscribe, according to the defined repetition cycle.

billingOffset int Number of days before or after the scheduled billing day that you want the AutoBill to bill. Use billingRule to set the direction of the offset. 



The billing plan to be used for this AutoBill object. This attribute determines the frequency and amount of periodic billing transactions generated by this AutoBill object.

If you do not specify this attribute, Vindicia Subscribe uses the default billing plan associated with the primary Product object in this AutoBill object. If you have not defined a default billing plan for Product, be sure to specify it here.

If the BillingPlan object already exists, simply populate it with its VID or merchantBillingPlanId. If the BillingPlan does not yet exist, Vindicia Subscribe creates a new BillingPlan object along with this AutoBill object.

See BillingPlan Data Members.



The Campaign code redeemed on this AutoBill against the price of the Billing Plan. To apply a Campaign, use this field to pass in a valid Coupon or Promotion code.

Note This data member will not be returned.



Read only. The unique identifier for a Campaign applied to this AutoBill's BillingPlan. This is a read-only field returned by Vindicia Subscribe for informational purposes. Values sent in with a SOAP call will be ignored.

billingRule BillingRule An enumerated string value (Advance or Arrears), informing Vindicia Subscribe in which direction from the scheduled billing date to select the specified billing date. If no specified_billing_day is provided, this parameter is ignored.




(Required) The billingState data member presents the financial billing condition of an AutoBill. This data member expands on the current billing condition of the subscription, and in combination with the Status field, provides a definitive representation of the current condition of an AutoBill.

See the AutoBill billingState Data Member Detail section for descriptions of the enumerated values of the billingState data member.



The identifier on a customer’s billing statement when the customer is charged for this AutoBill object.

If GlobalCollect, MeS, Chase Paymentech or Litle is your payment processor, see Custom Billing Statement Identifier Requirements in the Vindicia Subscribe Programming Guide for the rules for this string.

cancelFee string The early termination fee as defined in the Billing Plan that was used when the subscription (AutoBill) was created. This cancel fee will remain on the AutoBill even if you subsequently change the Billing Plan. See AutoBillCancelFee Subobject. 



A subobject containing a cancel reason code and description for canceling the AutoBill.

See the CancelReason Subobject.

commitmentDate string Read-only field indicating the date through which the customer is contractually obligated.



This data member encapsulates credit available to the AutoBill.

Token-based credits stored in this attribute may be applied toward Transactions generated by this AutoBill for Billing Plans which are defined with a Payment Method of the same Token Type.

Currency-based credits must be of the same Currency type listed in the Billing Plan associated with this AutoBill, to be used toward Transactions generated by the AutoBill.

Time-based credits are stored in this attribute only until the next Billing Period, at which point they are immediately and fully applied toward the AutoBill.

Do not manipulate this attribute directly. Instead, use methods such as grantCredit or revokeCredit to manipulate the amount of credit available to the AutoBill object.

See the Credit Subobject.



The ISO 4217 currency code (see for this AutoBill object. The default is USD. You should not change the currency type of an AutoBill object via the addChargemakePayment, or update methods.



Optional. A name you specify (on your customer’s behalf) for this AutoBill object, such as 'Home Subscription.'



This is a read-only attribute in fetched AutoBill objects.

Vindicia Subscribe will automatically set this timeStamp based on the AutoBill’s last successful billing date, plus the length of the next Billing Period, and any grace period you have defined. This value is reset with every successful billing.

Note Do not set this value when creating or updating an AutoBill.



The number of days after the invoice date that a bill is considered delinquent, if the AutoBill payment method is MerchantAcceptedPayment. This value will be ignored for all other AutoBill payment methods.



An array of AutoBillItems to be included in the AutoBill.

See the AutoBillItem Subobject.

mandate Mandate The mandate authorizing this subscription.

See the Mandate Subobject  for details.



Your ID (a free-form string of 128 characters or less) for the affiliate that submitted this AutoBill object, if any.



Your ID (a free-form string of 128 characters or less) for the subaffiliate that submitted this AutoBill object. This ID enables more detailed tracking of affiliate programs, such as promotional campaigns.



Your unique identifier for this AutoBill object.



The number of billing cycles the customer is contractually obligated to complete before canceling the subscription. For example, if you offer special pricing for a certain number of automatic billing renewals, you can track a customer’s initial agreement to those terms with this data member.

When you make a call to cancel an AutoBill object, Vindicia Subscribe checks this attribute. If the AutoBill has not completed the minimum commitment period, an AutoBill.cancel() call will succeed only if the force parameter is set to true.

Note: Previous to Vindicia Subscribe release 25.0, it was possible to pass in the minimumCommitment value when creating an AutoBill. Attempting to pass this parameter in the AutoBill in release 25.0 and higher will return an error. You now set this value in the Billing Plan. The minimum commitment is calculated from the BillingPlan attached to the subscription at the time of AutoBill creation. See also the BillingPlan Data Members table.



An (optional) array of name–value pair items for this AutoBill object. Some names are reserved for specific purposes.

Use vin:Division to route this AutoBill’s transactions to your payment processor as part of a business division, unit, or group you have registered with the processor.

Vindicia Subscribe provides the following name-value pairs for use with SEPA European Direct Debit and UK Direct Debit payment methods:

  • Use name vin:MandateFlag and value 1 to associate the SEPA or UK Direct Debit Payment Method with the AutoBill.

  • Use name vin:MandateVersion and value 1.0.1 to associate a mandate document of version 1.0.1 with the object.
  • Use name vin:MandateID to pass the Mandate ID field of the SEPA or UK Direct Debit Extension record to Chase Paymentech.
  • Use name vin:MandateApprovalDate to pass the Signature Date field of the SEPA or UK Direct Debit Extension Record to Chase Paymentech.
  • Use vin:ValidateFullAmt to pass whether full amount authorization needs to be done before charging. This must be enabled if the processor is Global Collect.

Note All name-value pairs included with an AutoBill object will be automatically copied to any resultant Transactions.

See The NameValuePair Object.



An object of type Transaction that represents the next projected billing for this AutoBill, if any.

See Transaction Data Members.



Vindicia’s identifier (VID) for the PaymentMethod object for this AutoBill. If you do not specify an existing VID or merchantPaymentMethodId, Vindicia Subscribe creates a new PaymentMethod object with this AutoBill object, and adds it to this AutoBill object’s account.

If you do not specify this attribute, the AutoBill will automatically use the preferred PaymentMethod object associated with the Account.

See PaymentMethod Data Members.



The IP address of the machine from which the customer requested the creation of this AutoBill object. This attribute is required if you wish to score a transaction associated with the AutoBill for risk screening. Some payment methods, such as European Direct Debit, also require this attribute.

specifiedBillingDay int An integer (1-31) specifying the fixed day of the month on which to bill (values 29-31 will automatically work as the last day of the month in calendar months that do not have 29, 30, or 31 days). Providing no value or null in this parameter instructs Vindicia Subscribe to bill on the service period start date as usual.



A time stamp that specifies the start date and time for this AutoBill object.

  • f unspecified, the value defaults to today and the current time.
  • If unspecified, and the unknownStart flag is set to True, the time stamp value will be empty.

See unknownStart in the AutoBill update method.



Defines the billing format used to send statements to a customer. Defaults to DoNotSend if not specified.

Valid input:

  • DoNotSend
  • Inline
  • Attachment



Days prior to billing that a statement will be sent. This value must be "null" or "0" if the AutoBill’s PaymentMethodType is MerchantAcceptedPayment. For conventionally-funded AutoBills, this value must be less than the prebilling notification days (if specified). The value will be ignored if statementFormat is DoNotSend.



Your identifier for a pre-defined statement template. If this value is null (or does not match any pre-defined statement templates), the Vindicia Subscribe-default template will be used.



Provides a clear and mutually exclusive indicator of the current service status of an AutoBill, and of its place in its life cycle. See AutoBill status Data Member Detail for descriptions of the enumerated values of the status data member.



Vindicia's Globally Unique Identifier (GUID) for this object. When creating a new AutoBill object, leave this field blank; it will be automatically populated by Vindicia Subscribe.



A flag that, if set to true, specifies that the customer be warned by email of an upcoming expiration of a trial period or subscription. The default is false. For more information, see the expireWarningDays attribute in the BillingPlanPeriod object.

For Users

Learn More
For Users

Vindicia Subscribe Features

Learn More
Vindicia Subscribe Features
Back to Top