मुख्य कंटेंट तक स्किप करें

अक्सर पूछे जाने वाले प्रश्न

एकीकरण & API​

शुरू करने के लिए मुझे क्या चाहिए?​

आपको एक API Key (प्रबंधन पृष्ठ से, Store के अंतर्गत) और एक callback URL (सार्वजनिक POST endpoint) चाहिए webhook प्राप्त करने के लिए। फिर POST https://api.payerscan.com/payment/crypto कॉल करें इनवॉइस बनाने के लिए और ग्राहक को url_payment पर रीडायरेक्ट करें। देखें त्वरित प्रारंभ।

API का Base URL क्या है?​

API का आधिकारिक Base URL https://api.payerscan.com है। सभी API अनुरोधों को HTTPS का उपयोग करना चाहिए।

क्या मैं callback_url भेजे बिना इनवॉइस बना सकता हूं?​

हां। लेकिन आपको completed/expired webhook प्राप्त नहीं होंगे। आप केवल GET https://api.payerscan.com/invoice/:trans_id (polling) के माध्यम से स्थिति जांच सकते हैं।

दर सीमा क्या है?​

  • POST /payment/crypto: 5 अनुरोध/सेकंड, अधिकतम 60 अनुरोध/मिनट (API Key के अनुसार, IP पर fallback)।
  • GET /invoice/:trans_id: 20 अनुरोध/सेकंड, अधिकतम 200 अनुरोध/मिनट।

सीमा से अधिक → HTTP 429, body में retry_after_seconds के साथ। देखें दर सीमाएं।

request_id क्या है और idempotency कैसे काम करती है?​

request_id इनवॉइस बनाते समय शामिल किया जाने वाला एक वैकल्पिक फ़ील्ड है — आमतौर पर आपका आंतरिक ऑर्डर ID (जैसे: "ORDER-12345") या एक अद्वितीय यादृच्छिक स्ट्रिंग जो केवल आपका backend और PayerScan जानते हैं।

इसका उपयोग क्यों करें? यदि आपका सर्वर request के बीच में क्रैश या timeout हो जाता है, तो आप उसी request_id के साथ सुरक्षित रूप से retry कर सकते हैं। API गारंटी देता है कि डुप्लिकेट इनवॉइस नहीं बनाएगा — बल्कि मौजूदा इनवॉइस "idempotent": true के साथ लौटाएगा।

Webhook को ऑर्डर से मिलाना: request_id webhook callback (completed / expired) में भी शामिल होता है, जिससे आपका backend पहचान सकता है कि भुगतान किस इनवॉइस (लेनदेन, ऑर्डर) का है।

request_id के बिना: हर POST एक नया इनवॉइस बनाता है, भले ही body समान हो। retry करने पर एक ही ऑर्डर के लिए डुप्लिकेट इनवॉइस बनने का जोखिम है।

amount किस मुद्रा में है?​

amount फ़ील्ड हमेशा USD (अमेरिकी डॉलर) में होता है। सिस्टम इसे भुगतान के समय रियल-टाइम विनिमय दर के आधार पर संबंधित क्रिप्टोकरेंसी राशि में स्वचालित रूप से परिवर्तित करता है।

नोट: विनिमय दर चार स्रोतों में से एक — Binance, Coinbase, CoinGecko या CoinMarketCap — से ली जाती है, जिसे ग्राहक भुगतान पृष्ठ पर चुनता है।

amount की सीमा क्या है?​

इनवॉइस का amount (USD) एक सकारात्मक संख्या होनी चाहिए और 1,000,000 से अधिक नहीं हो सकती। मान string या number के रूप में भेजे जा सकते हैं।

completed_url और expired_url क्या हैं?​

ये ग्राहक के ब्राउज़र के लिए वैकल्पिक रीडायरेक्ट URL हैं:

  • completed_url — सफल भुगतान के बाद ग्राहक यहां रीडायरेक्ट होता है।
  • expired_url — इनवॉइस समाप्त होने पर ग्राहक यहां रीडायरेक्ट होता है।

