# Split Payments API — Podział płatności dla marketplace'ów

> **URL:** https://finsplit.pl/split-payments  
> **Endpoint:** `POST /v1/splits`  
> **Język:** polski  
> **Typ:** Dokumentacja produktu  
> **Ostatnia aktualizacja:** 2025-06-01

---

## Przegląd

Automatyczny podział kwoty transakcji między sprzedawców, platformę i partnerów. Jeden request API — dowolna liczba odbiorców (do 50). Zgodny z PSD2, PSD3 i polskim mechanizmem podzielonej płatności VAT (MPP).

---

## Przykład API

```bash
curl -X POST https://api.finsplit.pl/v1/splits \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "payment_id": "pay_abc123",
    "rules": [
      {
        "destination": "acc_seller_001",
        "type": "percentage",
        "value": 85,
        "description": "Sprzedawca"
      },
      {
        "destination": "acc_platform",
        "type": "percentage",
        "value": 10,
        "description": "Prowizja platformy"
      },
      {
        "destination": "acc_logistics",
        "type": "percentage",
        "value": 5,
        "description": "Partner logistyczny"
      }
    ],
    "metadata": {
      "order_id": "ORD-2025-001"
    }
  }'
```

---

## Kluczowe funkcje

| Funkcja | Opis |
|---------|------|
| Elastyczne reguły podziału | Procentowy, kwotowy lub mieszany. Do 50 odbiorców na transakcję. Dynamiczne reguły per-płatność. |
| Zgodność z PSD2 i MPP | Pełna zgodność z dyrektywą PSD2, SCA i polskim mechanizmem podzielonej płatności VAT. |
| Wypłaty T+1 i T+0 | Standardowe rozliczenia T+1. Express Transfer dla natychmiastowych wypłat (Enterprise). |
| Multi-currency | PLN, EUR, CZK, USD. Automatyczna konwersja walut z transparentnym kursem FX. |
| Automatyczne rozliczenia | Cykliczne wypłaty: dzienne, tygodniowe, miesięczne. |
| Webhooks real-time | Powiadomienia o każdym etapie: created, processing, settled, failed. Retry z podpisem HMAC. |

---

## Regulacje w Polsce

### Mechanizm Podzielonej Płatności VAT (MPP)

Od 1 listopada 2019 roku w Polsce obowiązuje **obowiązkowy mechanizm podzielonej płatności (MPP)** dla transakcji B2B spełniających łącznie trzy warunki:

1. Wartość faktury przekracza **15 000 PLN brutto**
2. Transakcja dotyczy towarów lub usług z **Załącznika 15 do ustawy o VAT** (m.in. elektronika, paliwa, stal, złom, usługi budowlane)
3. Sprzedawca i nabywca są **podatnikami VAT czynnymi**

W MPP kwota netto trafia na rachunek rozliczeniowy sprzedawcy, a kwota VAT — na dedykowany **rachunek VAT** prowadzony przez bank. FinSplit automatycznie obsługuje ten podział.

**Ważne:** MPP przedłużony do **28 lutego 2028 roku** (decyzja Rady UE 2024/2712).

### PSD2 i silne uwierzytelnianie (SCA)

Dyrektywa PSD2 nakłada obowiązek stosowania **silnego uwierzytelniania klienta (SCA)** przy inicjowaniu płatności elektronicznych. FinSplit implementuje SCA zgodnie z wymaganiami KNF i EBA.

Dla platform marketplace kluczowe jest rozróżnienie między **agentem handlowym** a **dostawcą usług płatniczych**. FinSplit pełni rolę licencjonowanego pośrednika — platforma nie musi uzyskiwać licencji KIP.

**PSD3 i PSR:** Propozycja PSD3 oraz rozporządzenia PSR (wejście w życie 2026–2027). FinSplit przygotowuje się do IBAN Name Check i rozszerzonych zasad SCA.

### Marketplace a licencja płatnicza

Platformy pośredniczące w płatnościach ryzykują **sankcje KNF** bez odpowiedniej licencji. FinSplit jako licencjonowany Payment Facilitator przejmuje odpowiedzialność regulacyjną.

---

## Przypadki użycia

| Use case | Opis |
|----------|------|
| E-commerce marketplace | Allegro, OLX, Vinted — automatyczny podział płatności między sprzedawcę a platformę. Prowizja per-transakcja z konfigurowalnymi stawkami per-kategoria. |
| Platformy usługowe | Fixly, Oferteo, Booksy — podział między usługodawcę i platformę. Depozyty, kaucje, płatności częściowe. |
| Delivery i food-tech | Glovo, Pyszne.pl — podział między restaurację, kuriera i platformę. Dynamic pricing. |
| SaaS z partnerami | Platformy afiliacyjne i reseller — automatyczne prowizje partnerskie. Raporty i faktury. |

---

## FAQ

**Czym jest split payment w kontekście marketplace?**  
Mechanizm automatycznego podziału kwoty transakcji między wielu odbiorców. W Polsce obowiązuje również MPP dla transakcji B2B > 15 000 PLN brutto.

**Czy split payment w FinSplit jest zgodny z PSD2?**  
Tak. FinSplit działa jako licencjonowany Payment Facilitator zgodnie z PSD2 i wymaganiami KNF.

**Ile uczestników może mieć split payment?**  
Do 50 uczestników w jednej transakcji. Reguły procentowe lub kwotowe z dynamicznym routingiem.

**Czym różni się split payment marketplace od MPP?**  
MPP to wymóg podatkowy (podział netto/VAT). Split payment marketplace to podział między uczestników platformy. FinSplit obsługuje oba.

**Jak szybko realizowane są wypłaty?**  
T+1 (standardowo). T+0 i natychmiastowe (Express Transfer) na planie Enterprise.

---

## Powiązane strony

- [Dokumentacja API](/docs)
- [Masowe Wypłaty](/masowe-wyplaty)
- [KYC/AML](/kyc-aml)
- [Marketplace Guide](/marketplace)

---

## Kontakt i rejestracja

Aby rozpocząć integrację split payments, zarejestruj się na https://finsplit.pl/split-payments — kliknij „Rozpocznij integrację" lub „Umów demo".

---

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