Wstęp i Autoryzacja

Witaj w oficjalnej dokumentacji API systemu płatności Payra.pl. Nasze REST API umożliwia integrację bramki płatniczej w kilkanaście minut.

Adres Bazowy

GEThttps://api.payra.pl/v1

Wszystkie endpointy wymagające uwierzytelnienia korzystają z nagłówka Authorization z kluczem API lub tokenem JWT.

Nagłówek — Klucz API (integracja sklepu)

Authorization: Bearer pr_live_twoj_klucz_api

Nagłówek — JWT (panel sprzedawcy)

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

Bezpieczeństwo kluczy

Nigdy nie umieszczaj klucza API w kodzie frontendowym. Zapytania do API Payra wykonuj wyłącznie z backendu.

Każda odpowiedź zawiera pole success: boolean. W przypadku błędu, pole error zawiera obiekt z code i message.

Odpowiedź sukcesu

{ "success": true, "transactionId": "...", ... }

Odpowiedź błędu

{
  "success": false,
  "error": {
    "code": "INVALID_AMOUNT",
    "message": "Parametr 'amount' musi być liczbą > 0",
    "param": "amount"
  }
}