Sviluppatori
Integrazione in quattro passi
API REST, JSON, richieste firmate. La documentazione con esempi Node.js è aperta senza registrazione.
- Passo 1
Firma la richiesta
HMAC-SHA256 di timestamp, metodo, percorso e hash del corpo. La chiave resta solo sul tuo server.
X-Shop-Id: shop_… X-Timestamp: 1793400000 X-Signature: hex(HMAC-SHA256(secret_key, timestamp ⏎ METHOD ⏎ path ⏎ sha256(body))) - Passo 2
Crea un pagamento
Importo in unità minime. Ripetere con la stessa Idempotency-Key restituisce lo stesso pagamento.
POST /v1/payments Idempotency-Key: 4f1c… { "orderId": "A-1001", "amount": 24990, "currency": "EUR", "returnUrl": "https://shop.example/thanks" } - Passo 3
Invia il cliente a pagare
La pagina mostra i metodi per paese e valuta, incassa il pagamento e riporta il cliente da te.
→ 201 { "id": "pay_…", "status": "created", "checkoutUrl": "https://pay…/c/…" } - Passo 4
Ricevi il webhook
Verifica la firma e segna l’ordine come pagato. Senza risposta 2xx, riproviamo per due giorni.
POST https://shop.example/payos/webhook X-Payos-Signature: v1=… { "type": "payment.succeeded", "data": { "orderId": "A-1001", … } }
Inizia ad accettare pagamenti
Registrati e fai verificare la tua azienda nella dashboard. Le chiavi API arrivano appena il negozio viene approvato.