ये केवल फ्रंटएंड रीडायरेक्शन के लिए हैं और callback_url webhook की जगह नहीं लेते।

भुगतान & पुष्टि​

अगर ग्राहक गलत राशि भेजता है तो क्या होता है?​

सिस्टम केवल तभी पुष्टि करता है जब ब्लॉकचेन लेनदेन बिल्कुल मेल खाता है राशि (token_amount), सही पता, और समय सीमा के भीतर। बहुत कम या बहुत अधिक भेजना सफल भुगतान नहीं माना जाएगा; इनवॉइस समाप्त हो सकता है या ग्राहक को नया बनाना होगा।

पुष्टि में कितना समय लगता है?​

आमतौर पर कुछ सेकंड से कुछ मिनट, नेटवर्क और विधि पर निर्भर:

  • EVM (BSC, ETH, Polygon, ...): 3-15 सेकंड
  • Tron (TRC20): 3-5 सेकंड
  • एक्सचेंज जमा (Binance, OKX, Bybit, ...): लगभग तुरंत
  • Binance Pay: लगभग तुरंत

मिलान लेनदेन मिलने पर, सिस्टम इनवॉइस अपडेट करता है और तुरंत webhook भेजता है।

इनवॉइस कब समाप्त होता है?​

Store कॉन्फ़िगरेशन के अनुसार डिफ़ॉल्ट (जैसे, 15 मिनट)। इनवॉइस बनाते समय, response में expires_in_minutes शामिल होता है। उस समय के बाद, इनवॉइस expired हो जाता है और (यदि callback_url प्रदान किया गया है) आपको status: "expired" के साथ webhook मिलता है।

इनवॉइस की संभावित स्थितियां क्या हैं?​

स्थितिविवरण
waitingइनवॉइस बनाया गया, ग्राहक के भुगतान की प्रतीक्षा।
completedब्लॉकचेन पर भुगतान की पुष्टि हो गई।
expiredबिना भुगतान के इनवॉइस समाप्त हो गया।

क्या मैं इनवॉइस रद्द कर सकता हूं?​

नहीं। इनवॉइस API के माध्यम से रद्द नहीं किए जा सकते। वे कॉन्फ़िगर किए गए समय (expires_in_minutes) के बाद स्वचालित रूप से समाप्त हो जाएंगे। यदि ग्राहक भुगतान नहीं करता, तो इसे समाप्त होने दें।

Webhook​

कौन सी घटनाएं webhook ट्रिगर करती हैं?​

सिस्टम दो घटनाओं के लिए webhook भेजता है:

  • completed — जब मिलान भुगतान ब्लॉकचेन पर पुष्टि होता है।
  • expired — जब इनवॉइस बिना भुगतान के समाप्त होता है।

Webhook timeout कितना है?​

10 सेकंड। यदि मर्चेंट सर्वर इस समय के भीतर HTTP 2xx नहीं लौटाता, तो अनुरोध विफल माना जाता है और retry किया जाएगा।

क्या मुझे विशिष्ट body लौटाना होगा?​

नहीं। बस HTTP 2xx स्थिति लौटाएं (जैसे, 200 OK)। Body आप पर निर्भर है (खाली या "OK" हो सकता है)।

क्या webhook विफलता पर retry होते हैं?​

हां। त्रुटि या timeout पर, सिस्टम इस शेड्यूल पर retry करता है: 10s → 30s → 30s → 60s → 60s (अधिकतम 5 प्रयास)। सुनिश्चित करें कि आपका endpoint idempotent तरीके से हैंडल करता है (एक ही trans_id से कई बार कॉल करना सुरक्षित है)।

त्रुटियां & समस्या निवारण​

NO_PAYMENT_METHOD का क्या मतलब है?​

