Geliştiriciler
Dört adımda entegrasyon
REST API, JSON, imzalı istekler. Node.js örnekli dokümantasyon kayıt olmadan açık.
- Adım 1
İsteği imzala
Zaman damgası, yöntem, yol ve gövde özetinden HMAC-SHA256. Anahtar yalnızca senin sunucunda kalır.
X-Shop-Id: shop_… X-Timestamp: 1793400000 X-Signature: hex(HMAC-SHA256(secret_key, timestamp ⏎ METHOD ⏎ path ⏎ sha256(body))) - Adım 2
Ödeme oluştur
Tutar en küçük birimde. Aynı Idempotency-Key ile tekrar aynı ödemeyi döndürür.
POST /v1/payments Idempotency-Key: 4f1c… { "orderId": "A-1001", "amount": 24990, "currency": "EUR", "returnUrl": "https://shop.example/thanks" } - Adım 3
Müşteriyi ödemeye yönlendir
Ödeme sayfası ülke ve para birimine göre yöntemleri gösterir, ödemeyi alır ve müşteriyi sana geri gönderir.
→ 201 { "id": "pay_…", "status": "created", "checkoutUrl": "https://pay…/c/…" } - Adım 4
Webhook’u al
İmzayı doğrula ve siparişi ödendi olarak işaretle. 2xx yanıt yoksa iki gün boyunca tekrar deneriz.
POST https://shop.example/payos/webhook X-Payos-Signature: v1=… { "type": "payment.succeeded", "data": { "orderId": "A-1001", … } }
Ödeme almaya başla
Kaydol ve şirketini panelde doğrulat. Mağazan onaylanır onaylanmaz API anahtarlarını veriyoruz.