Skip to main content
Vindicia Knowledge Center




The fetchDeltaSince method returns one or more AutoBill objects whose Status has changed since a time stamp you specify. Call this method to find out which AutoBill objects are still active and which are not. AutoBills can become inactive for several reasons, including a Hard Error received by CashBox while processing a payment with a payment processor, a cancel() call that explicitly stopped an AutoBill object, or a chargeback against a billing transaction generated by AutoBill.

This method supports paging to limit the number of records returned per call. Returning a large number of records in one call can overflow buffers and might cause a failure. Vindicia recommends that you call this method in a loop, incrementing the page for each loop iteration with an optimal page size (number of records returned in one call) until the page contains no additional records.

Note Do not rely on the data returned by this method to determine a customer’s entitlements. Even if an AutoBill object is inStopped or Hard Error status, the entitlements might still be valid. The entitlements are determined by the current end-date of the AutoBill object, which in turn is determined by the success of the last billing (transaction). Thus, the end-date indicates the period for which the customer has already paid. The customer’s subscription (AutoBill) may stop before the end-date, but the entitlements might remain valid until that date. The correct way to determine customer entitlements is by making calls on theEntitlement object.

By default, this method returns all AutoBills that have had a Status change within the timestamp parameters you specify. The AutoBillEventType parameter gives you the ability to selectively return AutoBills that have had changes to an array of events you specify. By tailoring returns to your needs you can greatly reduce both the volume of the return and the response time. As with the default return of Status, the CashBox deduping functionality ensures that AutoBills with multiple events are returned only once per query.


srd: sparse response description, a SOAP string (which must be a JSON object), in which you specify the elements you want returned.This parameter enables the calling system to constrain a method call to return only components you specify. This gives you greater control over returned content, and improves response time within the Vindicia platform by reducing the processing needed for the call.

Some fields are required, either practically or in the WSDL, and will be returned regardless of the srd. A null srd returns the complete response.

timestamp: the date and time after which to return the AutoBill objects whose status has changed.

page: the page number, starting at 0, for which to return the results. For example, if the total number of results is 85 and pageSize is 10:

  • Specifying 0 for page gets the results from 1 through 10.
  • Specifying 2 for page gets the results from 21 through 30.

pageSize: the number of records to display per page per call. This value must be greater than 0.

endTimestamp: the upper threshold of the time window by which to limit the search. If unspecified, this value defaults to the current time.

selectEvents: list of events you want to be notified of. If unspecified, defaults to status_change events.




Autobills that have had an Account Updater event.


AutoBills that have been canceled.


AutoBills that have experienced a Catch-up Billing.


Autobills that have chargebacks received against them.


AutoBills that have had a credit action (grant/consumption).


AutoBills whose Billing has been delayed.


AutoBills that have ended.


AutoBills whose end date has been changed (high volume event).


AutoBills that have expired.


AutoBills that have been migrated.


AutoBills that have been modified.


AutoBills that have had a successful, associated one time Transaction executed.


AutoBills that have generated an email Notification (high volume event).


AutoBills that have had a payment method removed.


AutoBills that have had a payment method updated.


AutoBills that have had a refund.


AutoBills whose start date has been changed.


AutoBills that have had a Status change event.This is the default—calling fetchDeltaSince without the AutoBillEventType.


AutoBills that have had a successful recurring Transaction.


return: an object of type Return that indicates the success or failure of the call.

autobills: an array of one or more AutoBill objects.


In addition to those listed in Standard Return Codes, this call returns:

Return Code

Return String


Invalid value or values of the time stamp, and/or page, and/or page size.


$ab = new AutoBill();
$page = 0;
$pageSize = 100;
$startTime = '2016-01-01T22:34:32.265Z';
$endTime = '2016-01-02T22:34:32.265Z';
$AutoBillEventTypes = ["status_change","chargeback"];
$srd =  '{"autobills": ["VID","merchantAutoBillId"]}';
do {

$ret = $ab->fetchDeltaSince($srd, $startTime, $page, $pageSize, $endTime, $AutoBillEventTypes);
$count = 0;
if ($ret['returnCode'] == 200) {

$fetchedAutoBills = $ret['autobills'];
$count = sizeof($fetchedAutoBills);
foreach ($fetchedAutoBills as $autobill) {

// process a fetched autobill here …



} while ($count > 0);

For Users

Learn More
For Users

Vindicia Subscribe Features

Learn More
Vindicia Subscribe Features
Back to Top