MakePay منسلک کریں

آپ کو کیا درکار ہے

فیلڈ	یہ کیا کرتا ہے
API key ID	آپ کے MakePay API key کی شناخت کرتی ہے تاکہ ہم صحیح اکاؤنٹ کو کال کریں۔
API key secret	ہمیں آپ کے اکاؤنٹ پر MakePay checkouts بنانے دیتی ہے۔ خفیہ۔
Webhook secret	تصدیق کرتی ہے کہ ایک webhook واقعی MakePay سے آیا۔ خفیہ۔
Success URL	مکمل ادائیگی کے بعد خریدار کہاں پہنچتا ہے۔
Failure URL	ادائیگی ناکام ہونے یا منسوخ کرنے پر خریدار کہاں پہنچتا ہے۔

MakePay API key ID اور secret کو اکٹھا ایک کلید بناتے ہوئے دیتا ہے؛ webhook secret اس کی callback کی ترتیبات سے ایک الگ قدر ہے۔

ہم ہر فیلڈ کیوں مانگتے ہیں

API key ID

یہ طے کرتی ہے کہ ہم کون سی MakePay کلید سے توثیق کر رہے ہیں۔ اپنی ذات میں خفیہ نہیں، لیکن نیچے دی گئی secret کے ساتھ جوڑی جاتی ہے۔

API key secret

یہ checkout بنانے کی اجازت دیتی ہے، تاکہ ادائیگی آپ کے MakePay اکاؤنٹ کے ذریعے چلے اور آپ کی والیٹ میں جمع ہو۔ MakePay اسے کلید بنانے کے فوراً بعد ایک بار دکھاتا ہے۔

Webhook secret

یہ ثابت کرتی ہے کہ آنے والا webhook واقعی MakePay سے ہے، تاکہ کوئی بھی جعلی "paid" ایونٹ بنا کر دھوکا نہ دے سکے۔ یہ API key سے ایک الگ قدر ہے۔

Success and Failure URL

سادہ ترتیبات: ادائیگی کے بعد یا ناکامی/منسوخی کے بعد خریدار کہاں پہنچتا ہے۔ خفیہ نہیں۔

سیٹ اپ

MakePay میں ایک API key بنائیں
MakePay میں سائن اِن کریں اور API & SDK → API integrations کھولیں۔ API keys کے تحت، Generate API Key پر کلک کریں، اسے "Coin Moebius" جیسا کچھ کہہ دیں، اور بنائیں۔ MakePay API key ID اور اس کی secret کو فوراً دکھاتا ہے—دونوں اب کاپی کریں، کیونکہ secret دوبارہ نہیں دکھایا جاتا۔
MakePay → API & SDK → API integrations → Generate API Key
API key secret کو پاس ورڈ کی طرح سلوک کریں۔ اگر آپ اسے کھو دیں تو ایک نئی کلید بنائیں بجائے اس کے کہ پرانی کو بازیافت کرنے کی کوشش کریں۔
اپنی Coin Moebius پروجیکٹ ID تلاش کریں
ایک الگ ٹیب میں، Coin Moebius ڈیش بورڈ میں اپنا پروجیکٹ کھولیں اور پروجیکٹ کے نام کے نیچے Project ID کاپی کریں۔ آپ کا MakePay callback URL وہ ID ہے جو نیچے دیے ہوئے پتے میں ڈالا جائے—آپ اسے اگلے مرحلے میں MakePay میں پیسٹ کریں گے۔
```
https://api.coinmoebius.com/webhook/makepay/<your project id>
```
Coin Moebius → آپ کا پروجیکٹ → Project ID
منسلک فراہم کنندہ کارڈ (آخری مرحلہ) بھی یہی URL دکھاتا ہے، تو آپ کسی بھی وقت اسے دوبارہ کاپی کر سکتے ہیں۔
callback URL سیٹ کریں اور webhook secret کاپی کریں
MakePay میں واپس، Delivery → Callback URL configuration تک سکرول کریں۔ Edit Callback URL پر کلک کریں، اپنے Coin Moebius webhook URL کو فعال منزل کے طور پر پیسٹ کریں، اور محفوظ کریں۔ پھر Webhook signing کے تحت، signing secret کاپی کریں (اگر ابھی کوئی قدر نہیں ہے تو Regenerate secret استعمال کریں)—یہ Coin Moebius سے مانگی جانے والی Webhook secret ہے۔
MakePay → Delivery → Callback URL configuration
MakePay ہر مرچنٹ-واضح حیثیت کی تبدیلی کے بعد اس پتے کو delivery اپ ڈیٹ بھیجتا ہے۔ signing secret API key سے الگ ہے—دونوں چاہیں۔
Coin Moebius ڈیش بورڈ میں منسلک کریں
Coin Moebius میں، Providers → Add provider → MakePay کھولیں۔ اپنی API key ID، API key secret، اور Webhook secret پیسٹ کریں، پھر Success URL اور Failure URL سیٹ کریں (خریدار ادائیگی کے بعد یا ناکام ادائیگی کے بعد کہاں پہنچتے ہیں)۔ محفوظ کریں پر کلک کریں۔
Coin Moebius → Add provider → MakePay
محفوظ شدہ secrets پوشیدہ رہتے ہیں۔ بعد میں کوئی بھی بدلنے کے لیے، Replace منتخب کریں اور نئی قدر داخل کریں۔
آپ منسلک ہو گئے
MakePay اب آپ کے Providers ٹیب پر اس تاریخ کے ساتھ ظاہر ہوتا ہے جب یہ منسلک ہوا اور جو webhook URL وہ توقع کرتا ہے۔ اگر آپ نے ابھی نہیں کیا تو وہ URL MakePay کی callback ترتیبات میں پیسٹ کریں۔ کلیدوں کو گھمانے کے لیے Edit استعمال کریں یا اسے ہٹانے کے لیے Disconnect، اور حقیقی تعداد کو متاثر کیے بغیر آرڈر کے ذریعے چلنے کے لیے Test mode toggle استعمال کریں۔
Coin Moebius → Providers → MakePay (connected)