आपके Store में भुगतान विधि कॉन्फ़िगर नहीं है। Store प्रबंधन पर जाएं → इनवॉइस बनाने से पहले कम से कम एक वॉलेट पता जोड़ें या एक्सचेंज प्लेटफ़ॉर्म कनेक्ट करें।

INSUFFICIENT_BALANCE का क्या मतलब है?​

आपके खाते की शेष राशि उस इनवॉइस के सेवा शुल्क को कवर करने के लिए अपर्याप्त है। शुल्क इनवॉइस के amount (USD) के आधार पर आपके खाते की शुल्क दर से गणना किया जाता है (छूट दर को कम कर सकती है)। Dashboard पर टॉप-अप करें और पुनः प्रयास करें। सटीक कमी राशि के लिए त्रुटि response में details फ़ील्ड जांचें।

नोट: निःशुल्क परीक्षण अवधि (पहले 7 दिन) के दौरान, INSUFFICIENT_BALANCE प्रकट नहीं होगा — सभी सेवा शुल्क माफ़ हैं।

INVALID_MERCHANT_ID क्या है?​

Body में merchant_id उपयोग किए जा रहे API Key के Store से मेल नहीं खाता। Store प्रबंधन में merchant_id जांचें और अनुरोध में सही भेजें।

इनवॉइस खोज 404 लौटाती है?​

संभावित कारण: (1) गलत trans_id, (2) इनवॉइस किसी अन्य Store का है (अलग API Key), या (3) मौजूद नहीं है। trans_id और API Key जांचें।

भुगतान विधियां​

सिस्टम किन भुगतान विधियों का समर्थन करता है?​

PayerScan कई भुगतान विधियों का समर्थन करता है:

  • ऑन-चेन वॉलेट: EVM (BSC, Ethereum, Polygon, Base, Arbitrum), Tron (TRC20), Solana
  • एक्सचेंज प्लेटफ़ॉर्म: Binance Pay, Binance Deposit, OKX, Bybit, MEXC, Gate.io, Bitget, Upbit, Bitkub

पूरी सूची के लिए नेटवर्क & टोकन देखें।

Binance Pay कैसे काम करता है?​

Binance Pay ग्राहकों को Binance के माध्यम से भुगतान करने की अनुमति देता है — कोई gas शुल्क नहीं, तुरंत पुष्टि। मर्चेंट्स को प्रबंधन पृष्ठ में Binance API Key और Secret Key कॉन्फ़िगर करनी होगी।

एक्सचेंज प्लेटफ़ॉर्म के लिए क्या कॉन्फ़िगर करना होगा?​

  1. एक्सचेंज पर API Key बनाएं (आवश्यक अनुमतियां सक्रिय करें)
  2. प्रबंधन पृष्ठ में → Store के लिए API Key, Secret Key, और प्लेटफ़ॉर्म ID कॉन्फ़िगर करें

विवरण: Binance Pay सेटअप।

सुरक्षा​

क्या API Key frontend से भेजनी चाहिए?​

नहीं। API Key केवल सर्वर (मर्चेंट का backend) पर उपयोग होनी चाहिए। सर्वर से POST /payment/crypto और GET /invoice कॉल करें; frontend केवल रीडायरेक्शन के लिए url_payment प्राप्त करता है, API Key की आवश्यकता नहीं।

क्या callback URL को प्रमाणीकरण की आवश्यकता है?​

अनुशंसित: merchant_id या trans_id को आंतरिक डेटा से सत्यापित करें यह सुनिश्चित करने के लिए कि अनुरोध वैध है। जासूसी रोकने के लिए HTTPS का उपयोग करें।

क्या मेरे पास एक से अधिक Store हो सकते हैं?​

हां। प्रत्येक Store का अपना API Key, merchant_id, भुगतान विधियां और सेटिंग्स होती हैं। आप विभिन्न व्यवसायों या वातावरणों को अलग करने के लिए कई Store बना सकते हैं (जैसे, production vs. testing)।