API त्वरित प्रारंभ

एक टीम और API कुंजी चुनें

जब आप साइन इन हों तो MakeCrypto पोर्टल से या API परीक्षण टैब से एक MakePay API कुंजी बनाएं। API परीक्षण टैब आपकी टीमों को लोड करता है, MakePay API कुंजी को फ़िल्टर करता है, खोलता है कुंजी-निर्माण मोडल जब चयनित टीम के पास अभी तक MakePay कुंजी नहीं है, और चयनित कुंजी आईडी और रहस्य के साथ प्रमाणित अनुरोध भेज सकती है।

आधार URL

सभी MakeCrypto भागीदार API मार्गों को उत्पादन मूल के अंतर्गत संस्करणित किया गया है।

https://www.makecrypto.io/api/partner/v1

स्थानीय विकास के लिए, समान पथ संरचना के साथ अपने स्थानीय MakeCrypto मूल का उपयोग करें।

प्रमाणीकरण

सर्वर एकीकरण को प्रत्येक अनुरोध पर एक MakePay API कुंजी आईडी और API रहस्य भेजना चाहिए। रहस्य केवल तभी लौटाया जाता है जब API कुंजी बनाई जाती है, इसलिए इसे सर्वर-साइड गुप्त प्रबंधक में रखें और इसे कभी भी ग्राहक ब्राउज़र पर न भेजें।

सबसे पहले अनुरोध पढ़ें

लाइव भुगतान लिंक बनाने से पहले पढ़ने के अनुरोध से शुरुआत करें। एक सफल प्रतिक्रिया पुष्टि करती है कि कुंजी आईडी, रहस्य, MakePay उत्पाद दायरा और कुंजी-स्वामित्व वाली कंपनी सभी मान्य हैं।

curl "https://www.makecrypto.io/api/partner/v1/makepay/payment-links" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Accept: application/json"

सबसे पहले अनुरोध बनाएं

जब कोई ऑर्डर, इनवॉइस या checkout सत्र भुगतान के लिए तैयार हो तो अपने सर्वर से भुगतान लिंक बनाएं।

curl -X POST "https://www.makecrypto.io/api/partner/v1/makepay/payment-links" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "active",
  "sendPaymentRequestEmail": false,
  "payload": {
    "title": "Website order #1042",
    "description": "Checkout for order #1042",
    "amount": "129.99",
    "fiatCurrency": "USD",
    "currency": "USDT",
    "orderId": "order_1042",
    "customerEmail": "buyer@example.com",
    "returnUrl": "https://merchant.example/orders/1042",
    "successUrl": "https://merchant.example/orders/1042/success",
    "failureUrl": "https://merchant.example/orders/1042/failure",
    "expirationTime": "12h",
    "metadata": {
      "cartId": "cart_7M2V",
      "source": "api"
    }
  }
}'

परिचालन जांच सूची

• उत्पाद makepay के साथ API कुंजी बनाएं।
• लिंक बनाने से पहले कंपनी की डिफ़ॉल्ट गंतव्य संपत्ति कॉन्फ़िगर करें।
• API गुप्त बाहरी स्रोत नियंत्रण और फ्रंटएंड बंडलों को संग्रहीत करें।
• भुगतान-लिंक UIDs को सार्वजनिक पहचानकर्ता मानें, लेकिन आंतरिक ऑर्डर आईडी को payload.orderId या payload.metadata में रखें।
• webhooks को सुनें या पोर्टल से भुगतान-लिंक/सत्र स्थिति का सर्वेक्षण करें जब तक कि आपका बैकएंड webhook प्रवाह लाइव न हो जाए।