🏦

KYC Verification

Know Your Customer verification for financial services

Customer onboarding

Identity verification

Compliance checks

Visão Geral

Este guia mostra como implementar kyc verification usando a API Scorika. Cobriremos a integração completa com exemplos de código em vários idiomas.

Endpoints da API Utilizados

/v1/check/company
/v1/check/sanctions
/v1/check/vat
/v1/check/iban

Países Suportados

Czech Republic, Slovakia, Poland, European Union, United Kingdom, United States

Implementação Passo a Passo

1Verificar Identidade da Empresa

Comece verificando se a empresa existe no registro oficial:

curl -X POST https://api.scorika.com/v1/check/company \
  -H "X-Api-Key: sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"identifier": "27074358", "country": "CZ"}'

import requests

response = requests.post(
    "https://api.scorika.com/v1/check/company",
    headers={"X-Api-Key": "sk_live_your_api_key"},
    json={"identifier": "27074358", "country": "CZ"},
    timeout=5
)
company = response.json()["data"]
print(f"Company: {company['company_name']}")

const res = await fetch('https://api.scorika.com/v1/check/company', {
  method: 'POST',
  headers: {'X-Api-Key': 'sk_live_your_api_key', 'Content-Type': 'application/json'},
  body: JSON.stringify({identifier: '27074358', country: 'CZ'})
});
const company = (await res.json()).data;
console.log(`Company: ${company.company_name}`);

require 'net/http'
uri = URI('https://api.scorika.com/v1/check/company')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Post.new(uri)
req['X-Api-Key'] = 'sk_live_your_api_key'
req['Content-Type'] = 'application/json'
req.body = '{"identifier": "27074358", "country": "CZ"}'
puts http.request(req).body

2Verificar Listas de Sanções

Verifique a empresa em listas de sanções globais:

Verificar Listas de Sanções

# Check sanctionssanctions_response = requests.post(  "https://api.scorika.com/v1/check/sanctions",  headers={"X-Api-Key": "sk_live_your_api_key"},  json={"name": company["company_name"], "country": "CZ"},  timeout=5)sanctions = sanctions_response.json()["data"]if sanctions["matches"]:  raise ValueError(f"Sanctions match: {sanctions['matches']}")

3Validar Número de IVA

Verifique o número de IVA da empresa através do VIES da UE:

Validar Número de IVA

# Validate VATvat_response = requests.post(  "https://api.scorika.com/v1/check/vat",  headers={"X-Api-Key": "sk_live_your_api_key"},  json={"vat_id": company.get("vat_id")},  timeout=5)vat = vat_response.json()["data"]if not vat["valid"]:  raise ValueError("Invalid VAT number")

4Complete KYC Workflow

Combine all checks into a complete KYC workflow:

Complete KYC Workflow

import requestsfrom typing import Dict, Anydef perform_kyc_verification(company_id: str, country: str) -> Dict[str, Any]:    """Complete KYC verification workflow."""    api_key = "sk_live_your_api_key"    base_url = "https://api.scorika.com"        results = {        "company_verified": False,        "sanctions_clear": False,        "vat_valid": False,        "errors": []    }        try:        # 1. Verify company        company_resp = requests.post(            f"{base_url}/v1/check/company",            headers={"X-Api-Key": api_key},            json={"identifier": company_id, "country": country},            timeout=5        )        company = company_resp.json()["data"]        results["company_verified"] = company["found"]                if not company["found"]:            results["errors"].append("Company not found")            return results                # 2. Check sanctions        sanctions_resp = requests.post(            f"{base_url}/v1/check/sanctions",            headers={"X-Api-Key": api_key},            json={"name": company["company_name"], "country": country},            timeout=5        )        sanctions = sanctions_resp.json()["data"]        results["sanctions_clear"] = len(sanctions.get("matches", [])) == 0                # 3. Validate VAT (if available)        if company.get("vat_id"):            vat_resp = requests.post(                f"{base_url}/v1/check/vat",                headers={"X-Api-Key": api_key},                json={"vat_id": company["vat_id"]},                timeout=5            )            vat = vat_resp.json()["data"]            results["vat_valid"] = vat["valid"]            except requests.Timeout:        results["errors"].append("API timeout - allow and log for review")    except Exception as e:        results["errors"].append(str(e))        return results# Usageresult = perform_kyc_verification("27074358", "CZ")print(result)