Saltar al contenido principal
Formato de error 
{
   "code": "<error_code>",
   "title": "<error_title>",
   "message": "<error_message>"
}
Definición de campos
  • code – Un identificador estable y único para el error. Útil para manejo programático y solicitudes de soporte.
  • title – Un resumen corto y legible del problema.
  • message – Orientación detallada para ayudarte a resolver el error.
Esta estructura garantiza que siempre recibas retroalimentación accionable cuando algo no sale como esperado.

​
Errores de Bank Transfer (TED)

Los siguientes errores pueden ocurrir al interactuar con los endpoints de Bank Transfer (TED). Cada error sigue nuestra estructura estándar, facilitando la depuración y la respuesta a problemas de forma programática. Consulte las tablas a continuación para obtener una lista de los posibles códigos de error, su significado y cómo resolverlos.

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