# KYC/AML API — Weryfikacja tożsamości i screening AML

> **URL:** https://finsplit.pl/kyc-aml  
> **Endpoint:** `POST /v1/kyc/verify`  
> **Sessions:** `POST /v1/kyc/sessions`  
> **Język:** polski  
> **Typ:** Dokumentacja produktu  
> **Ostatnia aktualizacja:** 2025-06-01

---

## Przegląd

Automatyczna weryfikacja tożsamości (KYC), weryfikacja firm (KYB) i screening AML — wbudowane w platformę płatniczą. Zgodne z polską ustawą AML, PSD2 i wytycznymi GIIF.

---

## Proces weryfikacji KYC (4 kroki)

1. **Upload dokumentu** — Użytkownik przesyła zdjęcie dowodu osobistego, paszportu lub prawa jazdy. SDK mobilne z liveness detection.
2. **OCR & extraction** — Automatyczne rozpoznanie tekstu i ekstrakcja danych: imię, nazwisko, PESEL, data urodzenia, data ważności.
3. **Liveness check** — Weryfikacja, że dokument przesyła żywa osoba. Analiza 3D, micro-expressions, light reflection.
4. **AML screening** — Sprawdzenie w bazach sankcyjnych, PEP, adverse media. Automatyczna decyzja: approved, rejected, manual_review.

---

## Przykład integracji

```javascript
const session = await finsplit.kyc.createSession({
  account_id: "acc_seller_001",
  type: "individual",           // "individual" | "business"
  required_checks: [
    "document_verification",    // OCR + autentyczność dokumentu
    "liveness",                 // Liveness detection
    "aml_screening",            // Listy sankcyjne, PEP, adverse media
    "address_verification"      // Weryfikacja adresu (opcjonalna)
  ],
  redirect_url: "https://your-platform.com/kyc/complete",
  webhook_url: "https://your-platform.com/webhooks/kyc",
  locale: "pl"
});

// session.url → przekieruj użytkownika na hosted verification page
// Webhook: kyc.session.completed | kyc.session.failed
```

---

## KYC osoby fizycznej vs KYB firmy

### KYC — Know Your Customer
Weryfikacja osób fizycznych (sprzedawcy, usługodawcy, freelancerzy):
- Dowód osobisty / paszport / prawo jazdy
- PESEL i data urodzenia
- Adres zamieszkania (proof of address)
- Liveness detection (selfie video)
- Screening PEP i listy sankcyjne

### KYB — Know Your Business
Weryfikacja podmiotów gospodarczych (spółki, JDG, stowarzyszenia):
- KRS / CEIDG — automatyczny odpis
- NIP, REGON — walidacja i cross-check
- UBO (Ultimate Beneficial Owner) — identyfikacja
- Dokumenty statutowe (umowa spółki, KRS)
- Screening AML wszystkich UBO i zarządu

---

## Regulacje AML w Polsce

### Ustawa o przeciwdziałaniu praniu pieniędzy (AML)
Ustawa z dnia **1 marca 2018 r.** (Dz.U. 2018 poz. 723) implementuje dyrektywę 4AMLD i 5AMLD. Obowiązki instytucji obowiązanych:

- **Identyfikacja klienta** — ustalenie tożsamości przed nawiązaniem stosunku gospodarczego
- **Weryfikacja tożsamości** — potwierdzenie danych na podstawie dokumentu
- **Identyfikacja beneficjenta rzeczywistego** — ustalenie UBO (osoba z >25% udziałów)
- **Bieżący monitoring** — ongoing monitoring transakcji
- **Raportowanie do GIIF** — transakcje podejrzane (STR) i ponadprogowe (CTR)

### 6AMLD — szósta dyrektywa AML
- Utworzenie **AMLA** (Anti-Money Laundering Authority) we Frankfurcie
- Obniżenie progu identyfikacji UBO z 25% do **15%** (podmioty podwyższonego ryzyka)
- Limit płatności gotówkowych do **10 000 EUR** w całej UE
- Rozszerzone obowiązki dla dostawców usług kryptoaktywów (CASPs)

### GIIF — Generalny Inspektor Informacji Finansowej
Polska jednostka analityki finansowej (FIU). FinSplit automatyzuje raportowanie:
- Transakcje podejrzane (STR)
- Transakcje ponadprogowe (CTR, >15 000 EUR)
- Transakcje z krajami wysokiego ryzyka
- Format XML GIIF (goAML)

---

## Bazy i listy AML screeningu

| Baza | Opis |
|------|------|
| Listy sankcyjne UE | Consolidated Financial Sanctions List. Aktualizacja w real-time. |
| OFAC (USA) | Specially Designated Nationals and Blocked Persons List. |
| UN Sanctions | Security Council Consolidated List. |
| PEP | Politically Exposed Persons — politycy, urzędnicy, ich rodziny. |
| Adverse media | Monitoring mediów: oszustwa, korupcja, przestępstwa finansowe. |
| CRBR | Centralny Rejestr Beneficjentów Rzeczywistych — struktura właścicielska. |

---

## Czas weryfikacji

- **Automatyczna weryfikacja KYC (OCR + liveness):** 15–30 sekund
- **Weryfikacja KYB (KRS/CEIDG + screening):** 1–3 minuty
- **Enhanced due diligence (manualna):** do 24 godzin

---

## FAQ

**Co to jest KYC i dlaczego jest wymagany?**  
KYC to proces weryfikacji tożsamości klienta wymagany przez ustawę AML z 1 marca 2018 r.

**Czym różni się KYC od KYB?**  
KYC dotyczy osób fizycznych, KYB dotyczy podmiotów gospodarczych.

**Jak działa screening AML?**  
Sprawdzenie w bazach sankcyjnych (UE, OFAC, UN), PEP, adverse media. Real-time + ongoing monitoring.

**Ile trwa weryfikacja?**  
Automatyczna KYC: 15–30 sekund. KYB: 1–3 minuty. Enhanced due diligence: do 24h.

---

## Powiązane strony

- [Dokumentacja API](/docs)
- [Split Payments](/split-payments)
- [Masowe Wypłaty](/masowe-wyplaty)
- [Marketplace Guide](/marketplace)

---

## Kontakt i rejestracja

Aby rozpocząć integrację KYC/AML, zarejestruj się na https://finsplit.pl/kyc-aml.

---

*Dokument wygenerowany automatycznie z treści strony https://finsplit.pl/kyc-aml. © 2025 FinSplit. Wszystkie prawa zastrzeżone.*