Saltar al contenido principal
Formato de error 
{
  "error": {
    "code": "<error_code>",
    "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.
  • 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-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.