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

त्वरित शुरुआत

अपने प्लेटफ़ॉर्म में PayerScan भुगतान को एकीकृत करने के लिए चरण-दर-चरण मार्गदर्शिका।

चरण 1: खाता बनाएँ​

PayerScan पर नया व्यापारी खाता बनाने के लिए पंजीकरण पृष्ठ पर जाएँ।

चरण 2: स्टोर बनाएँ​

लॉगिन के बाद, भुगतान स्वीकार करना शुरू करने के लिए व्यापारी डैशबोर्ड में एक नया स्टोर (Store) बनाएँ।

  1. साइडबार में, स्टोर सूची खोलने के लिए API Crypto पर क्लिक करें।
  2. + Create Store बटन पर क्लिक करें।
  3. स्टोर की जानकारी भरें और Create पर क्लिक करें।

स्टोर बनाने का डायलॉग

📖 विस्तृत निर्देशों के लिए, स्टोर बनाने की गाइड देखें।

चरण 3: Merchant ID और API Key प्राप्त करें​

स्टोर बनाने के बाद, स्टोर सूची में आपको Merchant ID और API Key दिखाई देगी।

आपकी Merchant ID और API Key

  • Merchant ID — आपका अनूठा स्टोर पहचानकर्ता (जैसे MID-XXXXXXXXXX)। API अनुरोधों में आवश्यक।
  • API Key — API अनुरोधों को प्रमाणित करने के लिए उपयोग होती है। कॉपी करने के लिए कॉपी आइकन पर क्लिक करें।
warning

अपनी API Key को सुरक्षित रखें। इसे क्लाइंट-साइड कोड या सार्वजनिक रिपॉज़िटरी में उजागर न करें।

चरण 4: वॉलेट पते कॉन्फ़िगर करें​

इनवॉइस बनाने से पहले, क्रिप्टोकरेंसी भुगतान प्राप्त करने के लिए वॉलेट पते जोड़ें:

  • TRC20/BEP20/... टोकन प्राप्त करने के लिए वॉलेट पते जोड़ें।
  • आप एक ही कॉइन और नेटवर्क के लिए कई पते जोड़ सकते हैं।

📖 विस्तृत निर्देशों के लिए, वॉलेट जोड़ने की गाइड देखें।

tip

यदि आप Binance Pay के माध्यम से भी भुगतान स्वीकार करना चाहते हैं, तो Binance Pay सेटअप देखें।

चरण 5: अपना बैकएंड सेट करें​

अपना बैकएंड लॉजिक दो मुख्य भागों को संभालने के लिए सेट करें: इनवॉइस बनाना और Webhooks प्रोसेस करना।

5.1 — इनवॉइस बनाने का API​

भुगतान लिंक जनरेट करने के लिए इनवॉइस बनाएँ API कॉल करें:

curl -X POST "https://api.payerscan.com/payment/crypto" \
     -H "Content-Type: application/json" \
     -H "x-api-key: YOUR_API_KEY" \
     -d '{
        "merchant_id": "MID-XXXXXXXXXX",
        "amount": 100,
        "name": "Order #123456",
        "description": "Payment for shop order",
        "callback_url": "https://your-server.com/webhook/payment",
        "completed_url": "https://your-website.com/thank-you",
        "expired_url": "https://your-website.com/",
        "request_id": "ORDER_123456"
     }'

फिर उपयोगकर्ता को प्रतिक्रिया में उत्पन्न url_payment लिंक पर रीडायरेक्ट करें।

5.2 — भुगतान स्थिति ट्रैक करें​

इनवॉइस भुगतान स्थिति ट्रैक करने के दो तरीके हैं:

  • Webhook (⭐ अनुशंसित): इनवॉइस का भुगतान होने या समाप्त होने पर PayerScan स्वचालित रूप से आपके callback_url पर POST request भेजता है। यह एक रियल-टाइम पुश-आधारित दृष्टिकोण है — आपका सर्वर पोलिंग की आवश्यकता के बिना तुरंत सूचनाएँ प्राप्त करता है। बस एक सार्वजनिक endpoint expose करें और आने वाले payload को संसाधित करें।

    📖 विस्तृत निर्देशों के लिए, Webhook गाइड देखें।

  • Get Invoice API: यदि आप पुल-आधारित दृष्टिकोण पसंद करते हैं, तो trans_id का उपयोग करके किसी भी समय किसी भी इनवॉइस की वर्तमान स्थिति की मैन्युअल रूप से जांच करने के लिए Get Invoice API कॉल कर सकते हैं। ऑन-डिमांड स्टेटस चेक, ऑर्डर रिकॉन्सिलिएशन, या Webhook में देरी होने पर फ़ॉलबैक के रूप में उपयोगी।

    📖 विस्तृत निर्देशों के लिए, Get Invoice देखें।

चरण 6: अपना पहला इनवॉइस बनाएँ​

बैकएंड तैयार होने के बाद, पूर्ण भुगतान प्रवाह का परीक्षण करने के लिए अपना पहला इनवॉइस बनाएँ। सत्यापित करें कि:

  • url_payment लिंक के माध्यम से भुगतान पेज सही ढंग से लोड होता है।
  • भुगतान पूरा होने या समाप्त होने पर आपका webhook endpoint कॉलबैक प्राप्त करता है।
  • आपका सिस्टम ऑर्डर स्टेटस को उचित रूप से अपडेट करता है।