Solicitação De Consulta

A API de consulta de débitos veiculares permite que o cliente consulte os débitos de um veículo a partir de um fluxo assíncrono.

Antes de realizar uma consulta, você deverá cadastrar uma URL para receber as atualizações de status da pesquisa via webhook através deste endpoint.

Neste link você poderá encontrar um guia com maiores detalhes de como cadastrar um endpoint webhook para receber os resultados da sua pesquisa.

Ao realizar a requisição com sucesso, você receberá um código através do campo request_id. Segundos depois, você receberá um webhook com o resultado da pesquisa e poderá usar esse código como rastreio.

Eventos de Pesquisa de Débitos Veiculares que poderão ser enviados via webhook

EventoDescrição
vehicle_debts_foundForam encontrados débitos para o veículo pesquisado.
vehicle_debt_not_foundNão foram encontrados débitos para o veículo pesquisado.
vehicle_not_foundO veículo informado não foi encotrado.
vehicle_debt_search_errorHouve algum erro ao tentar realizar a pesquisa de débitos do veículo (Detalhes serão informados no corpo do evento)
vehicle_enriched_partiallyA pesquisa não foi concluída porque não foi possível encontrar dados adicionais do veículo.

Em nosso guia de uso, você poderá encontrar exemplos de payloads que seu endpoint receberá de acordo com cada um dos eventos listados acima.

Para testar o comportamento dessa API e diferentes tipos de retorno em ambiente sandbox, separamos um conjunto de placas de testes para você neste link.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Placa do veículo em formato alfanumérico

Sigla do estado em que o veículo encontra-se emplacado. Ex: SP

Renavam do veículo, é um número contendo até 11 dígitos

Chassí do veículo

Còdigo de uma solicitação de pesquisa anterior, informe quando a pesquisa original resultou na solicitação de dados adicionais

customer

Informações do proprietário do veículo como Documento, Telefone ou email

extra_data

Conjunto de dados personalizáveis e complementares a pesquisa. Seu uso deve ser acordado previamente com a Zapay, pois alguns dados podem alterar o comportamento esperado da aplicação.

ID do estabelecimento

Responses

Language
Credentials
Basic
base64
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json