Zacznij

Integracja w sklepie

Płatności w sklepie internetowym podłączysz na dwa sposoby. Pierwszy: Twój programista korzysta z REST API i hostowanej strony płatności, dokładnie tak, jak w szybkim starcie. Drugi: zlecasz wdrożenie naszemu zespołowi, za darmo w każdym planie. Dziś nie ma gotowych wtyczek do pobrania ani bibliotek SDK, więc poniżej opisujemy uczciwie, co jest potrzebne w kodzie sklepu.

Klucz testowy w przykładach

Wklej klucz sk_test_ z panelu (zakładka Deweloperzy), a każdy przykład będzie gotowy do uruchomienia. Klucz zostaje w tej karcie przeglądarki, nie wysyłamy go nigdzie.

Przykłady używają Twojego klucza testowego. Produkcyjnego klucza nie przyjmujemy.

Tryb testowy

Dwie drogi#

	REST API w kodzie sklepu	Wdrożenie przez nasz zespół
Dla kogo	sklep z programistą albo własnym oprogramowaniem	firma bez programisty albo bez czasu
Co robisz	utworzenie płatności, przekierowanie, webhook, mapowanie statusów	wysyłasz zgłoszenie i akceptujesz działające płatności
Czas	od kilku godzin do dnia roboczego	zwykle kilka dni roboczych
Koszt	abonament planu	abonament planu, wdrożenie bez opłaty
Start	Szybki start	Zamów integrację za darmo

Dla kogo

REST API w kodzie sklepu: sklep z programistą albo własnym oprogramowaniem
Wdrożenie przez nasz zespół: firma bez programisty albo bez czasu

Co robisz

REST API w kodzie sklepu: utworzenie płatności, przekierowanie, webhook, mapowanie statusów
Wdrożenie przez nasz zespół: wysyłasz zgłoszenie i akceptujesz działające płatności

Czas

REST API w kodzie sklepu: od kilku godzin do dnia roboczego
Wdrożenie przez nasz zespół: zwykle kilka dni roboczych

Koszt

REST API w kodzie sklepu: abonament planu
Wdrożenie przez nasz zespół: abonament planu, wdrożenie bez opłaty

Start

REST API w kodzie sklepu: Szybki start
Wdrożenie przez nasz zespół: Zamów integrację za darmo

Co trzeba zbudować w sklepie#

Integracja przez API to cztery elementy, niezależnie od platformy sklepu.

01Metoda płatności w kasie: po złożeniu zamówienia serwer sklepu woła POST /v1/payments z kwotą zamówienia w groszach, walutą, return_url prowadzącym na stronę zamówienia i metadata.order_id. Klucz idempotencji to np. zamowienie-<id>, żeby odświeżenie strony nie utworzyło drugiej płatności.
02Przekierowanie: odpowiedź ma checkout_url, na który kierujesz klienta. Zapisz payment.id przy zamówieniu.
03Strona powrotu: pod return_url pobierz płatność po ?payment= i pokaż stan. To tylko informacja dla klienta.
04Webhook: pod publicznym adresem HTTPS odbierz payment.succeeded, payment.failed, payment.canceled i refund.succeeded, sprawdź podpis i zmień status zamówienia. To jest jedyne źródło prawdy o zapłacie.

Zwroty z panelu sklepu robisz żądaniem POST /v1/refunds z identyfikatorem płatności i kwotą (częściowe zwroty sumują się do kwoty płatności). Zdarzenie refund.succeeded potwierdza wykonanie zwrotu przez operatora.

Mapowanie statusów na statusy zamówienia#

Zdarzenie albo status płatności	Status zamówienia w sklepie
`payment.created`, status `pending`	oczekuje na płatność
`requires_confirmation`, `processing`	w trakcie płatności (nie wysyłaj)
`payment.succeeded`	opłacone, do realizacji
`payment.failed`	płatność nieudana, klient może zapłacić ponownie nową płatnością
`payment.canceled`	płatność wygasła po 24 godzinach albo anulowana; zwolnij rezerwację towaru
`refund.succeeded`	zwrócone (częściowo, gdy `amount` mniejsze od kwoty płatności)

Jedno zamówienie może mieć kilka płatności (po odmowie klient płaci jeszcze raz). Zapisuj identyfikator każdej i reaguj na zdarzenie tej, która zakończyła się sukcesem; pozostałe wygasną same i dostaną payment.canceled.

WooCommerce, PrestaShop, Shopify, WordPress#

Dla sklepów na gotowych platformach dziś wdrożenie wykonuje nasz zespół, bez opłaty: podpinamy płatności w kasie, ustawiamy webhook statusów i faktury, robimy płatność testową i oddajemy działający sklep. Opis dla każdej platformy: WooCommerce, PrestaShop, Shopify, WordPress. Programista sklepu może też zbudować bramkę samodzielnie na REST API według tej dokumentacji; mechanika z poprzednich sekcji jest ta sama dla każdej platformy.

Nie publikujemy wtyczek ani bibliotek SDK, których nie ma w kodzie. Gdy się pojawią, znajdziesz je w tej dokumentacji i w specyfikacji.

Sprzedaż bez sklepu#

Jeśli nie masz sklepu, zamiast integracji użyj linku do płatności (adres i kod QR z panelu albo z POST /v1/payment_links) albo zleć naszemu zespołowi przygotowanie strony sprzedaży produktu lub subskrypcji z podpiętymi płatnościami. Obie drogi kończą się w tym samym panelu z tymi samymi płatnościami, zwrotami i fakturami.

Powiązane

Zamów integrację za darmo/integracja-za-ciebie Hostowana strona płatności/docs/hostowana-strona-platnosci Webhooki/docs/webhooki Zwroty w referencji API/docs/api/zwroty

Klucz testowy dostajesz od razu po zapisie

Adres e-mail, kod z maila i piaskownica z kodami BLIK. Produkcję włączasz sam w panelu: plan, dostawca płatności, klucz sk_live_. Wolisz, żeby wdrożenie w sklepie zrobił nasz zespół? To też jest za darmo.

Zamów integrację za darmo