Skip to main content

Schemas da API

Esta página contém a documentação detalhada de todos os modelos de dados utilizados na API Autorizou.

OrderRequest

string
required
Código MCC do pedido
string
required
Código da venda no estabelecimento
string
Descrição do pedido
object
required
object
required

CustomerRequest

string
required
Nome do cliente
string
required
Email do cliente
array
required
array
object

CardRequest

string
required
Dados do cartão criptografados
string
required
ID do cliente

RefundRequest

string
required
ID do pagamento
integer
required
Valor em centavos

Error

string
required
Código do erro
string
required
Mensagem de erro

Payment Status (Status de Pagamento)

Os pagamentos na Autorizou seguem um ciclo de vida com diferentes status. Cada status representa uma etapa específica no processamento do pagamento.

Status Gerais

status
Pagamento autorizado com sucessoO pagamento foi aprovado pela instituição financeira. Para cartão de crédito com captura automática, o valor foi capturado. Para PIX Recorrente, indica que a cobrança foi bem-sucedida.
status
Aguardando pagamento do cliente
  • Boleto: Aguardando pagamento do boleto bancário
  • PIX: Aguardando escaneamento do QR Code
  • PIX Recorrente: Aguardando primeiro pagamento para autorizar recorrência
status
Pagamento em processamentoO pagamento está sendo processado pela adquirente. Comum em PIX Recorrente quando a cobrança é enviada para a Adyen (2 dias antes do vencimento).
status
Pagamento recusadoO pagamento foi negado pela instituição financeira.Motivos comuns:
  • Saldo insuficiente
  • Cartão bloqueado ou vencido
  • Limite de crédito excedido
  • Dados inválidos
  • Suspeita de fraude
PIX Recorrente: Se retry_policy = true, o sistema tentará novamente automaticamente (até 3 vezes).
status
Pagamento expiradoO prazo expirou sem que o cliente concluísse o pagamento.
  • Boleto: Passou da data de vencimento
  • PIX: QR Code expirou
  • PIX Recorrente: QR Code inicial não foi pago no prazo
status
Pagamento agendadoExclusivo para PIX Recorrente. O pagamento foi agendado para ser processado em uma data futura. Ocorre 3 dias antes da data de cobrança. Utilizado para a primeira cobrança de assinaturas com trial e para posteriores cobranças.
status
Pagamento estornadoO valor foi devolvido ao cliente completamente. Este é um estado final.
status
Pagamento estornado parcialmenteParte do valor foi devolvida ao cliente. O pagamento pode receber estornos adicionais até o valor total.
status
Estornado por chargebackO pagamento foi estornado devido a um chargeback. Este é um estado final e não pode ser revertido.
Chargebacks impactam negativamente a reputação do merchant junto às adquirentes e podem resultar em taxas adicionais.
status
Estornado por fraudeO pagamento foi identificado como fraudulento e estornado. Este é um estado final e não pode ser revertido.
Este status indica fraude confirmada. Revise seus processos de prevenção antifraude.
status
Estorno solicitadoUm estorno foi solicitado e está sendo processado. Aguardando confirmação da adquirente.
status
Chargeback confirmadoO cliente contestou a cobrança junto ao banco e o chargeback foi confirmado. O valor foi revertido.
status
Notificação de chargebackUm chargeback foi iniciado pelo cliente. Você tem prazo limitado para contestar (geralmente 7-10 dias).
status
Em disputaHá uma disputa ativa sobre o pagamento. Aguardando resolução.
status
Pagamento liquidadoO pagamento foi processado e liquidado. O valor está disponível para transferência.
status
Enviado para liquidaçãoO pagamento foi enviado para o processo de liquidação (settlement). Em breve estará disponível.
status
Erro no processamentoOcorreu um erro técnico durante o processamento. Entre em contato com o suporte se o erro persistir.
status
Autenticação solicitadaPara cartão de crédito com 3D Secure, indica que o cliente precisa completar a autenticação adicional.

Transições de Status

Os status seguem regras específicas de transição. Nem todos os status podem mudar para qualquer outro status.

Fluxo PIX Recorrente

Fluxo Cartão de Crédito

Fluxo PIX / Boleto

Respostas de erro

Guie-se sempre pelo status HTTP. O corpo de erro traz uma mensagem legível e, em erros de validação (422), um objeto errors com a lista por campo:
O Idempotency-Key obrigatório nas cobranças responde 400 quando ausente e 409 em conflito de chave (com header Retry-After quando a primeira requisição ainda está em processamento).