# Masowe Wypłaty API — Disbursements dla platform i marketplace'ów

> **URL:** https://finsplit.pl/masowe-wyplaty  
> **Endpoint:** `POST /v1/disbursements`  
> **Batch endpoint:** `POST /v1/disbursements/batch`  
> **Język:** polski  
> **Typ:** Dokumentacja produktu  
> **Ostatnia aktualizacja:** 2025-06-01

---

## Przegląd

API do masowych wypłat na konta bankowe (IBAN), karty płatnicze (Visa Direct, Mastercard Send) i portfele cyfrowe. Do 10 000 wypłat w jednym żądaniu batch. Automatyczne rozliczenia z pełnym audit trailem.

---

## Przykład API (Batch)

```bash
curl -X POST https://api.finsplit.pl/v1/disbursements/batch \
  -H "Authorization: Bearer sk_test_..." \
  -H "Idempotency-Key: batch-2025-001" \
  -d '{
    "items": [
      {
        "destination_iban": "PL61109010140000071219812874",
        "amount": 15000,
        "currency": "PLN",
        "recipient_name": "Jan Kowalski",
        "title": "Wypłata za styczeń 2025"
      },
      {
        "destination_iban": "DE89370400440532013000",
        "amount": 2500,
        "currency": "EUR",
        "recipient_name": "Anna Schmidt",
        "title": "Payout January 2025",
        "method": "sepa"
      }
    ],
    "execution_date": "2025-01-31",
    "webhook_url": "https://your-platform.com/webhooks/disbursements"
  }'
```

---

## Metody wypłat

| Metoda | Czas realizacji | Waluty | Dostępność |
|--------|----------------|--------|------------|
| Elixir (przelew krajowy) | 2–4 godziny (3 sesje/dzień) | PLN | Pn–Pt, 8:00–16:00 |
| Express Transfer | Natychmiastowo | PLN | 24/7/365 |
| SEPA Credit Transfer | T+1 | EUR | Pn–Pt |
| SEPA Instant | Do 10 sekund | EUR | 24/7/365 |
| Visa Direct | Do 30 minut | PLN, EUR, USD | 24/7/365 |
| Mastercard Send | Do 30 minut | PLN, EUR, USD | 24/7/365 |

---

## Funkcje Disbursements API

| Funkcja | Opis |
|---------|------|
| Batch processing | Do 10 000 wypłat w jednym żądaniu. Asynchroniczne przetwarzanie z kolejkowaniem. |
| IBAN Validation | Automatyczna walidacja checksumu IBAN, długości i formatu. Opcjonalny IBAN Name Check. |
| Scheduled payouts | Zaplanowane wypłaty na konkretną datę. Cykliczne harmonogramy: dzienne, tygodniowe, miesięczne. |
| Idempotency | Klucz idempotency zapewnia brak duplikatów. Bezpieczne retry. |
| Cross-currency | PLN, EUR, CZK, USD. Automatyczna konwersja FX z gwarantowanym kursem na 30 sekund. |
| Audit trail | Pełna historia: status, timestamp, IP, user agent. Eksport CSV/JSON. |

---

## System bankowy w Polsce — kontekst techniczny

### Elixir — krajowy system rozliczeniowy
Prowadzony przez **KIR (Krajowa Izba Rozliczeniowa)**. Realizuje **3 sesje rozliczeniowe dziennie** w dni robocze. FinSplit automatycznie optymalizuje czas złożenia przelewu. Dla dużych wolumenów: bezpośredni dostęp do SORBNET2 (wysokokwotowe rozliczenia brutto w czasie rzeczywistym).

### Express Transfer — przelew natychmiastowy
BlueCash / Express Elixir — realizacja w **kilka sekund, 24/7/365**. Limity: 20 000 PLN (BlueCash) lub 100 000 PLN (Express Elixir).

### SEPA i SEPA Instant
Wypłaty w EUR: SEPA Credit Transfer (T+1) oraz SEPA Instant (do 10 sekund, 24/7). 36 krajów europejskich. Limit SEPA Instant: 100 000 EUR (wzrost do 1 000 000 EUR planowany 2025).

---

## FAQ

**Ile wypłat można zrealizować jednocześnie?**  
Do 10 000 w jednym żądaniu batch. Dla większych wolumenów: tryb asynchroniczny z kolejkowaniem.

**Jakie metody wypłat obsługuje FinSplit?**  
IBAN (Elixir, SEPA), karty (Visa Direct, Mastercard Send), portfele cyfrowe, Express Transfer.

**Jak szybko realizowane są wypłaty?**  
Elixir: 2–4h. SEPA: T+1. Express Transfer: natychmiastowo. Visa Direct/MC Send: do 30 min.

**Czy FinSplit waliduje IBAN?**  
Tak — checksum, długość, format. Opcjonalny IBAN Name Check przed realizacją.

**Jakie waluty obsługuje Disbursements API?**  
PLN, EUR, CZK, USD. Automatyczna konwersja FX.

---

## Powiązane strony

- [Dokumentacja API](/docs)
- [Split Payments](/split-payments)
- [KYC/AML](/kyc-aml)
- [Marketplace Guide](/marketplace)

---

## Kontakt i rejestracja

Aby rozpocząć integrację masowych wypłat, zarejestruj się na https://finsplit.pl/masowe-wyplaty.

---

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