آپ کو کیا درکار ہے
| فیلڈ | یہ کیا کرتا ہے |
|---|---|
| API key | ہمیں ادائیگی بنانے کے لیے NOWPayments کو کال کرنے دیتی ہے۔ خفیہ۔ |
| IPN secret | تصدیق کرتی ہے کہ ایک ادائیگی اطلاع واقعی NOWPayments سے آئی۔ خفیہ۔ |
| Success URL / Cancel URL | ادائیگی کے بعد یا واپس ہٹنے کے بعد خریدار کہاں پہنچتا ہے۔ |
IPN (Instant Payment Notification) NOWPayments کا نام ہے اُس webhook کے لیے جو وہ ادائیگی کی حیثیت بدلنے پر بھیجتے ہیں۔
ہم ہر فیلڈ کیوں مانگتے ہیں
API key
ادائیگی بنانے کی اجازت دیتی ہے، تاکہ فنڈز آپ کے اکاؤنٹ میں طے ہوں۔
IPN secret
ثابت کرتی ہے کہ آنے والی اطلاع واقعی NOWPayments سے ہے، تاکہ کوئی بھی جعلی "paid" ایونٹ نہ بنا سکے۔ یہ API key سے ایک الگ قدر ہے۔
Success and Cancel URL
سادہ ترتیبات: ادائیگی کے بعد یا واپس ہٹنے کے بعد خریدار کہاں پہنچتا ہے۔ خفیہ نہیں۔
سیٹ اپ
- ٹیسٹنگ: کوئی سینڈ باکس نہیں ہے
NOWPayments میں کوئی سینڈ باکس یا ٹیسٹ ماحول نہیں ہے۔ سرے سے سرے تک تصدیق کے لیے، ایک کم-فیس والے سکے میں ایک چھوٹی حقیقی ادائیگی بھیجیں اور تصدیق کریں کہ یہ آپ کے ڈیش بورڈ میں ظاہر ہوتی ہے۔ اُس پہلی چھوٹی ادائیگی کو اپنے ٹیسٹ کے طور پر سمجھیں۔ ایک NOWPayments اکاؤنٹ مفت ہے؛ آپ صرف حقیقی ادائیگیوں پر معمول کی نیٹ ورک اور سروس فیس ادا کرتے ہیں۔
- NOWPayments میں Payments Settings کھولیں
account.nowpayments.io پر سائن اِن کریں اور Settings → Payments پر جائیں۔ اِس ایک اسکرین پر آپ کو تین چیزیں درکار ہیں: Payout wallets (جہاں فنڈز پہنچتے ہیں)، API keys، اور Instant payment notifications۔ آپ ہر ایک کو باری باری دیکھیں گے۔
NOWPayments → Settings → Payments - ایک payout wallet شامل کریں
NOWPayments API کو صرف اُسی وقت فعال کرتا ہے جب آپ کے پاس ایک payout wallet فائل پر ہو۔ Payout wallets پر، Add new wallet پر کلک کریں، ایک کرنسی چنیں، اپنا ایک wallet address پیسٹ کریں جس پر آپ کا اختیار ہو، اور Add wallet پر کلک کریں۔ یہ وہ پتہ ہے جہاں آپ کا کرپٹو settle ہوتا ہے۔
NOWPayments → Payout wallets → Add new wallet - ایک API key بنائیں
API keys کھولیں اور Add new API key پر کلک کریں۔ آپ کی کلیدیں یہاں درج ہیں، ہر ایک کے ساتھ ایک copy آئکن ہے، تاکہ آپ کسی بھی وقت واپس آ کر کلید دوبارہ کاپی کر سکیں۔
NOWPayments → Settings → API keys - اپنی API key کاپی کریں
NOWPayments نئی کلید ایک "API key created" dialog میں دکھاتا ہے۔ Your API key کے ساتھ copy آئکن پر کلک کریں اور اسے الگ رکھیں۔ (اس کے نیچے موجود public key Coin Moebius کو درکار نہیں۔) آپ ایک اختیاری لیبل شامل کر سکتے ہیں، پھر Save پر کلک کریں۔
NOWPayments → API key created یہ آپ کی خفیہ API key ہے۔ اسے پاس ورڈ کی طرح سمجھیں۔
- IPN callback سیٹ اپ کریں اور IPN secret کاپی کریں
Instant payment notifications کھولیں۔ IPN (Instant Payment Notification) NOWPayments کا نام ہے اُس webhook کے لیے جو وہ ادائیگی کی حیثیت بدلنے پر بھیجتے ہیں۔
- Webhook URL فیلڈ میں، اپنے پروجیکٹ کا NOWPayments webhook پتہ (نیچے) پیسٹ کریں، پھر Save پر کلک کریں۔
- اوپر دکھائی گئی IPN secret key کاپی کریں (اگر کوئی قدر نہ ہو تو Regenerate استعمال کریں)۔
- Choose webhook format کے تحت، Classic way منتخب کریں تاکہ رقمیں اور IDs اپنی معمول کی عددی شکل میں رہیں۔
https://api.coinmoebius.com/webhook/nowpayments/<your project id>NOWPayments → Instant payment notifications آپ کی پروجیکٹ id Coin Moebius ڈیش بورڈ میں پروجیکٹ کے نام کے نیچے ہے؛ اسے اوپر دیے گئے پتے میں ڈالیں۔ منسلک فراہم کنندہ کارڈ (آخری مرحلہ) وہی URL دکھاتا ہے، تاکہ آپ اسے کسی بھی وقت دوبارہ کاپی کر سکیں۔
- Coin Moebius میں: Add provider → NOWPayments
اپنے پروجیکٹ میں، Providers ٹیب کھولیں، Add provider پر کلک کریں، Connect a service چنیں، اور NOWPayments منتخب کریں۔ اپنی API key اور IPN secret پیسٹ کریں، Success URL اور Cancel URL سیٹ کریں (جہاں خریدار ادائیگی کے بعد یا واپس ہٹنے کے بعد پہنچتے ہیں)، پھر Save پر کلک کریں۔
Coin Moebius → Add provider → NOWPayments - آپ منسلک ہو گئے
NOWPayments اب آپ کے Providers ٹیب پر منسلک ہونے کی تاریخ کے ساتھ ظاہر ہوتا ہے۔ کارڈ وہی webhook URL دکھاتا ہے جو آپ نے NOWPayments میں پیسٹ کی، ساتھ میں Edit اور Disconnect بھی۔ چونکہ NOWPayments کا کوئی سینڈ باکس نہیں ہے، ہم IPN secret کی خودکار تصدیق نہیں کر سکتے، لہٰذا کارڈ ایک micro-payment ٹیسٹ پیش کرتا ہے: ایک چھوٹی حقیقی ادائیگی بھیجیں تاکہ تصدیق ہو کہ سب کچھ سرے سے سرے تک کام کر رہا ہے۔
Coin Moebius → Providers → NOWPayments (connected)
منسلک کرنے کے بعد
کوئی سینڈ باکس نہیں ہے، تو آپ کی پہلی چھوٹی حقیقی ادائیگی ہی ٹیسٹ ہے:
- ایک پروڈکٹ بنائیں اور buy button کو ایک ایسے صفحے پر رکھیں (ایک مقامی HTML فائل کام کرتی ہے) جو آپ کے پروجیکٹ کی طرف اشارہ کرتا ہو۔
- ایک کم-فیس والے سکے میں ایک چھوٹی رقم ادا کریں۔
- Transactions ٹیب کھولیں۔ جب نئی قطار کی حیثیت succeeded تک پہنچے، تو آپ کی API key اور IPN secret دونوں سرے سے سرے تک کام کر رہے ہیں۔
مسائل کا حل
ادائیگی مکمل ہو جاتی ہے مگر آرڈر pending رہتا ہے۔
IPN نہیں آ رہا یا تصدیق نہیں ہو رہی۔ تصدیق کریں کہ callback URL مطابقت رکھتا ہے اور کہ ڈیش بورڈ میں IPN secret آپ کی NOWPayments ترتیبات میں IPN Secret Key سے مطابقت رکھتا ہے۔
ادائیگی کیے بغیر ٹیسٹ کرنے کا کوئی طریقہ نہیں۔
درست، کوئی سینڈ باکس نہیں ہے۔ ایک حقیقی IPN چلانے کے لیے ایک کم-فیس والے سکے میں ایک چھوٹی حقیقی ادائیگی بھیجیں، پھر آرڈر کو اپ ڈیٹ ہوتے دیکھیں۔
حیثیت صرف حقیقی سرگرمی پر بدلتی ہے۔
NOWPayments کی حیثیت IPN ترسیلات کی عکاسی کرتی ہے، تو ایک خاموش اکاؤنٹ کسی حقیقی ادائیگی کے منتقل ہونے تک کوئی حیثیت نہیں دکھاتا۔
جاننا اچھا ہے
کوئی ٹیسٹ موڈ نہیں. ایک چھوٹی حقیقی ادائیگی سے تصدیق کریں، سینڈ باکس سے نہیں۔
secrets گھمانا. کسی بھی وقت ایک نئی API key یا IPN secret بنائیں، پھر نئی قدر پیسٹ کریں۔
سوالات؟ Join our Discord