Przejdź do treści

Bramka płatnicza z REST API i panelem

Bramka płatnicza z cennikiem, który policzysz przed podpisem

BLIK, karty Visa i Mastercard oraz szybkie przelewy w jednej integracji. Jedno wywołanie API tworzy płatność, wtyczka podłącza sklep, a plan uruchamiasz sam w panelu.

Dokumentacja API

Założenie konta nic nie kosztuje i nie prosimy o kartę.

Metody w jednej integracji BLIK Visa Mastercard Szybki przelew

Płatności przyjmuje i wypłaca operator z zezwoleniem KNF, z którym masz umowę. Placenie.pl to ekran płatności, API, webhooki i panel.

od0,80%
stawka od obrotu w planie Skala, plus 0,19 zł za transakcję
od199 zł
abonament miesięczny netto, bez opłaty wejściowej
120
zapytań na minutę na jeden klucz API
30
płatności testowych w piaskownicy przed uruchomieniem planu
7
ponowień webhooka po błędzie, od minuty do dwunastu godzin

Dla deweloperów

Jedno wywołanie tworzy płatność. Webhook mówi, że jest opłacona.

REST API w wersji 1: płatności, statusy, zwroty i lista transakcji. Kwoty w groszach, odpowiedzi w JSON, osobne klucze dla piaskownicy i produkcji.

  • Klucze plc_test_ i plc_live_

    Klucz testowy widzi tylko transakcje testowe, produkcyjny tylko produkcyjne.

  • Webhook z podpisem HMAC-SHA256

    Nagłówek Placenie-Signature, ponowienia po 1, 5, 15 i 60 minutach, potem po 3, 6 i 12 godzinach.

  • Idempotencja po numerze zamówienia

    Ten sam numer zamówienia z tą samą kwotą zwraca tę samą transakcję, bez duplikatu.

  • Identyfikator każdego żądania

    Nagłówek X-Request-Id w każdej odpowiedzi i jeden obiekt błędu z kodem i opisem.

Dokumentacja Referencja API
POST /api/v1/platnosci 
# Utworzenie płatności w piaskownicy
curl -X POST https://placenie.pl/api/v1/platnosci \
  -H "Authorization: Bearer plc_test_7c1f9b2e4a8d6f3b0e5c9a1d" \
  -H "Content-Type: application/json" \
  -d '{
    "kwota": 24900,
    "waluta": "PLN",
    "numer_zamowienia": "10482",
    "opis": "Zamówienie 10482",
    "email_klienta": "[email protected]",
    "adres_powrotu": "https://sklep-polnoc.pl/zamowienie/10482"
  }'
// Utworzenie płatności w piaskownicy (Guzzle albo Laravel HTTP)
$odpowiedz = Http::withToken('plc_test_7c1f9b2e4a8d6f3b0e5c9a1d')
    ->post('https://placenie.pl/api/v1/platnosci', [
        'kwota'            => 24900,
        'waluta'           => 'PLN',
        'numer_zamowienia' => '10482',
        'opis'             => 'Zamówienie 10482',
        'email_klienta'    => '[email protected]',
        'adres_powrotu'    => 'https://sklep-polnoc.pl/zamowienie/10482',
    ]);

$platnosc = $odpowiedz->json();
return redirect($platnosc['adres_platnosci']);
// Utworzenie płatności w piaskownicy (fetch, Node 18+)
const odpowiedz = await fetch('https://placenie.pl/api/v1/platnosci', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer plc_test_7c1f9b2e4a8d6f3b0e5c9a1d',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    kwota: 24900,
    waluta: 'PLN',
    numer_zamowienia: '10482',
    opis: 'Zamówienie 10482',
    email_klienta: '[email protected]',
    adres_powrotu: 'https://sklep-polnoc.pl/zamowienie/10482',
  }),
});

const platnosc = await odpowiedz.json();
res.redirect(platnosc.adres_platnosci);
# Utworzenie płatności w piaskownicy (requests)
import requests

