Skip to main content (Press Enter)
Helcim Logo
Click here if you return to contents

EFT or ACH Withdrawal

The information in this article is for merchants using Helcim's Legacy System and does not apply to merchants who signed up for Helcim on or after June 1, 2020.

This API call lets you process a EFT/ACH withdrawal. The response is an XML of the processed withdrawal.

Request Fields

Field Name Type Required Description
transactionEFTType String Yes withdrawal
accountId Integer Yes The Helcim Commerce account ID.
apiToken String Yes API token used for authentication and access control.
amount Decimal Yes The amount of the transaction.
terminalId Integer No The terminal ID.
customerCode String No The customer code.
bankAccountToken String Yes The bank account token.
bankAccountL4L4 Integer Yes The last four digits of the routing number, and the last four digits of the bank account number.
orderNumber String No The order number.

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.


For all API requests, there are also generic API authentication and user access restriction errors.

Response Code Error Code Message Description
0 - Invalid Amount The transaction amount was not entered.
0 - Invalid Bank Account Token The bank account token is invalid, or not entered.
0 - Bank Account L4L4 Does Not Match Bank Account Token The bank account L4L4(last 4 digits of routing number, last 4 digits of bank account number) do not match the bank account token, or were not entered.
0 - Transaction amount cannot be larger than amount due of order The amount of the withdrawal is larger than the order. (Error can only appear when field orderNumber is entered in Request Fields)

Related Articles

EFT or ACH Settle

Was this article helpful?

Feedback submitted - Thank you!

If you need immediate assistance please contact our Merchant Experience Specialists here

Click here if you return to the content