Wprowadzenie

Dostęp do API

Dostęp do API można uzyskać w panelu klienta w zakładce Integracja > Dostęp do API. W tym miejscu znajdziesz swój unikalny klucz API, który jest wymagany do autoryzacji wszystkich zapytań do API Paymentic.

Tworzenie transakcji

Aby utworzyć nową transakcję, należy wysłać zapytanie POST do endpointu /v1_2/payment/points/{pointId}/transactions. Poniżej znajduje się przykład podstawowego zapytania:

POST https://api.paymentic.com/v1_2/payment/points/{pointId}/transactions
{
  "amount": "100.23",
  "title": "Zamówienie #12345"
}

Odpowiedź

Po poprawnym utworzeniu transakcji otrzymasz odpowiedź zawierającą identyfikator transakcji oraz URL do strony płatności:

{
  "data": {
    "id": "ABCD-123-XYZ-9876",
    "redirectUrl": "https://pay.paymentic.com/ABCD-123-XYZ-9876?token=...",
    "whitelabel": null
  }
}

Statusy transakcji

Po utworzeniu transakcji, przechodzi ona przez różne statusy w zależności od przebiegu procesu płatności. Szczegółowe informacje o statusach transakcji znajdziesz w sekcji Statusy transakcji.

Dwa scenariusze integracji

Paymentic oferuje dwa główne scenariusze integracji — wybierz ten, który lepiej pasuje do Twojego UX-a:

Standardowy (ze stroną wyboru Paymentic) — tworzysz transakcję bez pól paymentMethod i paymentChannel. Klient po przekierowaniu na redirectUrl trafia na stronę Paymentic, gdzie sam wybiera bank lub metodę. To najszybsza ścieżka integracji.
Bezpośredni (z pominięciem bramki Paymentic) — w swoim checkoucie pobierasz listę kanałów z GET /v1_2/payment/points/{pointId}/channels, pozwalasz klientowi wybrać metodę u siebie, a w requeście tworzącym transakcję podajesz dodatkowo paymentMethod i paymentChannel. Klient po przekierowaniu trafia od razu do wybranego banku/operatora, z pominięciem ekranu wyboru Paymentic. Szczegóły: Płatność z pominięciem bramki.

Metody płatności

Paymentic oferuje różne metody płatności, w tym:

BLIK
Przelewy online (PBL)
Karty płatnicze
Płatności odroczone (BNPL)
Portfele mobilne (Apple Pay, Google Pay)

Aktualna, dynamiczna lista metod i kanałów dla Twojego punktu płatności jest dostępna pod GET /v1_2/payment/points/{pointId}/channels. Szczegółowe informacje o implementacji poszczególnych metod znajdziesz w odpowiednich sekcjach dokumentacji.

Dostęp do API​

Tworzenie transakcji​

Odpowiedź​

Statusy transakcji​

Dwa scenariusze integracji​

Metody płatności​