odpowiedz = requests.post(
    "https://placenie.pl/api/v1/platnosci",
    headers={"Authorization": "Bearer plc_test_7c1f9b2e4a8d6f3b0e5c9a1d"},
    json={
        "kwota": 24900,
        "waluta": "PLN",
        "numer_zamowienia": "10482",
        "opis": "Zamówienie 10482",
        "email_klienta": "[email protected]",
        "adres_powrotu": "https://sklep-polnoc.pl/zamowienie/10482",
    },
)

platnosc = odpowiedz.json()
return redirect(platnosc["adres_platnosci"])
Odpowiedź 201 Created 
{
  "id": "tr_k7m2q9d4x1p8s3f6w0z5",
  "tryb": "test",
  "status": "nowa",
  "kwota": 24900,
  "waluta": "PLN",
  "zwrocono": 0,
  "numer_zamowienia": "10482",
  "opis": "Zamówienie 10482",
  "metoda": null,
  "adres_platnosci": "https://placenie.pl/zaplac/tr_k7m2q9d4x1p8s3f6w0z5",
  "utworzona": "2026-10-03T10:12:41+02:00",
  "oplacona": null
}

Klient trafia pod adres_platnosci, wybiera BLIK, kartę albo przelew, a po zapłacie dostajesz webhook platnosc.oplacona i wracasz do niego pod adres_powrotu.

Panel sprzedawcy

Wszystko, co dzieje się z płatnością, widzisz w jednym panelu

Transakcje z filtrami i eksportem CSV, zwroty jednym przyciskiem, dostawy webhooków z ponowieniem, linki do zapłaty, raporty księgowe i zespół z rolami.

Transakcje i zwroty

Filtry po statusie, metodzie, dacie i kwocie. Zwrot całości albo części prosto z transakcji.

Webhooki

Każda dostawa z kodem odpowiedzi i przyciskiem ponowienia.

Linki do zapłaty

Kwota, tytuł i gotowy adres do wysłania klientowi. Bez sklepu.

Raporty księgowe

Zestawienie miesiąca i eksport CSV dla biura rachunkowego.

Zespół i role

Kto widzi transakcje, kto robi zwroty, kto trzyma klucze.

Jak płyną pieniądze

Pieniądze klientów nie przechodzą przez nas

Placenie.pl prowadzi ekran płatności, API i webhooki. Autoryzację i rozliczenie wykonuje operator płatności z zezwoleniem KNF, z którym Twoja firma ma umowę.

  1. 01

    Klient płaci

    Wybiera BLIK, kartę albo szybki przelew na ekranie płatności Twojego sklepu.

  2. 02

    Placenie.pl

    Tworzy płatność z API albo wtyczki, prowadzi klienta przez ekran, wysyła webhook o wyniku.

    Technologia, bez dostępu do pieniędzy

  3. 03

    Operator z zezwoleniem KNF

    Autoryzuje płatność, przyjmuje środki i je rozlicza. Numer karty klient wpisuje u operatora.

  4. 04

    Rachunek Twojej firmy

    Operator wypłaca środki na konto firmy. Od nas dostajesz zestawienie i fakturę VAT za plan.

Samoobsługa

Od adresu e-mail do pierwszej płatności bez rozmowy z handlowcem

Piaskownica jest dostępna od razu po potwierdzeniu adresu. Plan uruchamiasz, gdy liczby się zgadzają, a dane operatora wpisujesz sam w zakładce Integracja.

  1. 01

    Potwierdź adres kodem

    Podajesz e-mail i wpisujesz sześciocyfrowy kod z wiadomości. Jesteś w panelu, bez karty i bez umowy.

  2. 02

    Przetestuj w piaskownicy

    Klucz plc_test_ i bank testowy: 30 płatności testowych, kody BLIK, odmowa banku, webhooki.

  3. 03

    Podłącz sklep

    Wtyczka do WooCommerce, Shopera albo PrestaShop, a dla własnego systemu REST API i webhook.

  4. 04

    Uruchom plan i operatora

    Wybierasz plan z cennika, płacisz kartą, wpisujesz dane operatora z zezwoleniem KNF i przyjmujesz pierwszą płatność.

Cennik

Policz koszt dla swojego obrotu, zanim założysz konto

Abonament planu plus stawka od obrotu i opłata za transakcję. Cały cennik jest na stronie, a kalkulator liczy go dla Twoich liczb.

Kalkulator kosztów

