Códigos de erro

Objeto de erroPerguntar à Athia sobre isto#

{
  "error": {
    "code": "PAYMENT_DECLINED",
    "message": "The payment was declined by the payment provider.",
    "decline_reason": "insufficient_funds",
    "request_id": "req_7Hc2LqP",
    "doc_url": "/errors#payment-declined"
  }
}

• code — Identificador estável para usar na lógica de tratamento.
• message — Descrição em linguagem humana, pode mudar. Não tente analisá-la.
• request_id — Inclua-o ao entrar em contato com o suporte.

Referência de erroPerguntar à Athia sobre isto#

{
  "error": {
    "code": "PAYMENT_DECLINED",
    "decline_reason": "insufficient_funds",
    "request_id": "req_7Hc2LqP"
  }
}

{
  "error": {
    "code": "CARD_EXPIRED",
    "request_id": "req_2Pb8XwQ"
  }
}

{
  "error": {
    "code": "INVALID_REQUEST",
    "param": "amount",
    "message": "amount must be an integer."
  }
}

{
  "error": {
    "code": "AUTHENTICATION_FAILED",
    "request_id": "req_9Qd1MnZ"
  }
}

{
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "param": "id"
  }
}

{
  "error": {
    "code": "IDEMPOTENCY_CONFLICT",
    "request_id": "req_4Tr6VbS"
  }
}

{
  "error": "rate_limit_exceeded",
  "message": "maximum requests",
  "code": 429,
  "endpoint": "/merchants/orders",
  "total_requests": 101,
  "retry_after": "1s"
}

{
  "error": {
    "code": "PROVIDER_UNAVAILABLE",
    "routing": { "attempts": 2 }
  }
}

Catálogo de erros de pagamento e pedidoPerguntar à Athia sobre isto#

Este catálogo restaura o conjunto completo de códigos estáveis do antigo documento de referência de códigos. Os códigos atuais foram verificados em relação aos caminhos de código das APIs de pagamento e pedido; os códigos "legacy" permanecem listados para compatibilidade com versões anteriores. As mensagens podem variar; consulte o código em vez de tentar analisar o texto da mensagem.

Pedidos e checkout

Ciclo de vida do pedido, prontidão para o checkout, links de pagamento, arquivos e tratamento de solicitações.

Pagamentos

Validação, processamento, autenticação e operações de transação de pagamentos e respostas do provedor.

Respostas do comerciante

Erros retornados durante a validação das respostas do comerciante, da entrega e do cupom.

Prevenção de fraudes

Erros de avaliação de fraudes estáveis retornados nas operações de pagamento e pedido.

Tratamento de errosPerguntar à Athia sobre isto#

1. Baseado em error.code; registrar request_id.
2. Tentar novamente 5xx e 429 com repetição e sem alterações. Idempotency-Key.
3. Nunca tente novamente. 400, 401 ou 402 unchanged.