# Integracje z KYC / AML / API blockchaina

### 🧠 Dlaczego integracja jest tak ważna?

W nowoczesnym projekcie tokenizacyjnym nie wystarczy już tylko stworzyć token.\
Trzeba go połączyć z:

* weryfikacją tożsamości użytkownika (KYC),
* kontrolą ryzyk prawnych (AML),
* oraz **bezpośrednią integracją z blockchainem**, by użytkownik mógł:
  * kupować tokeny,
  * sprawdzać saldo,
  * odbierać wypłaty,
  * i śledzić transakcje – wszystko w czasie rzeczywistym.

> Inwestor oczekuje, że Twój system będzie wyglądał jak profesjonalna platforma inwestycyjna, nie jak arkusz Excela.

***

### 🔐 KYC / AML – jak to zintegrować?

Najlepiej **zintegrować zewnętrznego dostawcę KYC** (np. SumSub) z Twoim dashboardem.

#### 🔧 Jak wygląda integracja?

1. Użytkownik loguje się do dashboardu
2. Wchodzi w zakładkę „Weryfikacja”
3. Zostaje przekierowany do panelu SumSub / Fractal / Veriff
4. Przesyła dokumenty (dowód osobisty + selfie)
5. Po akceptacji – status w Twoim systemie zmienia się na „Zweryfikowany”
6. Tylko zweryfikowani mogą kupować tokeny / uczestniczyć w sprzedaży

***

### 🛠️ Popularni providerzy KYC/AML

| Dostawca       | Funkcje                                  | Integracja       |
| -------------- | ---------------------------------------- | ---------------- |
| **SumSub**     | KYC, AML, PEP, Liveness, dokumenty       | REST API, iframe |
| **Fractal ID** | Web3-friendly, DAO-ready                 | Link i redirect  |
| **Blockpass**  | Gotowe moduły do ICO/IDO                 | Link i API       |
| **Veriff**     | Szybka i dokładna weryfikacja dokumentów | API, iframe      |
| **KYC-Chain**  | KYC + scoring ryzyka                     | Custom REST API  |

📌 *Każdy z nich pozwala wprowadzić limity krajowe, blacklisty, listy sankcyjne, a także integrację z twoim CRM lub bazą danych.*

***

### 🔗 Integracja z API blockchaina – po co?

Aby Twoja platforma mogła:

* automatycznie **wykrywać transakcje** inwestora (np. wpłaty w USDT),
* **przypisywać tokeny** po zatwierdzeniu KYC,
* **wyświetlać saldo tokenów** w panelu,
* **rozliczać wypłaty zysków** (np. raz na miesiąc w stablecoinach), musisz mieć połączenie z danym blockchainem.

***

### 🌉 Jak zintegrować API blockchaina?

| Blockchain     | Metoda integracji                      | Przykładowe narzędzia        |
| -------------- | -------------------------------------- | ---------------------------- |
| Ethereum / BNB | Ethers.js / Web3.js / Alchemy / Infura | Moralis, QuickNode, ThirdWeb |
| Solana         | Solana Web3.js / Anchor / Helius API   | SolanaRPC, Helius            |
| Multichain     | Chainstack, GetBlock, BlockDaemon      | REST API, Webhooks           |

Przydatne funkcje:

* webhooki do automatycznego reagowania na transakcje
* event listener – nasłuchiwanie zdarzeń z kontraktu (np. `Transfer`, `Claim`)
* middleware do przeliczania wartości na USD / PLN

***

### 📈 Przykład: Jak to działa w praktyce?

1. Inwestor przechodzi KYC → status w CRM: „Zweryfikowany”
2. Dokonuje wpłaty w USDT → API blockchaina wykrywa transakcję
3. Panel przypisuje odpowiednią liczbę tokenów (z uwzględnieniem kursu i etapu)
4. Inwestor widzi saldo tokenów + timer do vestingu
5. Co kwartał może kliknąć „Claim wypłaty” → system uruchamia funkcję `transfer()` na smart kontrakcie

***

### 💼 Bonus: Automatyczne odrzucenie użytkownika

W panelu możesz zintegrować tzw. **auto-block**:

* użytkownicy z krajów objętych sankcjami (np. Iran, Korea Płn., USA\*)
* osoby z list PEP (osoby eksponowane politycznie)
* podwójna weryfikacja przy wysokiej inwestycji (np. powyżej 10 000 USDT)

\*USA to rynek objęty zakazem sprzedaży wielu tokenów bez rejestracji w SEC.

***

### 📌 Co zyskujesz dzięki integracjom?

✅ Automatyzacja procesu inwestorskiego\
✅ Mniej obsługi manualnej\
✅ Większa zgodność z prawem\
✅ Transparentność i zaufanie\
✅ Dane gotowe do audytu i raportowania

***

### Podsumowanie

**Integracja KYC/AML i blockchaina to klucz do skalowalnej i bezpiecznej sprzedaży tokenów.**\
Zamiast odpowiadać na każdy e-mail – pozwól technologii wykonać 90% pracy.

> 🚀 Smart kontrakt to mózg tokenu.\
> KYC i API blockchaina to jego serce i krwiobieg.
