> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Verificação de propriedade de veículo na África do Sul > Consulte a propriedade de veículos na África do Sul em base oficial via Didit. A partir de $3.36 por chamada, sem contratos nem mínimos. Confirma que uma pessoa sul-africana é a proprietária registrada de um determinado veículo por meio do registro de veículos NATIS. A Didit disponibiliza este serviço pelo `POST /v3/database-validation/`, para que você verifique os dados enviados na fonte oficial e receba resultados de correspondência normalizados. ## Cobertura * **Cobertura:** — * **País:** África do Sul * **ID do serviço:** `zaf_vehicle_ownership` * **Domínio de dados:** Governo * **Categoria:** Outros ## Entradas | Campo | Obrigatório | Exemplo | | - | -: | - | | `national_id` | Sim | `SAMPLE-NID-12345` | | `vehicle_register_number` | Sim | `VRN123456` | | `vehicle_licence_plate` | Sim | `ABC123GP` | | `vin` | Sim | `1HGCM82633A004352` | | `vendor_data` | Não | `user-1234` | * **Entradas obrigatórias:** `national_id`, `vehicle_register_number`, `vehicle_licence_plate`, `vin` * **Entradas opcionais:** `vendor_data` * **Consentimento:** Não obrigatório * **Disponibilidade no fluxo:** Disponível no fluxo de verificação (workflow) com mapeamento de campos * **Cobertura:** — * **Preço:** \$3.36 por consulta bem-sucedida Em um fluxo, `vehicle_register_number`, `vehicle_licence_plate` e `vin` não aparecem impressos em um documento de identidade, então nenhuma etapa os gera por conta própria. Colete esses valores em uma resposta ao Questionário, de um campo de extração do Document AI ou de um valor que você envia ao criar a sessão, e mapeie cada um deles na etapa de Validação de banco de dados. Enquanto não forem mapeados, o editor de fluxos mostra este serviço desativado e indica a entrada ausente; durante a execução, uma entrada ausente faz com que a verificação seja ignorada antes de qualquer consulta, então você nunca é cobrado por um banco de dados que não pôde ser consultado. ## Parâmetros do corpo **issuing\_state** `string` *required* (default: ZAF) Código de país ISO 3166-1 alfa-3 deste serviço de banco de dados. Exemplo: `ZAF` **services** `string` *required* (default: zaf\_vehicle\_ownership) Array que contém este ID de serviço. Fixar o serviço mantém a requisição restrita a este banco de dados específico. Exemplo: `zaf_vehicle_ownership` **national\_id** `string` *required* (default: SAMPLE-NID-12345) Número de identidade nacional para este serviço. Exemplo: `SAMPLE-NID-12345` **vehicle\_register\_number** `string` *required* (default: VRN123456) Valor de `vehicle_register_number` exigido por este serviço de banco de dados. Exemplo: `VRN123456` **vehicle\_licence\_plate** `string` *required* (default: ABC123GP) Valor de `vehicle_licence_plate` exigido por este serviço de banco de dados. Exemplo: `ABC123GP` **vin** `string` *required* (default: 1HGCM82633A004352) Valor de `vin` exigido por este serviço de banco de dados. Exemplo: `1HGCM82633A004352` **vendor\_data** `string` (default: user-1234) Sua referência estável de usuário para esta pessoa, como o seu ID interno de usuário. A Didit a usa para vincular verificações avulsas ao mesmo usuário final e reduzir o ruído na detecção de duplicados. Exemplo: `user-1234` ## Regras de entrada e notas de validação * Envie os campos listados acima exatamente como foram capturados do usuário ou do documento. * A Didit valida os campos obrigatórios antes de chamar o banco de dados. Requisições rejeitadas antes da consulta à fonte não são cobradas. ## Como fazer a chamada ```bash cURL theme={null} curl -X POST "https://verification.didit.me/v3/database-validation/" \ -H "x-api-key: YOUR_API_KEY" \ -F "issuing_state=ZAF" \ -F "services=zaf_vehicle_ownership" \ -F "vendor_data=user-1234" \ -F "national_id=SAMPLE-NID-12345" \ -F "vehicle_register_number=VRN123456" \ -F "vehicle_licence_plate=ABC123GP" \ -F "vin=1HGCM82633A004352" ``` Toda chamada bem-sucedida retorna HTTP `200`. O campo **`outcome_code`** informa o que de fato aconteceu, distinguindo, por exemplo, uma divergência biométrica real (`BIOMETRIC_NO_MATCH`) de uma selfie que não pôde ser lida (`BIOMETRIC_IMAGE_UNUSABLE`). O `status` exibido é o status padrão do recurso; as [ações de Partial Match / No Match](https://docs.didit.me/pt-br/core-technology/database-validation/database-validation-warnings.md) que você configurou podem substituí-lo. **`MATCH`**: o registro confirmou a identidade e todos os campos verificados corresponderam. ```json 200 OK — MATCH theme={null} { "request_id": "req_01H…", "status": "Approved", "issuing_state": "ZAF", "match_type": "full_match", "validations": [ { "outcome_code": "MATCH", "service_id": "zaf_vehicle_ownership", "service_name": "South Africa - Vehicle Ownership Verification", "source_data": { "identification_number": "SAMPLE-ID-12345" }, "validation": { "identification_number": "full_match" } } ] } ``` **`NO_MATCH`**: o registro não retornou nenhuma correspondência para os dados enviados. ```json 200 OK — NO_MATCH theme={null} { "request_id": "req_01H…", "status": "Declined", "issuing_state": "ZAF", "match_type": "no_match", "validations": [ { "outcome_code": "NO_MATCH", "service_id": "zaf_vehicle_ownership", "service_name": "South Africa - Vehicle Ownership Verification", "source_data": { "identification_number": "NO_MATCH" }, "validation": { "identification_number": "no_match" } } ] } ``` ## Dados retornados Os campos exatos exibidos em `source_data` dependem dos dados retornados pelo registro. O exemplo gerado para `zaf_vehicle_ownership` documenta atualmente este formato normalizado: * `identification_number` ## Preços e SLAs As consultas de Verificação de propriedade de veículo na África do Sul são cobradas apenas quando a Didit recebe um resultado conclusivo da fonte de validação. * **Preço por chamada:** \$3.36 USD. * **Faturamento:** por consulta bem-sucedida. Você não é cobrado quando o registro está inacessível, quando faltam campos obrigatórios ou quando a requisição é rejeitada antes de chegar à fonte. * **Latência:** p95 típico \< 2 s. * **Disponibilidade:** 99.9% por trimestre do lado da Didit; a disponibilidade da fonte externa varia conforme o país e o conjunto de dados. ## Continue lendo * [Visão geral da Validação de banco de dados na África do Sul](https://docs.didit.me/api-reference/database-validation/south-africa.md) * [Visão geral da Validação de banco de dados](https://docs.didit.me/pt-br/core-technology/database-validation/overview.md) * [Códigos de resultado](https://docs.didit.me/pt-br/core-technology/database-validation/database-validation-outcome-codes.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.