Dla programistów
Integracja w czterech krokach
REST API, JSON, podpisane żądania. Dokumentacja z przykładami w Node.js jest dostępna bez rejestracji.
- Krok 1
Podpisz żądanie
HMAC-SHA256 ze znacznika czasu, metody, ścieżki i hasha treści. Klucz jest tylko na Twoim serwerze.
X-Shop-Id: shop_… X-Timestamp: 1793400000 X-Signature: hex(HMAC-SHA256(secret_key, timestamp ⏎ METHOD ⏎ path ⏎ sha256(body))) - Krok 2
Utwórz płatność
Kwota w najmniejszych jednostkach. Powtórzenie z tym samym Idempotency-Key zwraca tę samą płatność.
POST /v1/payments Idempotency-Key: 4f1c… { "orderId": "A-1001", "amount": 24990, "currency": "EUR", "returnUrl": "https://shop.example/thanks" } - Krok 3
Przekieruj klienta do płatności
Strona pokaże metody dla kraju i waluty, przyjmie płatność i odeśle klienta do Ciebie.
→ 201 { "id": "pay_…", "status": "created", "checkoutUrl": "https://pay…/c/…" } - Krok 4
Odbierz webhook
Sprawdź podpis i oznacz zamówienie jako opłacone. Bez odpowiedzi 2xx ponawiamy przez dwa dni.
POST https://shop.example/payos/webhook X-Payos-Signature: v1=… { "type": "payment.succeeded", "data": { "orderId": "A-1001", … } }
Zacznij przyjmować płatności
Zarejestruj się i zweryfikuj firmę w panelu. Klucze API wydajemy od razu po zatwierdzeniu sklepu.