Documentation Index
Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
Use this file to discover all available pages before exploring further.
Formato de erro
{
"error": {
"code": "<error_code>",
"message": "<error_message>"
}
}
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
Os seguintes erros podem ocorrer ao interagir com os endpoints do Bank Transfer. 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
code | title | message |
|---|
| BTF-0001 | Invalid Input | The request contains invalid fields. Check the field details below. |
401
code | title | message |
|---|
| BTF-0401 | Unauthorized | Authentication failed. The token is missing, invalid, or expired. |
403
code | title | message |
|---|
| BTF-0403 | License Invalid | Organization is not licensed. Contact support to activate your license. |
| BTF-0405 | Forbidden | Insufficient permissions to perform this action. |
404
code | title | message |
|---|
| BTF-0200 | Transfer Not Found | Transfer not found |
| BTF-0201 | Initiation Not Found | Initiation not found or belongs to different organization |
| BTF-0500 | Account Not Found | Sender account does not exist in CRM |
409
code | title | message |
|---|
| BTF-0012 | Duplicate Transfer | Duplicate transfer detected |
| BTF-0203 | Already Processed | This initiation has already been processed |
410
code | title | message |
|---|
| BTF-0202 | Initiation Expired | Initiation expired after 24 hours. Create a new initiation. |
422
code | title | message |
|---|
| BTF-0010 | Operating Hours Violation | Transfers can only be initiated Monday-Friday between 06:30 and 17:00 Brasília time |
| BTF-0011 | Limit Exceeded | Transfer amount exceeds daily limit |
| BTF-0204 | Cannot Cancel | Transfer cannot be cancelled in its current status. Only CREATED or PENDING transfers can be cancelled. |
| BTF-0501 | CRM Invalid Response | The CRM account record is missing a required field (organizationId). Contact your platform team to fix the account data in the CRM. |
Os erros retornados pela integração com o JD SPB não são envelopados em códigos BTF-*. O código do fornecedor é propagado textualmente no campo error.code do envelope de erro HTTP (por exemplo, ACE95 para timeouts de requisição, AAC90 para rejeições por assinatura inválida, ALN01 para respostas de número de controle não encontrado). Consulte a documentação do fornecedor JD SPB para a lista completa e a política de retry correspondente a cada código.
500
code | title | message |
|---|
| BTF-9000 | Internal Error | An unexpected error occurred. Contact support if it persists. |
502
code | title | message |
|---|
| BTF-3001 | Fees Invalid Response | The fee service returned an invalid or unparseable response. Contact your platform team. |
503
code | title | message |
|---|
| BTF-0502 | CRM Service Unavailable | Unable to validate account. The CRM service is temporarily unavailable. Try again later. |
| BTF-2000 | Midaz Unavailable | Unable to process transfer. The Midaz ledger service is temporarily unavailable. Try again later. |
| BTF-3000 | Fee Service Unavailable | Unable to calculate fee. The fee service is temporarily unavailable. Try again later. |
