Verificação de identidade na Costa Rica

A API de verificação de identidade da Verifik permite autenticar cidadãos costarriquenses usando dados oficiais do governo. Foi projetada para automatizar seus processos de KYC (Know Your Customer), prevenir fraudes e garantir o cumprimento de todos os requisitos regulatórios sem esforço.

Construímos esta integração para empresas que precisam de uma forma rápida, segura e automatizada de confirmar a verdadeira identidade de usuários, funcionários ou clientes.

O que esta API valida?

Nossa API conecta-se diretamente aos registros oficiais para validar:

• Nome completo e número da CCCR: suporta a Cédula de Identidad Costarricense (CCCR).
• Correspondência de identidade: confirma que o nome informado corresponde ao número da CCCR.

Ao validar esses elementos, você pode confiar que a pessoa com quem está negociando é real e possui um documento válido, reduzindo significativamente os riscos de personificação e fraude.

Referência da API

Endpoint

https://api.verifik.co/v2/cr/cedula

Este endpoint verifica a CCCR (Cédula de Identidad Costarricense) contra fontes oficiais. Envie documentType como CCCR e o documentNumber (número da cédula sem espaços) em uma requisição GET; a resposta inclui campos de nome estruturados para KYC, onboarding e verificações de fraude.

Cabeçalhos

Nome	Valor
Accept	application/json
Authorization	Bearer <token>

Parâmetros

Nome	Tipo	Obrigatório	Descrição
documentType	string	Sim	Tipo de documento. Valor permitido: CCCR.
documentNumber	string	Sim	Número da cédula sem espaços.

Requisição

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/cr/cedula", {
  params: { documentType: "CCCR", documentNumber: "123456789" },
  headers: { Accept: "application/json", Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` },
});
console.log(data);

PHP

<?php
$ch = curl_init("https://api.verifik.co/v2/cr/cedula");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Accept: application/json",
    "Authorization: Bearer " . getenv("VERIFIK_TOKEN")
]);
$query = http_build_query([
    "documentType" => "CCCR",
    "documentNumber" => "123456789"
]);
curl_setopt($ch, CURLOPT_URL, "https://api.verifik.co/v2/cr/cedula?".$query);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Python

import os, requests

url = "https://api.verifik.co/v2/cr/cedula"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CCCR", "documentNumber": "123456789"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Go

package main

import (
    "fmt"
    "net/http"
)

func main() {
    url := "https://api.verifik.co/v2/cr/cedula?documentType=CCCR&documentNumber=123456789"
    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Set("Accept", "application/json")
    req.Header.Set("Authorization", "Bearer "+getenv("VERIFIK_TOKEN"))
    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    fmt.Println(resp.Status)
}

Resposta

200

{
  "data": {
    "documentType": "CCCR",
    "documentNumber": "123456789",
    "firstName": "Ana",
    "lastName": "Rodríguez",
    "fullName": "Ana Rodríguez",
    "status": "valid"
  },
  "signature": {"message": "Certified by Verifik.co", "dateTime": "January 16, 2024 3:44 PM"},
  "id": "CR001"
}

400

{
  "message": "Invalid document number",
  "code": "INVALID_DOCUMENT"
}

401

{
  "message": "Authentication required",
  "code": "UNAUTHORIZED"
}

500

{
    "code": "InternalServerError",
    "message": "Server error."
}

Observações

• Informe o número sem espaços ou pontos.

---

Casos de uso comuns

• Fintech e bancos: verifique identidades instantaneamente durante a abertura de contas ou solicitações de empréstimo.
• E-commerce e entregas: autentique usuários e entregadores antes que se tornem ativos em sua plataforma.
• RH e recrutamento: valide documentos de candidatos como parte do seu fluxo de contratação.
• Seguros e saúde: confirme identidades antes de emitir apólices ou conceder benefícios médicos.

Fontes oficiais e confiabilidade

Conectamo-nos diretamente às fontes oficiais do governo costarriquense para garantir que você receba informações verificadas e atualizadas. Cada consulta é tratada com estrita aderência a padrões de segurança e regulação.

Principais benefícios

• Conformidade automatizada: simplifique seus controles de KYC para prevenir fraudes sem adicionar atrito para seus usuários.
• Resultados instantâneos: processe verificações em segundos, ideal para onboarding digital em tempo real.
• Dados confiáveis: apoie-se em dados obtidos diretamente dos registros oficiais.
• Integração simples: conecte-se facilmente via nossa API REST ou utilize nossos SDKs compatíveis.

Conformidade e segurança

Priorizamos a segurança dos seus dados. A Verifik utiliza criptografia avançada (HTTPS / TLS 1.3) e padrões rigorosos de gerenciamento de privacidade para garantir a confidencialidade. Nosso serviço é monitorado 24/7 quanto à disponibilidade e oferece controles de acesso baseados em funções para manter o acesso da sua equipe seguro.

Sobre a Verifik

A Verifik é uma plataforma líder em verificação de identidade, conformidade e prevenção a fraudes em toda a América Latina. Nossas APIs automatizam processos de KYC, KYB, AML e validação biométrica, conectando empresas a fontes de dados oficiais na Colômbia, México, Peru, Chile, Uruguai, Argentina, Brasil, Costa Rica e além.