# FinSplit API Documentation — Dokumentacja płatności dla platform

> **URL:** https://finsplit.pl/docs  
> **Język:** polski  
> **Typ:** Dokumentacja techniczna API  
> **Ostatnia aktualizacja:** 2025-06-01

---

## Przegląd

Kompletna dokumentacja REST API FinSplit: integracja płatności, split payments, masowe wypłaty, KYC/AML dla platform i marketplace'ów. SDK w Python, Node.js, PHP, Ruby, Go. Sandbox dostępny od razu.

---

## Integracja w 4 krokach

### Krok 1: Załóż konto sandbox
Utwórz darmowe konto deweloperskie w kilka sekund.

### Krok 2: Pobierz klucze API
Wygeneruj klucze testowe w dashboardzie.

```bash
export FINSPLIT_API_KEY=sk_test_your_key_here
```

### Krok 3: Wyślij pierwszą płatność
Jeden request — płatność z podziałem środków.

```bash
curl -X POST https://api.finsplit.pl/v1/payments \
  -H "Authorization: Bearer $FINSPLIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 10000,
    "currency": "PLN",
    "description": "Zamówienie #1234",
    "splits": [
      {"account_id": "seller_001", "amount": 8500},
      {"account_id": "platform", "amount": 1500}
    ]
  }'
```

### Krok 4: Skonfiguruj webhook
Otrzymuj powiadomienia o zdarzeniach w real-time.

```bash
curl -X POST https://api.finsplit.pl/v1/webhooks \
  -H "Authorization: Bearer $FINSPLIT_API_KEY" \
  -d '{
    "url": "https://your-app.com/webhooks",
    "events": ["payment.completed", "payout.sent"]
  }'
```

---

## Moduły API

### Payments API
**Endpoint:** `POST /v1/payments`  
Przyjmowanie płatności z automatycznym podziałem środków. Obsługa kart, BLIK, przelewów.

### Splits API
**Endpoint:** `POST /v1/splits`  
Konfiguracja reguł podziału płatności: procentowe, kwotowe, mieszane. Do 50 odbiorców na transakcję.

### Disbursements API
**Endpoint:** `POST /v1/disbursements`  
Masowe wypłaty na konta bankowe (IBAN), karty (Visa Direct, Mastercard Send) i portfele.

**Batch endpoint:** `POST /v1/disbursements/batch`  
Do 10,000 wypłat w jednym żądaniu.

### Accounts API
**Endpoint:** `GET /v1/accounts`  
Zarządzanie wirtualnymi subkontami uczestników marketplace'u. Real-time balance, historia transakcji.

### KYC API
**Endpoint:** `POST /v1/kyc/verify`  
Weryfikacja tożsamości (KYC/KYB), screening AML, listy sankcyjne, PEP.

**Sessions endpoint:** `POST /v1/kyc/sessions`  
Hosted KYC — tworzenie sesji weryfikacji z UI.

### Webhooks
**Endpoint:** `POST /v1/webhooks`  
Rejestracja webhooków do powiadomień real-time. Retry z podpisem HMAC.

---

## SDK

| Język | Instalacja | Wersja |
|-------|-----------|--------|
| Python | `pip install finsplit` | v2.4.1 |
| Node.js | `npm install @finsplit/sdk` | v3.1.0 |
| PHP | `composer require finsplit/sdk` | v1.8.2 |
| Ruby | `gem install finsplit` | v1.5.0 |
| Go | `go get github.com/finsplit/go-sdk` | v0.9.3 |

---

## Playground

Interaktywny playground do testowania endpointów API dostępny na https://finsplit.pl/docs#playground. Obsługuje endpointy:

- `POST /v1/payments` — Tworzenie płatności
- `POST /v1/splits` — Konfiguracja podziału
- `POST /v1/disbursements` — Wypłata środków
- `GET /v1/accounts` — Lista kont
- `POST /v1/kyc/verify` — Weryfikacja KYC
- `POST /v1/webhooks` — Rejestracja webhooków

---

## Status systemu

- Uptime: 99.98% (ostatnie 90 dni)
- Status page: https://status.finsplit.pl

---

## FAQ

**Jak zintegrować API płatności FinSplit?**  
Integracja wymaga 4 kroków: założenia konta sandbox, pobrania kluczy API, wysłania pierwszej płatności i skonfigurowania webhooków. SDK w 5 językach.

**Jakie języki programowania obsługuje FinSplit SDK?**  
Python, Node.js, PHP, Ruby, Go.

**Czym jest split payment w FinSplit?**  
Automatyczny podział kwoty transakcji między wielu uczestników jednym requestem API.

**Czy FinSplit obsługuje masowe wypłaty?**  
Tak, do 10,000 wypłat w jednym batchu.

---

## Powiązane strony

- [Strona główna](/) — Przegląd FinSplit
- [Split Payments](/split-payments) — Szczegółowy przewodnik
- [Masowe Wypłaty](/masowe-wyplaty) — Disbursements API
- [KYC/AML](/kyc-aml) — Weryfikacja tożsamości
- [Marketplace](/marketplace) — Przewodnik dla marketplace'ów

---

## Kontakt i rejestracja

Aby uzyskać klucze API do sandbox, zarejestruj się na https://finsplit.pl/docs — kliknij „Rozpocznij integrację".

---

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