Skip to main content
Vindicia Knowledge Center




The fetchAllCreditHistory method returns all Credit events that match the input timestampparameters, for all Accounts.

Vindicia Subscribe maintains a log of credit-related events for each account. This log keeps track of events such as credit granted, revoked, consumed, or earned from a gift card redemption. Retrieve the audit log by calling the fetchAllCreditHistory or fetchCreditHistory methods for the Account or AutoBill objects.

The following table describes data members of the CreditEventLog object.

Data Member

Data Type




The Credit object used during a credit-related action or event.

See the Credit Subobject.



A memo regarding the Credit event.



Time when this credit related action or event took place.



Type of this credit related action or event. Use this to decide whether this action or event incremented or decremented credit.

The following table describes enumeration values of the CreditEventLog object.




Credit decremented due to use in a recurring or one time transaction


Credit added due to a redemption of a gift card.


Credit decremented due to a reversal of a gift card that was previously redeemed.


No change in credit.


Credit added due to a credit grant you made.


Credit added due to refund of a credit based transaction.


Credit decremented due to a credit revocation you made.


(For more information, see the Account.fetchCreditHistory method.)


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 starting time stamp (lower limit) for the range of credit event logs you wish to retrieve.

endTimestamp: the ending time stamp (upper limit) for the range of credit event logs you wish to retrieve.

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.


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

creditEventLogs: the array of Credit events (grants and deductions) with a time stamp and event type.


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

Return Code

Return String


One of the following:

  • Unable to load account.
  • No matching credit events found.
  • Invalid value or values of time stamp, and/or page, and/or page size.


// to fetch all credit history for an account

$acct = new Account();

// account id for an existing customer whose
// credit history you want to retrieve


$page = 0; // paging begins at 0
$pageSize = 5; // five records

do {

$ret =

$acct->fetchAllCreditHistory($page, $pageSize);

$count = 0;
if ($ret['returnCode'] == 200)

$fetchedLogs = $ret['creditEventLogs'];
$count = sizeof($fetchedLogs);

foreach ($fetchedLogs as $log) {

$credit = $log->getCredit()
$ts = $log->getTimeStamp()
$eventType = $log->getType()
// process retrieved credit event log
// details here.



} while ($count > 0);

For Users

Learn More
For Users

Vindicia Subscribe Features

Learn More
Vindicia Subscribe Features
Back to Top