Pular para o conteúdo principal
Formato de erro 
{
   "code": "<error_code>",
   "title": "<error_title>",
   "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.
  • title – Um resumo curto e legível do problema.
  • 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-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.