Developer
Integrasi dalam empat langkah
REST API, JSON, permintaan bertanda tangan. Dokumentasi dengan contoh Node.js terbuka tanpa pendaftaran.
- Langkah 1
Tanda tangani permintaan
HMAC-SHA256 dari timestamp, metode, path, dan hash body. Kunci hanya ada di servermu.
X-Shop-Id: shop_… X-Timestamp: 1793400000 X-Signature: hex(HMAC-SHA256(secret_key, timestamp ⏎ METHOD ⏎ path ⏎ sha256(body))) - Langkah 2
Buat pembayaran
Jumlah dalam unit terkecil. Mengulang dengan Idempotency-Key yang sama mengembalikan pembayaran yang sama.
POST /v1/payments Idempotency-Key: 4f1c… { "orderId": "A-1001", "amount": 24990, "currency": "EUR", "returnUrl": "https://shop.example/thanks" } - Langkah 3
Arahkan pelanggan untuk membayar
Halaman pembayaran menampilkan metode sesuai negara dan mata uang, menerima pembayaran, lalu mengembalikan pelanggan kepadamu.
→ 201 { "id": "pay_…", "status": "created", "checkoutUrl": "https://pay…/c/…" } - Langkah 4
Terima webhook
Verifikasi tanda tangan dan tandai pesanan sebagai dibayar. Tanpa respons 2xx, kami coba lagi selama dua hari.
POST https://shop.example/payos/webhook X-Payos-Signature: v1=… { "type": "payment.succeeded", "data": { "orderId": "A-1001", … } }
Mulai terima pembayaran
Daftar dan verifikasi perusahaanmu di dasbor. Kunci API langsung diterbitkan setelah tokomu disetujui.