Model sprzedaży
zł
zł

Mix metod płatności

Transakcje w miesiącu

Koszt miesięczny

zł

Efektywna stawka

%

Wynik dla planu , najtańszego z tych, które obsłużą wybrany model sprzedaży.

Start

Pierwszy sklep, do około 30 tys. zł obrotu

199zł

miesięcznie netto

1,40% + 0,39zł za transakcję

Twój koszt miesięczny

Uruchom plan Start

Sklep

Rosnący sklep, od 30 do 300 tys. zł obrotu

399zł

miesięcznie netto

1,10% + 0,29zł za transakcję

Twój koszt miesięczny

Uruchom plan Sklep

Skala

300 tys. zł i więcej, do 10 sklepów

899zł

miesięcznie netto

0,80% + 0,19zł za transakcję

Twój koszt miesięczny

Uruchom plan Skala

Enterprise

Grupa spółek, do 30 sklepów, wiele podmiotów rozliczeniowych

1 599zł

miesięcznie netto

0,80% + 0,19zł za transakcję

Twój koszt miesięczny

1 599zł

Uruchom plan Enterprise

Ceny netto, do kwot doliczamy VAT. Plan roczny kosztuje połowę ceny miesięcznej, oszczędzasz 50 procent. Założenie konta nic nie kosztuje i nie prosimy o kartę.

Pełny cennik i zakres planów

Bezpieczeństwo

Numer karty nigdy nie trafia do Placenie.pl

Budujemy zgodnie ze standardem PCI DSS oraz wymogami PSD2 i silnego uwierzytelniania SCA. Piszemy „budujemy zgodnie z”, a nie „posiadamy certyfikat”, bo to dwie różne rzeczy.

Dane karty u operatora

Klient wpisuje numer karty wyłącznie w formularzu operatora płatności, z 3-D Secure 2. Placenie.pl nie widzi go i nie przechowuje.

Podpisane webhooki

Każde zdarzenie niesie nagłówek Placenie-Signature z HMAC-SHA256 i znacznikiem czasu, więc sklep odrzuca podrobione powiadomienia.

Rejestr zdarzeń i role

Panel zapisuje, kto wydał klucz, zmienił webhook albo zlecił zwrot. Uprawnienia nadajesz osobno każdej osobie w zespole.

Architektura bezpieczeństwa warstwa po warstwie

Nowości

Prowizje, metody i koszty policzone w złotówkach

Wszystkie wpisy

PayU czy Paynow i który operator wyjdzie taniej dla Twojego sklepu

Paynow wygrywa na cenniku z PayU w obu cenach i pokazujemy o ile, od 1 478 do 36 950 zł w pierwszym roku. Potem warunki spoza cennika: konto w mBanku, platforma sklepu, raty i warunek 170 zł w promocji PayU.

Czytaj

Tpay czy Paynow i który operator wyjdzie taniej dla Twojego sklepu

Paynow wygrywa na cenniku z oboma pakietami Tpay i pokazujemy o ile, od 1 028 do 2 148 zł rocznie wobec tańszego pakietu. Potem warunki spoza cennika: konto w mBanku, platforma sklepu, stawka za kartę i metody, których Paynow nie ma.

Czytaj

Paynow czy Przelewy24 i która bramka wyjdzie taniej dla Twojego sklepu

Na cenniku Paynow wygrywa zawsze i pokazujemy o ile, od 608 do 12 160 zł rocznie. Potem trzy warunki spoza cennika, które przesądzają wcześniej niż stawka: konto w mBanku, platforma sklepu i rezerwa na kartach.

Czytaj

Masz ofertę innego operatora płatności? Sprawdź prowizję, umowę i rejestrację

Każdego operatora opisaliśmy osobno, z cennikiem ze źródłem, zapisami umowy i kosztem przy konkretnym obrocie. Wybierz tego, którego oferta leży na stole, a policzysz go obok naszego planu.

Załóż konto i zrób pierwszą płatność testową dziś

Adres e-mail, kod z wiadomości i piaskownica. Plan uruchamiasz wtedy, gdy liczby się zgadzają.

Wróć do kalkulatora

Założenie konta nic nie kosztuje i nie prosimy o kartę.