Entwickler
Integration in vier Schritten
REST-API, JSON, signierte Anfragen. Die Dokumentation mit Node.js-Beispielen ist ohne Registrierung zugänglich.
- Schritt 1
Anfrage signieren
HMAC-SHA256 aus Zeitstempel, Methode, Pfad und Body-Hash. Der Schlüssel bleibt auf deinem Server.
X-Shop-Id: shop_… X-Timestamp: 1793400000 X-Signature: hex(HMAC-SHA256(secret_key, timestamp ⏎ METHOD ⏎ path ⏎ sha256(body))) - Schritt 2
Zahlung anlegen
Betrag in kleinsten Einheiten. Eine Wiederholung mit demselben Idempotency-Key liefert dieselbe Zahlung.
POST /v1/payments Idempotency-Key: 4f1c… { "orderId": "A-1001", "amount": 24990, "currency": "EUR", "returnUrl": "https://shop.example/thanks" } - Schritt 3
Kunden zur Zahlung leiten
Die Zahlungsseite zeigt Zahlarten für Land und Währung, nimmt die Zahlung an und leitet den Kunden zurück.
→ 201 { "id": "pay_…", "status": "created", "checkoutUrl": "https://pay…/c/…" } - Schritt 4
Webhook empfangen
Signatur prüfen und Bestellung als bezahlt markieren. Ohne 2xx-Antwort versuchen wir es zwei Tage lang erneut.
POST https://shop.example/payos/webhook X-Payos-Signature: v1=… { "type": "payment.succeeded", "data": { "orderId": "A-1001", … } }
Jetzt Zahlungen akzeptieren
Registriere dich und lass dein Unternehmen im Dashboard prüfen. API-Schlüssel gibt es, sobald dein Shop freigegeben ist.