डेवलपर्स
चार चरणों में इंटीग्रेशन
REST API, JSON, हस्ताक्षरित अनुरोध। Node.js उदाहरणों वाले दस्तावेज़ बिना साइन अप के खुले हैं।
- चरण 1
अनुरोध पर हस्ताक्षर करें
टाइमस्टैम्प, मेथड, पाथ और बॉडी हैश का HMAC-SHA256। कुंजी केवल आपके सर्वर पर रहती है।
X-Shop-Id: shop_… X-Timestamp: 1793400000 X-Signature: hex(HMAC-SHA256(secret_key, timestamp ⏎ METHOD ⏎ path ⏎ sha256(body))) - चरण 2
भुगतान बनाएँ
राशि न्यूनतम इकाइयों में। उसी Idempotency-Key से दोहराने पर वही भुगतान लौटता है।
POST /v1/payments Idempotency-Key: 4f1c… { "orderId": "A-1001", "amount": 24990, "currency": "EUR", "returnUrl": "https://shop.example/thanks" } - चरण 3
ग्राहक को भुगतान पर भेजें
भुगतान पेज देश और मुद्रा के तरीके दिखाता है, भुगतान लेता है और ग्राहक को आपके पास लौटाता है।
→ 201 { "id": "pay_…", "status": "created", "checkoutUrl": "https://pay…/c/…" } - चरण 4
वेबहुक प्राप्त करें
हस्ताक्षर जाँचें और ऑर्डर को भुगतान किया हुआ चिह्नित करें। 2xx जवाब न मिले तो हम दो दिन तक दोहराते हैं।
POST https://shop.example/payos/webhook X-Payos-Signature: v1=… { "type": "payment.succeeded", "data": { "orderId": "A-1001", … } }
भुगतान स्वीकार करना शुरू करें
डैशबोर्ड में साइन अप करें और अपनी कंपनी सत्यापित कराएँ। स्टोर स्वीकृत होते ही हम API कुंजियाँ जारी करते हैं।