> ## Documentation Index > Fetch the complete documentation index at: https://docs.autorizou.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Schemas > Referência dos modelos de dados da API Autorizou # Schemas da API Esta página contém a documentação detalhada de todos os modelos de dados utilizados na API Autorizou. ## OrderRequest Código MCC da transação Código da venda no estabelecimento Descrição da transação ID do cliente Valor em centavos Moeda da transação Método de pagamento Número de parcelas ID do cartão Descrição que aparecerá na fatura Se a transação deve ser capturada automaticamente ## CustomerRequest Nome do cliente Email do cliente Tipo do documento Valor do documento Tipo do endereço CEP Logradouro Complemento Número Bairro Cidade Estado País Tipo do telefone DDI DDD Número ## CardRequest Dados do cartão criptografados ID do cliente ## RefundRequest ID do pagamento Valor em centavos ## Error Código do erro 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 **Pagamento autorizado com sucesso** O 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. **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 **Pagamento em processamento** O pagamento está sendo processado pela adquirente. Comum em PIX Recorrente quando a cobrança é enviada para a Adyen (2 dias antes do vencimento). **Pagamento recusado** O 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). **Pagamento expirado** O prazo para pagamento expirou sem que o cliente tenha completado a transação. * **Boleto:** Passou da data de vencimento * **PIX:** QR Code expirou * **PIX Recorrente:** QR Code inicial não foi pago no prazo **Pagamento agendado** **Exclusivo 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. **Pagamento estornado** O valor foi devolvido ao cliente completamente. Este é um estado final. **Pagamento estornado parcialmente** Parte do valor foi devolvida ao cliente. O pagamento pode receber estornos adicionais até o valor total. **Estornado por chargeback** O 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. **Estornado por fraude** O 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. **Estorno solicitado** Um estorno foi solicitado e está sendo processado. Aguardando confirmação da adquirente. **Chargeback confirmado** O cliente contestou a cobrança junto ao banco e o chargeback foi confirmado. O valor foi revertido. **Notificação de chargeback** Um chargeback foi iniciado pelo cliente. Você tem prazo limitado para contestar (geralmente 7-10 dias). **Em disputa** Há uma disputa ativa sobre o pagamento. Aguardando resolução. **Pagamento liquidado** O pagamento foi processado e liquidado. O valor está disponível para transferência. **Enviado para liquidação** O pagamento foi enviado para o processo de liquidação (settlement). Em breve estará disponível. **Erro no processamento** Ocorreu um erro técnico durante o processamento. Entre em contato com o suporte se o erro persistir. **Autenticação solicitada** Para 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 ``` Primeiro pagamento: waiting_payment → authorized → settled waiting_payment → expired Cobranças recorrentes: scheduled → waiting_payment → authorized → settled scheduled → waiting_payment → refused → scheduled (retry automático) scheduled → error ``` #### Fluxo Cartão de Crédito ``` processing → authorized → sent_for_settle → settled processing → refused authorized → refund_requested → refunded authorized → chargeback_notification → chargeback ``` #### Fluxo PIX / Boleto ``` waiting_payment → authorized → sent_for_settle → settled waiting_payment → expired authorized → refund_requested → refunded ``` ## 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: ```json theme={null} { "message": "Pagamento não encontrado." } ``` ```json theme={null} { "message": "The given data was invalid.", "errors": { "email": ["O campo email é obrigatório."] } } ``` 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).