منسلک کرنے کے بعد

لائیو ہونے سے پہلے ایک آرڈر کے ذریعے چلیں:

منسلک MakePay کارڈ پر Test mode toggle آن کریں تاکہ ایک آرڈر کے ذریعے بغیر حقیقی تعداد کو متاثر کیے چلیں۔
ایک پروڈکٹ بنائیں اور buy button کو اپنے پروجیکٹ کی طرف اشارہ کرتے ہوئے ایک صفحے پر رکھیں (ایک مقامی HTML فائل کام کرتی ہے)۔
MakePay کے ذریعے checkout مکمل کریں۔
Transactions ٹیب کھولیں۔ جب نئی قطار کی حیثیت succeeded تک پہنچے، تو آپ کی کلیدیں اور webhook دونوں سرے سے سرے تک کام کر رہے ہیں۔

جب آپ حقیقی ادائیگیوں کے لیے تیار ہوں تو Test mode آف کریں۔

مسائل کا حل

ڈیش بورڈ میں شروع کریں: تصدیق کریں کہ MakePay کارڈ منسلک دکھائے اور کہ webhook URL MakePay میں محفوظ callback منزل سے مطابقت رکھتا ہے۔

ادائیگی مکمل ہو جاتی ہے مگر آرڈر pending رہتا ہے۔

webhook نہیں آ رہا یا تصدیق نہیں ہو رہی۔ تصدیق کریں کہ MakePay میں callback URL بالکل آپ کے پروجیکٹ کے webhook URL سے مطابقت رکھتا ہے، اور کہ Coin Moebius میں Webhook secret MakePay میں signing secret سے مطابقت رکھتا ہے۔

فراہم کنندہ محفوظ کرنا مسترد ہو جاتا ہے۔

API key ID، API key secret، اور Webhook secret سب ضروری ہیں۔ MakePay سے انہیں دوبارہ کاپی کریں—secret صرف ایک بار دکھایا جاتا ہے، تو اگر آپ کے پاس یہ نہیں ہے تو ایک نئی کلید بنائیں۔

ایک ٹیسٹ آرڈر Transactions میں کبھی ظاہر نہیں ہوتا۔

buy button چلانے سے پہلے MakePay کارڈ پر Test mode toggle آن کریں، اور یقینی بنائیں کہ پروڈکٹ اسی پروجیکٹ کی طرف اشارہ کرتا ہے۔

جاننا اچھا ہے

غیر-حراست دار. MakePay کرپٹو کو براہِ راست آپ کی اپنی والیٹ میں جمع کرتا ہے۔ Coin Moebius فنڈز کو کبھی نہیں رکھتا اور انہیں منتقل نہیں کر سکتا۔

Secrets گھمانا. کسی بھی وقت ایک نئی API key یا webhook signing secret بنائیں، پھر ڈیش بورڈ میں Replace منتخب کریں اور نئی قدر پیسٹ کریں۔ خفیہ فیلڈز ترمیم پر خالی رہتی ہیں۔

سوالات؟ Join our Discord

MakePay