Cancelamento
O cancelamento de uma operação de Crédito Auto pode ocorrer em três cenários distintos, cada um com um endpoint próprio. Em todos os casos, a alienação fiduciária / gravame é removida automaticamente do veículo após a confirmação do cancelamento.
| Cenário | Quando usar | Endpoint |
|---|---|---|
| Antes do desembolso | Operação criada mas ainda não desembolsada para a concessionária | PATCH /debt/{DEBT-KEY}/cancel |
| Devolução pela concessionária | Operação já desembolsada — a concessionária devolve o valor via Pix QR Code | POST /debt/reversal |
| Cancelamento permanente | Desistência definitiva da operação (encerramento sem possibilidade de reativação) | POST /debt/{DEBT-KEY}/cancel_permanently |
- Antes do desembolso
- Devolução via /debt/reversal
- Cancelamento permanente
Enquanto a operação ainda não foi desembolsada, é possível cancelá-la diretamente pelo endpoint PATCH /debt/{DEBT-KEY}/cancel. Como não há valor a ser devolvido (nenhum recurso saiu da QI Tech para a concessionária), o cancelamento é imediato.
A referência completa do endpoint, incluindo o response body, está em Cancelar dívida antes de desembolsar.
Use este endpoint sempre que a operação ainda não tenha sido desembolsada (status anterior ao desembolso à concessionária). Após o desembolso, utilize o fluxo de devolução via /debt/reversal.
Após o desembolso, o cancelamento se dá pela devolução do valor à QI Tech via Pix QR Code. No Crédito Auto, quem paga o QR Code é a concessionária (que recebeu o desembolso original), e não o tomador. Confirmado o pagamento, a operação é cancelada e a alienação/gravame é removida do veículo no SNG/Detran. Se a cessão já tiver ocorrido, o valor é estornado para o cessionário.
- Passo a passo
- Request
- Response
- O parceiro chama o endpoint
POST /debt/reversalinformando ocontract_numberda operação a ser cancelada. - A QI Tech responde com um Pix QR Code de devolução (
copy_paste_pix,amount,expiration_date). - O parceiro repassa o QR Code à concessionária (que recebeu o desembolso original).
- A concessionária paga o QR Code.
- Uma vez confirmado o pagamento, a operação é cancelada automaticamente e a alienação fiduciária / gravame é removida do veículo no SNG/Detran. Se a cessão já tiver ocorrido, o valor é estornado para o cessionário.
{
"contract_number": "0000049343/TW"
}
Campos opcionais: days_to_expire (dias corridos) ou workdays_to_expire (dias úteis) para customizar a expiração do QR Code (padrão: 14 dias úteis).
{
"amount": "10641.24",
"copy_paste_pix": "00020126930014br.gov.bcb.pix2571qrcode-...",
"expiration_date": "2025-05-24",
"payer_document_number": "98765432000100",
"payer_name": "CONCESSIONARIA EXEMPLO VEICULOS",
"reversal_key": "f98a1b7c-5e3c-4e6f-8887-c7fedfa0d5b5",
"status": "waiting_payment"
}
- Geração do Pix QR Code de devolução (
POST /debt/reversal) — referência completa do endpoint, incluindo campos e respostas de erro. - Consulta do Pix QR Code de devolução — para acompanhar o status do pagamento.
Para utilizar o endpoint é necessário solicitar à QI Tech a liberação e a configuração da conta de estorno do cessionário.
O cancelamento permanente encerra a operação de crédito de forma definitiva, sem possibilidade de reativação. Use este endpoint quando a desistência for definitiva e nenhum dos fluxos de retomada (reapresentação de conta, reenvio de documentos, etc.) for aplicável.
A referência completa do endpoint, incluindo o response body, está em Cancelar permanentemente.
Após o cancel_permanently, a operação não pode ser reativada. Avalie se as alternativas (/cancel antes do desembolso, ou /debt/reversal após) atendem ao seu caso de uso antes de utilizar este endpoint.