TransactionStatus

The purpose of the TransactionStatus request is to provide a way to determine the status of a request that was interrupted for some reason. For a transaction where the response was lost the transaction xid would be unknown to the client. To be able to use this request you have to have passed through a unique transaction identifier of your own using the VendorData elements which can be passed through with the original request. Ideally you would pass through a unique ID with every request, although this request will do the lookup based on multiple VendorData elements. If more than one record is matched based on the passed VendorData the first matching transaction will be used to generate the response. The transaction response will contain a warning message indicating that multiple transactions were matched in this case. Please note that this is NOT a search tool since it does not return multiple responses. This tool was also not written to automate the retrieval of past transaction history. The example below displays all fields that could potentially be used for this action.

Example

<?xml version="1.0"?>
 <GatewayInterface>
   <APICredentials>
     <Username>username</Username>
     <PayloadSignature>signature</PayloadSignature>
     <TargetGateway>12345</TargetGateway>
   </APICredentials>
   <TransactionStatus>
    <VendorData>
     <Element>
      <Name>field1</Name>
      <Value>1234567</Value>
     </Element>
     <Element>
      <Name>field2</Name>
      <Value>1234567</Value>
     </Element>            
    </VendorData>        
   </TransactionStatus>
   <TransactionControl>
     <TestMode>FALSE</TestMode>
   </TransactionControl>
 </GatewayInterface>

For additional information, please view the XML API Connection documentation HERE.