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 Code

Meaning

ACH_ACCT_DNE

A bank account with the given name does not exist under the user handle's linked accounts.

ACH_ACCT_INVALID

The specified bank account is invalid. It may be closed or have invalid values.

ACH_INSUFF_FUNDS

A bank account debit could not be completed due to insuffient funds.

ACH_REJECTED

An 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_FUNDS

An 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_BALANCE

An 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_RISK

An 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_RETURN

There was an ACH return on a transaction.

ADDR_BLACKLISTED

An address in this transaction is blacklisted.

ADDR_INSUFF_FUNDS

There 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_INVALID

Provided 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_BETALISTED

An address in this transaction is not on the contract's betalist (temporary whitelist).

APPL_LIMIT

The request count limit has been reached for the current application.

BLOCK_TIMEOUT

The 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_FLAG

    All further transactions are temporarily disabled on the Sila platform.

    FEE_INSUFF_FUNDS

    The address specified to pay the transaction fee had insufficient funds.

    NON-ACH_TRANS_UNSUPPORTED

    A non-ACH transaction was requested while non-ACH transactions are temporarily unsupported.

    RATE_LIMIT

    Too many transactions have been requested in a short span of time. Try waiting and retrying later.

    TRANS_AMNT_TOO_LOW

    The amount specified in the transaction was too low for it to complete.

    TRANS_AMNT_TOO_HIGH

    The amount specified in the transaction was higher than allowed transaction limit.

    TRANS_AMNT_INVALID

    The 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.

    UNCONFIRMED

    The user has not replied to an Instant-ACH transaction SMS confirmation. The transaction is now canceled.

    UNKNOWN

    This is an unknown error. Contact us ASAP if a transaction has this error code!

    USER_HANDLE_FROZEN

    This user is not permitted to transact at this time.

    USER_KYC_INCOMPLETE

    The user has not been KYC-verified.

    Any code in <>

    Contact us ASAP if you catch one of these!


    Did this page help you?