आपको क्या चाहिए
| फ़ील्ड | यह क्या करता है |
|---|---|
| API key ID | आपकी MakePay API key को पहचानता है ताकि हम सही खाते को कॉल करें। |
| API key secret | हमें आपके खाते पर MakePay checkouts बनाने देता है। गुप्त। |
| Webhook secret | पुष्टि करता है कि कोई वेबहुक सचमुच MakePay से आया। गुप्त। |
| Success URL | जहां खरीदार पूर्ण भुगतान के बाद पहुंचता है। |
| Failure URL | जहां खरीदार भुगतान विफल या रद्द होने पर पहुंचता है। |
MakePay एक साथ API key ID और secret जारी करता है जब आप एक key बनाते हैं; webhook secret इसकी callback सेटिंग से एक अलग मान है।
हम हर फ़ील्ड क्यों मांगते हैं
API key ID
यह बताता है कि हम कौन सी MakePay key से प्रमाणित हों। यह अपने आप में गुप्त नहीं है, लेकिन नीचे की secret के साथ युग्मित है।
API key secret
checkout बनाने को अधिकृत करता है, ताकि भुगतान आपके MakePay खाते पर चले और आपके वॉलेट में settle हो। MakePay इसे एक बार दिखाता है, key generate करने के तुरंत बाद।
Webhook secret
साबित करता है कि कोई आता हुआ वेबहुक सचमुच MakePay से है, ताकि कोई "paid" इवेंट नकली न बना सके। यह API key से एक अलग मान है।
Success और Failure URL
सादी सेटिंग: जहां खरीदार भुगतान करने के बाद या विफलता या रद्द होने पर पहुंचता है। गुप्त नहीं।
सेट करें
- MakePay में एक API key बनाएं
MakePay में साइन इन करें और API & SDK → API integrations खोलें। API keys के तहत, Generate API Key पर क्लिक करें, इसे "Coin Moebius" जैसा कुछ नाम दें, और बनाएं। MakePay API key ID और इसकी secret को एक बार दिखाता है, generation के तुरंत बाद — दोनों अभी copy करें, क्योंकि secret फिर से नहीं दिखाया जाता है।
MakePay → API & SDK → API integrations → Generate API Key API key secret को password की तरह संभालें। अगर आप इसे खो देते हैं, तो एक नई key बनाएं, पुरानी को पुनः प्राप्त करने की कोशिश मत करें।
- अपनी Coin Moebius project ID खोजें
एक अलग टैब में, अपने प्रोजेक्ट को Coin Moebius डैशबोर्ड में खोलें और प्रोजेक्ट नाम के नीचे Project ID कॉपी करें। आपका MakePay callback URL वह ID है जो नीचे दिए गए पते में डाली गई है — आप इसे अगले step में MakePay में पेस्ट करेंगे।
https://api.coinmoebius.com/webhook/makepay/<your project id>Coin Moebius → your project → Project ID कनेक्टेड provider card (अंतिम step) वही URL दिखाता है, ताकि आप किसी भी समय इसे फिर से copy कर सकें।
- callback URL सेट करें और webhook secret कॉपी करें
MakePay में वापस, Delivery → Callback URL configuration तक स्क्रॉल करें। Edit Callback URL पर क्लिक करें, अपना Coin Moebius webhook URL सक्रिय destination के रूप में पेस्ट करें, और save करें। फिर, Webhook signing के तहत, signing secret कॉपी करें (अगर कोई मान नहीं है तो Regenerate secret का उपयोग करें) — वह Webhook secret है जो Coin Moebius मांगता है।
MakePay → Delivery → Callback URL configuration MakePay हर merchant-visible status change के बाद इस address पर delivery updates पोस्ट करता है। signing secret API key से अलग है — आपको दोनों चाहिए।
- Coin Moebius डैशबोर्ड में कनेक्ट करें
Coin Moebius में, Providers → Add provider → MakePay खोलें। अपनी API key ID, API key secret, और Webhook secret पेस्ट करें, फिर Success URL और Failure URL सेट करें (जहां खरीदार भुगतान के बाद या विफल भुगतान के बाद पहुंचते हैं)। Save पर क्लिक करें।
Coin Moebius → Add provider → MakePay saved secrets छिपे रहते हैं। बाद में किसी को बदलने के लिए, Replace चुनें और नया मान दर्ज करें।
- आप कनेक्ट हो गए
MakePay अब आपके Providers tab पर कनेक्ट होने की तारीख के साथ दिखाई देता है और जिस webhook URL की यह उम्मीद करता है। अगर आपने पहले से नहीं किया है, तो वह URL अपनी MakePay callback सेटिंग में पेस्ट करें। Edit का उपयोग करके keys घुमाएं या Disconnect का उपयोग करके इसे हटाएं, और Test mode toggle का उपयोग करके एक order को अपने वास्तविक numbers को प्रभावित किए बिना चलाएं।
Coin Moebius → Providers → MakePay (connected)
कनेक्ट करने के बाद
live होने से पहले एक order चलाएं:
- कनेक्टेड MakePay card पर Test mode toggle को चालू करें ताकि आप बिना अपने वास्तविक numbers को प्रभावित किए एक order चला सकें।
- एक product बनाएं और अपने प्रोजेक्ट पर इंगित किसी page पर बाय बटन रखें (एक स्थानीय HTML file काम करती है)।
- MakePay के माध्यम से checkout पूरी करें।
- Transactions tab खोलें। जब नई row की स्थिति succeeded तक पहुंचती है, तो आपकी keys और webhook दोनों end-to-end काम कर रहे हैं।
जब आप असली भुगतान के लिए तैयार हों तो Test mode को बंद करें।
समस्या निवारण
डैशबोर्ड से शुरू करें: पुष्टि करें कि MakePay card कनेक्टेड दिखाई दे रहा है और webhook URL वही है जो MakePay में callback destination के रूप में saved है।
भुगतान पूरा होता है पर order pending रहता है।
webhook नहीं पहुंच रहा है या verify नहीं हो रहा है। पुष्टि करें कि MakePay में callback URL आपके प्रोजेक्ट के webhook URL से बिल्कुल मेल खाता है, और कि Coin Moebius में Webhook secret MakePay में signing secret से मेल खाता है।
provider को save करना reject हो जाता है।
API key ID, API key secret, और Webhook secret सभी आवश्यक हैं। MakePay से इन्हें फिर से copy करें — secret केवल एक बार दिखाया जाता है, इसलिए अगर आपके पास नहीं है तो एक नई key बनाएं।
एक test order Transactions में कभी नहीं दिखता।
MakePay card के लिए Test mode toggle को चालू करें इससे पहले कि आप बाय बटन चलाएं, और सुनिश्चित करें कि product एक ही प्रोजेक्ट पर इंगित है।
जानना अच्छा है
Non-custodial. MakePay क्रिप्टो को सीधे आपके अपने वॉलेट में settle करता है। Coin Moebius कभी फंड नहीं रखता है और उन्हें move नहीं कर सकता है।
Secrets घुमाना. कभी भी एक नई API key या webhook signing secret बनाएं, फिर डैशबोर्ड में Replace चुनें और नया मान पेस्ट करें। Secret फ़ील्ड edit पर खाली रहते हैं।
सवाल? Join our Discord