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

XML Sample TransactionEFTType Void Response

HTML HTML Form Sample

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">