Skip to main content
Vindicia Knowledge Center




Call the fetchByWebSessionVid method within your HOA implementation to retrieve the Transaction object created by HOA on Vindicia’s servers when a customer submits an order form, which results in a one-time or recurring bill. You must create a WebSession object on Vindicia’s servers before serving the form to your customer to track the form’s submission to Vindicia. For more information, see The WebSession Object.

The WebSession object’s VID serves as the tracking ID for various activities, starting from serving the order form to a customer, and ending in returning a success or failure page to that same customer.

Use fetchByWebSessionVid to program the success page (see the WebSession object’s returnURL attribute), to which HOA redirects the customer’s browser after successfully processing the data in the order form. The WebSession object’s VID is available to you on the success page, because HOA passes it during the redirection. Pass that VID as the input parameter to this call, and retrieve the Transaction object created by HOA. Then, extract the contents of the Transaction object and include them, as appropriate, in the success page to be returned to the customer.


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.

vid: the WebSession object’s Vindicia unique identifier for tracking the submission of the order form.


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

transaction: a Transaction object that was created by HOA as a result of an order form submitted by a customer.


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

Return Code

Return String


Missing required parameter 'vid'.


Unable to find requested Transaction: No matches.


// to use the fetchByWebSessionVid call on a success web page

$webSessionVid = …; //passed in by redirected page
$soap = new WebSession($soapLogin, $soapPwd);
$response = $soap->fetchByVID($webSessionVid);

if ($response['returnCode'] == 200) {

$fetchedWs = $response['data']->session;

// check if the Vindicia Subscribe API call made by HOA was successful

$retCode = $fetchedWs->apiReturn->returnCode;
if ($retCode == 200) {

// Assuming HOA created a Transaction object, let's
// fetch it

$soapTxn = new Transaction($soapLogin, $soapPwd);
$resp = $soapTxn->fetchByWebSessionVid($webSessionVid);

if ($resp['returnCode'] == 200) {

$createdTxn = $resp['data']->transaction;

// Get Transaction contents here to be included in
// HTML returned to the customer.


else {

// Return error message to customer



else {

// return failure page to customer



else {

// Return error message to the customer


For Users

Learn More
For Users

Vindicia Subscribe Features

Learn More
Vindicia Subscribe Features
Back to Top