Pular para o conteúdo principal
Formato de erro 
{
  "error": {
    "code": "<error_code>",
    "message": "<error_message>"
  }
}
Definição dos campos
  • code – Um identificador estável e único para o erro. Útil para tratamento programático e solicitações de suporte.
  • message – Orientação detalhada para ajudar você a resolver o erro.
Essa estrutura garante que você sempre receba feedback acionável quando algo não ocorre como esperado.

​
Erros do Bank Transfer (TED)

Os seguintes erros podem ocorrer ao interagir com os endpoints do Bank Transfer (TED). Cada erro segue nossa estrutura padrão, facilitando a depuração e a resposta a problemas de forma programática. Consulte as tabelas abaixo para obter uma lista dos possíveis códigos de erro, o que eles significam e como resolvê-los.

​
400

codetitlemessage
BTF-0001Invalid InputThe request contains invalid fields. Check the field details below.
BTF-0400Missing Organization HeaderX-Tenant-Id header is required

​
401

codetitlemessage
BTF-0401UnauthorizedAuthentication failed. The token is missing, invalid, or expired.

​
403

codetitlemessage
BTF-0403License InvalidOrganization is not licensed. Contact support to activate your license.
BTF-0405ForbiddenInsufficient permissions to perform this action.

​
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 TransferDuplicate transfer detected
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.
BTF-0501CRM Invalid ResponseThe CRM account record is missing a required field (organizationId). Contact your platform team to fix the account data in the CRM.
BTF-1001JD SPB RejectedTransfer rejected by JD SPB. Review the transfer details and try again.
BTF-1002JD SPB Invalid MessageInvalid transfer message format for JD SPB. Check the request payload.

​
500

codetitlemessage
BTF-9000Internal ErrorAn unexpected error occurred. Contact support if it persists.

​
502

codetitlemessage
BTF-3001Fees Invalid ResponseThe fee service returned an invalid or unparseable response. Contact your platform team.

​
503

codetitlemessage
BTF-0502CRM 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.