API de Verificação do Crédito na Suíça (PT-PT)

A integração de utilizadores na Suíça implica confirmar que são quem dizem ser. Dados de cabeçalho de crédito obtidos do Gabinete de Crédito na Suíça. Um documento ou um detalhe digitado apenas prova que os dados existem — não que são genuínos ou pertencem à pessoa à sua frente. A Verificação do Gabinete de Crédito Suíço preenche essa lacuna, verificando os dados contra o ficheiro de identidade de um gabinete de crédito nacional. Este guia explica o que a verificação faz, os detalhes técnicos exatos e como integrá-la em minutos.

Principais pontos:

• O que verifica — A Verificação do Gabinete de Crédito Suíço valida a identidade do ficheiro de crédito contra o ficheiro de identidade de um gabinete de crédito nacional.
• O que obtém — um match_type normalizado, mais resultados ao nível do campo que pode encaminhar diretamente para a lógica de aprovação / revisão / rejeição.
• Porquê é importante — Os dados de identidade do gabinete de crédito são aprofundados e bem mantidos, tornando-os uma forte fonte oficial para confirmar que um requerente existe com a identidade e morada declaradas.
• Como usar — um único POST para o endpoint de validação de base de dados da Didit, ou um módulo de fluxo de trabalho sem código. 1,05 $ por consulta conclusiva, resultados em segundos.

O que a Verificação do Gabinete de Crédito Suíço valida

Dados de cabeçalho de crédito obtidos do Gabinete de Crédito na Suíça. A Didit expõe-os através de um único endpoint para que possa verificar os dados submetidos contra o ficheiro de identidade de um gabinete de crédito nacional e receber um resultado estruturado e normalizado — não um despejo de registo bruto que tenha de analisar você mesmo.

Uma resposta conclusiva devolve os source_data correspondentes e um bloco de validation por campo, para que o seu motor de risco obtenha um veredito claro e legível por máquina.

Porquê é importante

Os dados de identidade do gabinete de crédito são aprofundados e bem mantidos, tornando-os uma forte fonte oficial para confirmar que um requerente existe com a identidade e morada declaradas.

Para empresas regulamentadas na Suíça — fintechs, plataformas de criptomoedas, credores, mercados e operadores de jogos — a verificação contra uma fonte oficial produz um registo defensável e auditável de que a identidade foi confirmada na fonte, e não apenas capturada de um formulário ou de uma fotografia.

Detalhes técnicos

A Didit expõe este serviço através do endpoint unificado de validação de base de dados. É um único POST — não é necessário SDK.

Endpoint

POST /v3/database-validation/

Parâmetros do pedido

Parâmetro	Tipo	Obrigatório	Descrição
issuing_state	string	Sim	Código do país ISO 3166-1 alfa-3. Use CHE.
services	string	Sim	Identificador do serviço. Use che_credit_bureau.
first_name	string	Sim	Primeiro nome.
last_name	string	Sim	Último nome.
date_of_birth	string	Sim	Data de nascimento.
address	string	Sim	Morada.

Exemplo de pedido

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=CHE" \
  -F "services=che_credit_bureau" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01" \
  -F "address=123 Sample Street, Sample City, 10001"

Exemplo de resposta (correspondência conclusiva)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "CHE",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "che_credit_bureau",
      "service_name": "Switzerland Credit Bureau",
      "source_data": {
        "address": "123 Sample Street",
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "last_name": "Doe"
      },
      "validation": {
        "address": "full_match",
        "date_of_birth": "full_match",
        "full_name": "full_match"
      }
    }
  ]
}

Desempenho e faturação

• Latência: geralmente alguns segundos.
• Custo: 1,05 $ por consulta conclusiva. É faturado apenas pelos resultados conclusivos — sem custo por tempo de inatividade da fonte, campos em falta ou rejeições pré-fonte.
• Fiabilidade: funciona na infraestrutura da Didit com um objetivo de 99,9% de tempo de atividade trimestral.
• Consentimento: este serviço requer consentimento documentado do utilizador final. Capture e armazene-o antes de chamar o endpoint.

Casos de uso

• Fintech e neobancos — confirme um titular de conta real e verificável antes de abrir uma carteira ou conceder crédito na Suíça.
• Crypto e Web3 — cumpra os requisitos de integração VASP com prova de identidade de fonte autoritativa.
• Empréstimos — reduza a fraude de identidade sintética e de primeira parte com dados verificados na fonte.
• Mercados e plataformas de trabalho temporário — verifique os utilizadores com dados autoritativos, e não apenas um formulário auto-reportado.
• iGaming — satisfaça as verificações de identidade e elegibilidade para jogadores suíços com um rasto auditável.

Como integrar com a Didit

Pode executar a Verificação do Gabinete de Crédito Suíço de duas maneiras:

1. Fluxo de trabalho sem código. Na Consola de Negócios Didit, abra o Construtor de Fluxos de Trabalho, adicione o módulo Validação de Base de Dados, selecione Suíça → Verificação do Gabinete de Crédito Suíço e ative-o. Os utilizadores correspondentes são encaminhados automaticamente — sem necessidade de engenharia.
2. API Direta. Chame o endpoint /v3/database-validation/ mostrado acima com services=che_credit_bureau. Leia match_type e o bloco de validation por campo para conduzir a sua lógica de aprovação / revisão / rejeição.

Cada conta Didit inclui 500 verificações gratuitas por mês, para que possa testar o fluxo completo de ponta a ponta antes de pagar por uma única consulta.

Perguntas frequentes

O que a Verificação do Gabinete de Crédito Suíço confirma?

Valida os dados submetidos contra o ficheiro de identidade de um gabinete de crédito nacional e devolve um resultado de correspondência normalizado, para que saiba se a identidade do ficheiro de crédito existe na fonte autoritativa e quais os campos que corresponderam.

O que acontece se a fonte estiver temporariamente indisponível?

Não é cobrado. A faturação aplica-se apenas a resultados conclusivos — tempo de inatividade da fonte, campos em falta e rejeições pré-fonte são gratuitos.

Qual a rapidez da verificação?

A validação da base de dados geralmente retorna em alguns segundos, por isso encaixa num fluxo de integração em tempo real.

Preciso de um SDK?

Não. A verificação é um único POST HTTPS para um endpoint. Também pode integrá-lo num fluxo de trabalho sem código na Consola de Negócios.

Pronto para começar?

Valide hoje a sua primeira identidade de ficheiro de crédito suíço.

• Leia a referência da API: Verificação do Gabinete de Crédito Suíço
• Veja todas as validações de base de dados: Preços e cobertura da Validação de Base de Dados
• Comece a construir: Crie uma conta Didit gratuita — 500 verificações por mês, gratuitas.