Status e erros

Status de transação

Status	Significado
`pending`	Aguardando pagamento.
`paid`	Pago.
`refused`	Recusado.
`canceled`	Cancelado.
`refund`	Estornado.
`chargeback`	Chargeback aberto.
`contest`	Em contestação.
`infraction`	Em análise de infração/fraude.
`expired`	Expirado (PIX).
`error`	Erro de processamento.
`waiting`	Aguardando ação assíncrona.

O PIX sempre nasce pending e passa a paid via webhook do adquirente. O cartão pode nascer paid, refused ou pending (quando o adquirente confirma de forma assíncrona).

Métodos de pagamento

Valor	Método
`pix`	PIX
`credit_card`	Cartão de crédito
`boleto`	Boleto

Códigos de erro

Erros seguem o formato:

{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "Documento inválido para o tipo selecionado"
}

Código	Significado	Causas comuns
`400`	Bad Request	Corpo inválido, documento (CPF/CNPJ) inválido, soma de `items` diferente de `amountInCents`.
`401`	Unauthorized	Credenciais inválidas, token ausente, expirado ou com sessão encerrada.
`403`	Forbidden	Acesso negado ao recurso.
`404`	Not Found	Recurso não encontrado.
`409`	Conflict	Conflito de estado (ex.: recurso duplicado).
`429`	Too Many Requests	Mais de 1000 requisições por minuto a partir da mesma origem.
`503`	Service Unavailable	Serviço temporariamente indisponível.

Motivos de recusa de cartão

O campo refuseReason (presente em respostas e webhooks de cartão recusado) pode conter:

Valor	Significado
`INSUFFICIENT_FUNDS`	Saldo insuficiente
`CARD_BLOCKED`	Cartão bloqueado
`INVALID_DATA`	Dados incorretos
`TIMEOUT`	Tempo esgotado
`EXPIRED_CARD`	Cartão expirado
`ANTIFRAUD_REJECTED`	Reprovado por antifraude
`OTHER`	Transação recusada (motivo genérico)

Introdução

Pagamentos

Assinaturas

Transações

Webhooks

Recursos

Status e erros

Status de transação

Métodos de pagamento

Códigos de erro

Motivos de recusa de cartão

​Status de transação

​Métodos de pagamento

​Códigos de erro

​Motivos de recusa de cartão

Status de transação

Métodos de pagamento

Códigos de erro

Motivos de recusa de cartão