Skip to main content
Error format 
{
   "code": "<error_code>",
   "title": "<error_title>",
   "message": "<error_message>"
}
Field definitions
  • code – A stable, unique identifier for the error. Useful for programmatic handling and support requests.
  • title – A short, human-readable summary of the issue.
  • message – Detailed guidance to help you resolve the error.
This structure ensures you always get actionable feedback when something doesn’t go as expected.

​
Bank Transfer (TED) errors

The following errors can occur when interacting with the Bank Transfer (TED) endpoints. Each error follows our standard structure, making it easier to debug and respond to issues programmatically. Refer to the tables below for a list of possible error codes, what they mean, and how to resolve them.

​
400

CodeTitleMessage
BTF-0001Invalid InputThe request contains invalid fields. Check the field details below.
BTF-0002Invalid FilterInvalid filter parameters

​
401

CodeTitleMessage
BTF-0401UnauthorizedMissing or invalid authentication token

​
403

CodeTitleMessage
BTF-0402Tenant MismatchX-Organization-Id header does not match JWT tenantId claim. Access denied.

​
404

CodeTitleMessage
BTF-0200Transfer Not FoundTransfer not found
BTF-0201Initiation Not FoundInitiation not found or belongs to different organization
BTF-0500Account Not FoundSender account does not exist in CRM

​
409

CodeTitleMessage
BTF-0012Duplicate TransferIdentical transfer submitted 15 seconds ago
BTF-0203Already ProcessedThis initiation has already been processed

​
410

CodeTitleMessage
BTF-0202Initiation ExpiredInitiation expired after 24 hours. Create a new initiation.

​
422

CodeTitleMessage
BTF-0010Operating Hours ViolationTransfers can only be initiated Monday-Friday between 06:30 and 17:00 Brasília time
BTF-0011Limit ExceededTransfer amount exceeds daily limit
BTF-0204Cannot CancelTransfer cannot be cancelled in its current status. Only CREATED or PENDING transfers can be cancelled.

​
429

CodeTitleMessage
BTF-0900Rate Limit ExceededToo many requests. Retry after 60 seconds.

​
503

CodeTitleMessage
BTF-0501CRM Service UnavailableUnable to validate account. The CRM service is temporarily unavailable. Try again later.
BTF-1000JD SPB UnavailableUnable to submit transfer. The JD SPB service is temporarily unavailable. Try again later.
BTF-2000Midaz UnavailableUnable to process transfer. The Midaz ledger service is temporarily unavailable. Try again later.
BTF-3000Fee Service UnavailableUnable to calculate fee. The fee service is temporarily unavailable. Try again later.