Modelos de Erro

Visão geral

Os erros do ecossistema GoMoney aparecem em dois formatos principais:

• respostas da plataforma, usadas em customers e validações correlatas;
• respostas da camada PIX, usadas em autenticação PIX e cobranças.

Erro de autenticação da API PIX

Usado em cenários como credenciais inválidas no login da API PIX.

1
{
2
  "statusCode": 401,
3
  "timestamp": 1783188000000,
4
  "path": "/auth/login",
5
  "message": "Invalid user or password."
6
}

Erro genérico de autenticação

Usado quando a sessão ou a credencial de integração não são aceitas.

1
{
2
  "statusCode": 401,
3
  "message": "Invalid API access key"
4
}

Erro de validação

Usado quando o corpo enviado não respeita o contrato da operação.

1
{
2
  "statusCode": 400,
3
  "message": [
4
    "email must be an email"
5
  ],
6
  "error": "Bad Request"
7
}

Erro de negócio da plataforma

Usado quando o recurso existe, mas o usuário não pode operá-lo, ou quando o recurso não foi encontrado.

1
{
2
  "statusCode": 403,
3
  "message": "You do not have access to this customer"
4
}

1
{
2
  "statusCode": 404,
3
  "message": "Customer not found"
4
}

Erro da camada PIX

Usado quando a camada PIX retorna um código interno específico do fluxo.

1
{
2
  "statusCode": 400,
3
  "path": "/pix/create/brl",
4
  "code": "ERR13",
5
  "message": "Payer > Document Number is not a valid CNPJ or CPF"
6
}

Mapeamento prático por cenário

Como tratar no integrador

• registrar o código HTTP e, quando existir, o código interno do fluxo PIX;
• armazenar o caminho chamado e o identificador operacional da transação;
• evitar retentativas automáticas para erros de autenticação e validação;
• usar retentativa controlada apenas em indisponibilidades transitórias.