Helcim Logo Support & Tutorials

© Copyright 2006-2018 Helcim Inc.

All Rights Reserved.

Helcim Commerce API » Processing Payments » EFT/ACH Payments »

EFT/ACH Void

This API call let's you void a EFT/ACH transaction. The response is an XML of the voided transaction.

Request Fields

Field Name Type Required Description
transactionEFTType String Yes void
accountId Integer Yes The Helcim Commerce account ID.
apiToken String Yes API token used for authentication and access control. 
transactionId Integer Yes The transaction ID.

Response Fields (XML)

Field Name Type Description
message - XML structure
response Integer 1 or 0. Whether the transaction was approved or declined.
responseMessage String Result of transaction (Approved/Denied).
notice String Error/warning message from Helcim. 
transaction - XML structure
transactionEFTId Integer The transaction ID.
transactionType String The transaction type (purchase, refund, pre-auth, capture).
date String The date of the transactions
time String The time of the transaction.
amount Decimal The amount of the transactions.
currency String The transaction currency.
approvalCode String The approval code.
bankAccountType String The bank account type (CHK, SAV).
bankAccountCorporate String The type of account (CHK-chequing, SAV-savings).
bankAccountToken String The bank account token.
bankAccountFinancialNumber String The bank account financial number.
bankTransitNumber String The bank account transit number.
bankAccountNumber String The bank account transit number.

Errors

For all API requests, there are also generic API authentication and user access restriction errors.
Response Code Error Code Message Description
0 - Invalid Transaction ID The transaction ID was invalid or not entered.

Code Samples

Sample TransactionEFTType Void Response XML

<?xml version="1.0"?>
<message>
    <response>1</response>
    <responseMessage>APPROVED</responseMessage>
    <notice></notice>
    <transaction>
        <transactionEFTId>208</transactionEFTId>
        <transactionType>VOID</transactionType>
        <date>2017-07-07</date>
        <time>12:39:19</time>
        <amount></amount>
        <currency>CAD</currency>
        <approvalCode>166EFT</approvalCode>
        <bankAccountType></bankAccountType>
        <bankAccountCorporate></bankAccountCorporate>
        <bankAccountToken></bankAccountToken>
        <bankFinancialNumber></bankFinancialNumber>
        <bankTransitNumber></bankTransitNumber>
        <bankAccountNumber></bankAccountNumber>
    </transaction>
</message>

HTML Form Sample HTML

<input type="hidden" name="accountId" value="YOUR-ACCOUNT-ID">
<input type="hidden" name="apiToken" value="YOUR-API-TOKEN">
<input type="hidden" name="transactionEFTType" value="void">
<input type="hidden" name="transactionId" value="203">