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
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.
status
Estornado por fraudeO pagamento foi identificado como fraudulento e estornado. Este é um estado final e não pode ser revertido.
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).