What are the main reasons why transactions fail and what error code will you get from the endpoint?

Last updated: February 9, 2026

Insufficient Funds:

  • Error code: INSUFFICIENT_FUNDS

  • Message: "insufficient funds for intrinsic transaction cost" or "insufficient funds for gas * price + value"

Deposit Limits Exceeded:

  • Error tag: DepositLimitReached

  • Example: When payAmount exceeds maxDepositAmount (e.g., trying to deposit $6,004 when limit is $5,000)

Negative Receive Amount:

  • Error tag: NegativeReceiveAmount

  • Occurs when the amount being sent is lower than the total fee

Rate Limiting:

  • Error: "Too many requests, reason: call rate limit exhausted, retry in 10s"

  • Error occurs when hitting our rate limit

AML/Compliance Failures:

  • Rejection reason: OPERATION_UNAVAILABLE when failing KYC/AML checks

Processing Issues:

  • TERMINAL_PROCESSING_ISSUE (ParseError) for rejected transactions

  • History not found errors: {"message":"HistoryNotFound: [ID]","_tag":"InvalidRequest"}

Network-Specific Issues:

  • Transaction already known: "ALREADY_EXISTS: already known" when resubmitting transactions