Códigos de resposta HTTP

Esta seção descreve os códigos de erro comuns e as resoluções que você pode encontrar ao usar a API Yuno.

O Yuno usa códigos de resposta HTTP padrão para indicar o sucesso ou a falha das solicitações de API.

Os códigos no intervalo 2xx geralmente indicam sucesso. Os códigos no intervalo 4xx indicam um erro que ocorreu com base nas informações fornecidas (por exemplo, um parâmetro ausente etc.) e os códigos no intervalo 5xx indicam um erro interno.

Exemplo

{
  "code": "INVALID_REQUEST",
  "messages": [
    "Invalid request."
  ]
}

Atributos de resposta para erros

code string
Atributo para o estado do código de erro.

message matriz de cadeias de caracteres
Mensagem de erro que é retornada.

Veja quais códigos são retornados pela API Rest da Yuno.

Código de status HTTP	Código	Descrição
400 Solicitação incorreta	`INVALID_REQUEST`	Solicitação inválida.
	`INVALID_PARAMETERS`	Parâmetros inválidos: lista - [nome_do_parâmetro].
	`MISSING_PARAMETERS`	Parâmetros ausentes: lista - [nome_do_parâmetro].
	`INVALID_STATUS`	Status de transação inválido.
	`COUNTRY_NOT_SUPPORTED`	País não suportado.
	`CURRENCY_NOT_ALLOWED`	A moeda não é permitida para esse país.
	`CUSTOMER_ID_DUPLICATED`	O ID do cliente para o comerciante está duplicado.
	`INVALID_AMOUNT`	Valor inválido para o método de pagamento.
	`INVALID_ACCOUNT_ID`	ID da conta de Yuno inválido
	`INVALID_TRANSACTION`	ID de transação inválido
	`INVALID_API_VERSION`	Versão inválida da API.
	`INVALID_TRANSACTION_TYPE`	Tipo de transação inválido para a solicitação.
	`CHARGEBACK_IN_PROCESS`	Chargeback em vigor para essa transação.
	`UNAVAILABLE_PAYMENT_METHOD`	Método de pagamento indisponível.
	`NOT_FOUND`	Recurso não encontrado.
	`UNEXPECTED_RESPONSE`	Resposta inesperada do serviço.
	`BAD_REQUEST`	Houve um erro grave ao executar a solicitação.
	`INVALID_REPORT_ID`	O ID do relatório deve ser UUID.
	`INVALID_REPORT_TYPE`	Tipo de relatório inválido.
	`INVALID_DATE_FORMAT`	O formato da data de início/fim deve ser aaaa-MM-dd'T'HH:mm:ss.SSS'Z'.
	`REPORT_MAX_RANGE_ERROR`	A data máxima do intervalo é de dois meses.
	`REPORT_RANGE_ERROR`	A data de início deve ser anterior à data de término. A data de início/fim deve ser posterior à data atual.
	`REPORT_STATUS_ERROR`	O relatório ainda não está pronto, o status é %s.
	`REPORT_EMPTY`	O relatório solicitado está vazio.
	`PAYMENT_METHOD_NOT_FOUND`	[For Subscriptions] - Método de pagamento associado ao cliente não encontrado
	`PAYMENT_METHOD_STATUS_INVALID`	[Para assinaturas] - O método de pagamento é um estado que não permite a realização de pagamentos.
	`INCORRECT_PAYMENT_METHOD_TYPE`	[Para assinaturas] - O tipo de método de pagamento da solicitação não corresponde ao vaulted_token.
	`SUBSCRIPTION_NOT_FOUND`	[Para assinaturas] - Assinatura não encontrada.
	`INVALID_STATE`	[Para assinaturas] - O estado da assinatura não suporta a ação solicitada.
	`INVALID_DATE`	[Para assinaturas] - A assinatura não pode ser retomada devido a um conflito com as datas de disponibilidade. Atualize as datas de disponibilidade e tente novamente se quiser continuar usando a assinatura
	`INVALID_PARAMETERS`	[For Subscriptions] - Parâmetros inválidos: list - [parameter_name].
	`INVALID_CUSTOMER_FOR_TOKEN`	O token usado para essa transação está associado a outro objeto de cliente.
	`PAYMENT_NOT_FOUND`	Pagamento não encontrado.
	`TRANSACTION_NOT_FOUND`	Transação de pagamento não encontrada
	`CUSTOMER_NOT_FOUND`	Cliente não encontrado
	`CHECKOUT_SESSION_NOT_FOUND`	Sessão de checkout não encontrada ou inativa
	`REPORT_NOT_FOUND`	ID do relatório não encontrado
	`IDEMPOTENCY_DUPLICATED`	A idempotência é duplicada.
401 Não autorizado	`INVALID_CREDENTIALS`	Credenciais inválidas.
	`EXPIRED_CREDENTIALS`	Credenciais expiradas.
	`UNKNOWN_IP_ADDRESS`	Endereço IP não registrado.
	`INVALID_TOKEN`	Token inválido.
	`TOKEN_IN_USE`	O token fornecido está sendo usado atualmente em outra solicitação.
403 Proibido	`AUTHORIZATION_REQUIRED`	O comerciante não tem autorização para usar essa API.
405 Método não permitido	`UNSUPPORTED_METHOD`	Método não suportado.
Erro interno do servidor 500	`INTERNAL_ERROR`	Erro interno.
504 Tempo limite Gateway	`REQUEST_TIMEOUT`	Tempo limite da solicitação.