Transaction Error Codes

Transactions returned from the /get_transactions endpoint, if they have failed, will have an error code and error message returned with them. These are the error codes we return as of version 0.2.

Error CodeMeaning
ACH_ACCT_DNEA bank account with the given name does not exist under the user handle's linked accounts.
ACH_ACCT_INVALIDThe specified bank account is invalid. It may be closed or have invalid values.
ACH_INSUFF_FUNDSA bank account debit could not be completed due to insuffient funds.
ACH_REJECTEDAn Instant ACH transaction was rejected. This could be due to suspected fraud, a previous ACH return in the past 180 days, or insufficient funds.
ACH_REJECTED_ACCT_INSUFF_FUNDSAn Instant ACH transaction was rejected due to insufficient funds in the bank account to initiate a transaction.

(Note that there could have been sufficient funds to cover the transaction, but if the remaining balance from unsettled funds and the transaction amount would approach 0 too closely, we reject it since there could be other incoming debits to the account from other sources at the same time.)
ACH_REJECTED_PLAID_*An Instant ACH transaction was rejected because the bank account balance could not be checked through Plaid.

The string on the end of this error code (replacing *) is the error code returned by Plaid. You can see more details at https://plaid.com/docs/errors/ .
ACH_REJECTED_UNVERIFIED_BALANCEAn instant ACH transaction was rejected because the bank account balance could not be checked through Plaid and, unexpectedly, we did not get an error code from Plaid.

You can retry this transaction at a later time.
ACH_REJECTED_RISKAn Instant ACH transaction was rejected due to one or more risk factors, such as a previous ACH return in the past 180 days or suspected fraud.
ACH_RETURNThere was an ACH return on a transaction.
ADDR_BLACKLISTEDAn address in this transaction is blacklisted.
ADDR_INSUFF_FUNDSThere are insufficient funds at the user handle's associated blockchain address. This can apply to /issue_sila request when there is a late-dated return.
ADDR_INVALIDProvided blockchain address for user handle is invalid. It could be that it is a smart contract address, is not a real address, or is not on our betalist (temporary whitelist).
ADDR_NOT_BETALISTEDAn address in this transaction is not on the contract's betalist (temporary whitelist).
APPL_LIMITThe request count limit has been reached for the current application.
BLOCK_TIMEOUTThe transaction timed out on the blockchain and can be retried.
CANCELED

  • SAME_DAY_ACH/STANDARD_ACH: The user cancelled the /issue_sila or /redeem_sila transaction.

  • INSTANT-ACH: The user has replied "NO" to the Instant-ACH transaction SMS confirmation. The transaction is now canceled.

    EMERGENCY_FLAGAll further transactions are temporarily disabled on the Sila platform.
    FEE_INSUFF_FUNDSThe address specified to pay the transaction fee had insufficient funds.
    NON-ACH_TRANS_UNSUPPORTEDA non-ACH transaction was requested while non-ACH transactions are temporarily unsupported.
    RATE_LIMITToo many transactions have been requested in a short span of time. Try waiting and retrying later.
    TRANS_AMNT_TOO_LOWThe amount specified in the transaction was too low for it to complete.
    TRANS_AMNT_TOO_HIGHThe amount specified in the transaction was higher than allowed transaction limit.
    TRANS_AMNT_INVALIDThe amount may have been for an issue or redeem transaction and been a decimal value; this would convert to a fraction of a cent, which is not permitted on bank account transactions.
    UNCONFIRMEDThe user has not replied to an Instant-ACH transaction SMS confirmation. The transaction is now canceled.
    UNKNOWNThis is an unknown error. Contact us ASAP if a transaction has this error code!
    USER_HANDLE_FROZENThis user is not permitted to transact at this time.
    USER_KYC_INCOMPLETEThe user has not been KYC-verified.
    Any code in <>Contact us ASAP if you catch one of these!