TranForceTransaction

This action will generate a force (capture) for a previously failed transaction. Obtain a voice approval from the credit card processor’s voice approval center and use that as value for the AuthCode. The OperationXID field should contain the XID for the original failed transaction. The example below displays all fields that could potentially be used for this action – including the optional fields which are specified.

Optional Fields

Total

TransactionControl elements

VendorData elements

Example

<?xml version="1.0"?> 
<GatewayInterface> 
    <APICredentials> 
        <Username>username</Username> 
        <PayloadSignature>EXAMPLESIGNATURE</PayloadSignature> 
        <TargetGateway>12345</TargetGateway> 
    </APICredentials> 
    <TranForceTransaction> 
        <OperationXID>12345678</OperationXID>
<!-- Optional. Will use total from original transaction if not passsed. -->         
        <Total>5.00</Total> 
<!-- All TransactionControl elements are optional including TransactionControl --> 
         <TransactionControl> 
          <SendCustomerEmail>TRUE</SendCustomerEmail> <!-- TRUE/FALSE --> 
          <SendMerchantEmail>TRUE</SendMerchantEmail> <!-- TRUE/FALSE --> 
          <TestMode>TRUE</TestMode> <!-- TRUE/FALSE --> 
           <EmailText> <!-- Up to 10 EmailTextItem elements allowed --> 
           <EmailTextItem>test1</EmailTextItem> 
           <EmailTextItem>test1</EmailTextItem> 
           <EmailTextItem>test1</EmailTextItem> 
           <EmailTextItem>test1</EmailTextItem> 
           <EmailTextItem>test1</EmailTextItem> 
           <EmailTextItem>test1</EmailTextItem> 
           <EmailTextItem>test1</EmailTextItem> 
           <EmailTextItem>test1</EmailTextItem> 
           <EmailTextItem>test1</EmailTextItem> 
           <EmailTextItem>test1</EmailTextItem> 
          </EmailText> 
         </TransactionControl> 
<!-- Optional. This information will be saved on our servers and is 
available in the XML transaction report. This is useful if you want 
to save your own transaction meta-data with a transaction. --> 
         <VendorData> 
          <Element> 
           <Name>repId</Name> 
           <Value>1234567</Value> 
          </Element> 
         </VendorData> 
    </TranForceTransaction> 
</GatewayInterface>

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

Contact iTransact

Please do not hesitate to contact us with any questions.

iTransact
PO Box 999
314 South 200 West
Farmington UT 84025-0999
Phone: (801) 298-1212
Fax: (801) 298-9789

For technical assistance, please submit a ticket via the iTransact Support Center.