استعمال کی صورتیں

آن لائن اسٹور میں بغیر پلگ اِن کرپٹو ادائیگیاں قبول کریں

آن لائن اسٹور Crypto Merchant کے ساتھ کرپٹو اس طرح قبول کرتا ہے کہ REST API کے ذریعے فی آرڈر ایک انوائس بناتا ہے اور کسٹمر کو انوائس کے ہوسٹڈ چیک آؤٹ پیج پر بھیجتا ہے۔ کسٹمر ایک کوائن چنتا ہے، اس انوائس کے لیے لاک شدہ ریٹ پر درست رقم ادا کرتا ہے، اور سائن شدہ invoice.paid webhook آنے پر آپ کا سرور آرڈر شپ کرتا ہے۔ فیس فی ادا شدہ انوائس 1% ہے۔ کوئی WooCommerce، Shopify یا Magento پلگ اِن نہیں: انٹیگریشن ایک API کال اور ایک webhook اینڈ پوائنٹ ہے۔

اپ ڈیٹ: 6 نومبر، 2026

اس پیج پر لکھی ہر بات بتاتی ہے کہ Crypto Merchant آج کیسے کام کرتا ہے، جیسا کہ API ریفرنس، چیک آؤٹ ڈاکس اور قیمتیں میں درج ہے۔ یہاں کوئی بات دوسرے گیٹ ویز کے بارے میں دعویٰ نہیں۔

ایک نظر میں

موضوع	یہ کیسے کام کرتا ہے
کسٹمرز کیسے ادا کرتے ہیں	ایک ہوسٹڈ انوائس پیج پر: وہ آپ کے قبول کردہ کوائنز میں سے ایک کوائن اور نیٹ ورک چنتے ہیں، درست رقم اور اس انوائس کے لیے بنایا گیا ڈپازٹ ایڈریس دیکھتے ہیں، QR کوڈ اور کاؤنٹ ڈاؤن کے ساتھ۔
آپ کیا بناتے ہیں	جب کسٹمر کرپٹو چنے تو ایک `POST /invoices` کال، اور webhooks کے لیے ایک HTTPS اینڈ پوائنٹ۔ کوئی بھی زبان یا فریم ورک جو HTTPS ریکویسٹ کر سکے۔
کب شپ کریں	`invoice.paid` ایونٹ پر، جب ادائیگی کو اس کی کنفرمیشنز مل جائیں۔ کبھی `invoice.confirming` پر نہیں۔
غلط رقم	جو ادائیگی آپ کی گنجائش سے زیادہ کم نہ ہو وہ ادا شدہ شمار ہوتی ہے۔ اس سے بڑی کمی انوائس کو `underpaid` بنا دیتی ہے: کسٹمر باقی رقم بھیج سکتا ہے یا بھیجی گئی رقم واپس لے سکتا ہے۔ زائد ادائیگی پھر بھی ادا شدہ شمار ہوتی ہے، اور اضافی رقم کسٹمر کے لیے رکھی جاتی ہے۔
قیمت کی کرنسی	ڈیفالٹ طور پر امریکی ڈالر، یا کوئی اور سپورٹڈ کرنسی جیسے EUR، GBP، TRY یا BRL؛ کوائن کی رقم اس وقت لائیو قیمتوں سے نکالی جاتی ہے جب کسٹمر کوائن چنتا ہے۔
پلگ اِنز	کوئی نہیں۔ نیچے دیا گیا فلو کسی بھی کارٹ یا کسٹم چیک آؤٹ کے ساتھ کام کرتا ہے جو API کال کر سکے۔

یہ قدم بہ قدم کیسے کام کرتا ہے؟

کسٹمر کے “کرپٹو سے ادا کریں” چننے سے آرڈر کے آپ کے گودام سے نکلنے تک:

1
چیک آؤٹ پر انوائس بنائیں
جب کسٹمر کرپٹو چنتا ہے تو آپ کا سرور POST /invoices کال کرتا ہے، جس میں آرڈر کی کل رقم، آپ کا order_id، کسٹمر کا ای میل، آپ کے شکریہ پیج پر واپسی کا redirect_url اور کوئی بھی metadata جو آپ واپس چاہتے ہوں شامل ہوتا ہے۔ جواب میں checkout_url کے ساتھ انوائس ملتی ہے۔
2
کسٹمر کو انوائس پیج پر بھیجیں
checkout_url پر ری ڈائریکٹ کریں۔ پیج آپ کے قبول کردہ کوائنز دکھاتا ہے؛ جب کسٹمر ایک چنتا ہے تو اس کوائن میں رقم لائیو قیمتوں سے نکال کر لاک کی جاتی ہے، اور اس انوائس کے لیے بنایا گیا ڈپازٹ ایڈریس QR کوڈ کے ساتھ دکھایا جاتا ہے۔ انوائس آپ کے مقرر کردہ وقت تک کھلی رہتی ہے، ڈیفالٹ طور پر 30 منٹ۔
3
سائن شدہ webhooks وصول کریں
آپ کے اینڈ پوائنٹ کو invoice.confirming اس وقت ملتا ہے جب ادائیگی آن چین نظر آتی ہے، اور invoice.paid جب اسے کافی کنفرمیشنز مل جاتی ہیں۔ CM-Signature ہیڈر کی تصدیق کریں، ایونٹ محفوظ کریں، 10 سیکنڈ کے اندر 2xx جواب دیں، پھر اپنی محفوظ کاپی سے آرڈر ریلیز کریں۔ ایونٹس دو بار آ سکتے ہیں: ایک ہی بار شپ کرنے کے لیے ایونٹ کا id استعمال کریں۔
4
تین خاص صورتیں سنبھالیں
invoice.expired: وقت پر کوئی ادائیگی نہیں آئی، اس لیے نئی انوائس پیش کریں۔ invoice.underpaid: کسٹمر باقی رقم اسی ایڈریس پر بھیج سکتا ہے یا انوائس پیج سے ریفنڈ لے سکتا ہے۔ زائد ادا شدہ انوائس پھر بھی ادا شدہ ہے؛ اضافی رقم کسٹمر کے لیے رکھی جاتی ہے، جو وہ انوائس پیج سے نکال سکتا ہے۔
5
پے آؤٹ لیں
کنفرم شدہ ادائیگیاں 1% منہا کر کے آپ کے بیلنس میں جمع ہوتی ہیں اور آپ کے کاروبار کے پول والٹ میں سویپ ہو جاتی ہیں۔ کسی بھی وقت اپنے ایڈریسز پر پے آؤٹ کریں، ہر کوائن جیسا ہے ویسا یا سب کچھ ایک ہولڈنگ کوائن میں سواپ کر کے۔

صرف ایک API کال جو درکار ہے

چیک آؤٹ پر انوائس بنائیں

curl https://cryptomerchant.online/api/v1/invoices \
  -H "Authorization: Bearer $CM_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "64.00",
    "currency": "USD",
    "order_id": "ORD-20931",
    "description": "Order ORD-20931",
    "customer_email": "[email protected]",
    "redirect_url": "https://yourstore.example/orders/20931/thanks",
    "metadata": { "cart": "20931" }
  }'

# 201 → { "id": "inv_…", "status": "open", "checkout_url": "https://cryptomerchant.online/pay/i/inv_…", … }
# Send the customer to checkout_url. Ship on the "invoice.paid" webhook.

اس کی لاگت کیا ہے؟

ہر ادا شدہ انوائس کا 1%، جو ادائیگی آپ کے بیلنس میں جمع ہونے پر منہا کیا جاتا ہے۔ کوئی سیٹ اپ فیس، کوئی ماہانہ فیس اور لائیو ہونے کے لیے کوئی ادائیگی نہیں؛ ایکسپائر اور منسوخ شدہ انوائسز پر کچھ نہیں لگتا۔ کوائنز منتقل کرنے (سویپس، سواپس اور پے آؤٹس) پر گیس فیس لگتی ہے، جو آپ کے گیس بیلنس سے لی جاتی ہے اگر آپ نے شامل کیا ہو، ورنہ منتقل ہونے والے کوائنز سے۔ کسٹمرز بھی ہر انوائس پر گیس فیس ادا کرتے ہیں: یہ ان کی بھیجی جانے والی رقم میں شامل ہوتی ہے، چیک آؤٹ پر دکھائی جاتی ہے اور کبھی $5 سے زیادہ نہیں ہوتی۔ سواپ ریٹس میں 1% سروس مارجن شامل ہے۔ ہر لاگت قیمتیں پر ایک ہی ٹیبل میں ہے۔

Crypto Merchant یہاں کیا نہیں کرتا

کوئی شاپ پلگ اِن نہیں۔ کوئی WooCommerce، Shopify، Magento، PrestaShop یا OpenCart ماڈیول نہیں۔ API کال آپ خود شامل کرتے ہیں، یا اپنا چیک آؤٹ پیج اور پیمنٹ لنکس شیئر کرتے ہیں۔
کوئی خودکار ریفنڈ نہیں، اور API میں کوئی ریفنڈ کال نہیں۔ کنفرم شدہ کرپٹو ادائیگی حتمی ہوتی ہے، اس لیے ریفنڈ ایک نئی ٹرانسفر ہے۔ سامان کی واپسی پر کوئی ایڈمن پورٹل میں ادا شدہ پیمنٹ سے ایک نجی ریفنڈ لنک بناتا ہے؛ کسٹمر اپنا ایڈریس خود درج کرتا ہے، نیٹ ورک فیس ریفنڈ سے کٹتی ہے اور 1% فیس واپس نہیں کی جاتی۔
کسٹوڈیل، صرف کرپٹو۔ آپ کے پے آؤٹ کرنے تک کیز Crypto Merchant کے پاس رہتی ہیں، اور پے آؤٹس آپ کے اپنے والٹ ایڈریسز پر جاتے ہیں، بینک اکاؤنٹ میں نہیں۔

یہ کس کے لیے ہے؟

ایسے اسٹورز جو پہلے سے اپنا چیک آؤٹ چلاتے ہیں اور ایک API کال اور ایک webhook شامل کر سکتے ہیں۔
ایسے اسٹورز جو ان ملکوں کے کسٹمرز کو بیچتے ہیں جہاں کارڈ ملنا مشکل ہے یا جہاں چارج بیکس نقصان دیتے ہیں۔
ایسے اسٹورز جو ڈالر میں قیمت لگاتے ہیں اور USDT یا USDC میں رقم لینا چاہتے ہیں۔

اکثر پوچھے جانے والے سوالات

کیا Crypto Merchant کے لیے WooCommerce یا Shopify پلگ اِن ہے؟

نہیں۔ انٹیگریشن ایک API کال ہے جو انوائس بناتی ہے اور ایک webhook اینڈ پوائنٹ جو ادائیگی ہونے کی اطلاع پاتا ہے۔ اگر پلگ اِن لازمی ہو تو متبادل کے پیجز ایسے گیٹ ویز درج کرتے ہیں جن کے پاس پلگ اِن ہے۔

کرپٹو ادائیگی کنفرم ہونے میں کتنا وقت لگتا ہے؟

یہ نیٹ ورک پر منحصر ہے۔ ہر نیٹ ورک کی کنفرمیشنز کی ایک مقررہ تعداد ہے، جو کوائنز اور نیٹ ورکس میں درج ہے۔ Tron، Solana، BNB Smart Chain، Polygon، Base اور Arbitrum پر اسٹیبل کوائنز عام طور پر چند منٹ میں کنفرم ہو جاتے ہیں؛ Bitcoin کو 2 کنفرمیشنز درکار ہیں، عام طور پر تقریباً 20 منٹ۔

اگر کسٹمر غلط رقم ادا کرے تو کیا ہوتا ہے؟

آپ کی گنجائش کے اندر کمی ادا شدہ شمار ہوتی ہے۔ اس سے بڑی کمی انوائس کو کم ادا شدہ بنا دیتی ہے، اور کسٹمر انوائس پیج سے باقی رقم بھیج سکتا ہے یا بھیجی گئی رقم واپس لے سکتا ہے۔ زائد ادائیگی پھر بھی ادا شدہ شمار ہوتی ہے، اور اضافی رقم کسٹمر کے نکالنے کے لیے رکھی جاتی ہے۔

کیا کسٹمر کو Crypto Merchant اکاؤنٹ کی ضرورت ہے؟

نہیں۔ کسٹمر کو صرف ایک والٹ چاہیے جس میں وہ کوائن ہو جس سے وہ ادا کرنا چاہتا ہے۔ وہ انوائس پیج کھولتا ہے، کوائن چنتا ہے اور دکھائی گئی رقم بھیجتا ہے۔

کیا میں آرڈرز کی قیمت یورو یا کسی اور کرنسی میں لگا سکتا ہوں؟

جی ہاں۔ انوائسز کی قیمت ڈیفالٹ طور پر امریکی ڈالر میں ہوتی ہے، اور کرنسی فیلڈ دیگر سپورٹڈ کرنسیاں قبول کرتی ہے جیسے EUR، GBP، TRY یا BRL۔ کوائن کی رقم اس وقت لائیو قیمتوں سے نکالی جاتی ہے جب کسٹمر کوائن چنتا ہے۔

دیگر استعمال کی صورتیں

تمام استعمال کی صورتیں

آج ہی کرپٹو قبول کرنا شروع کریں

مفت سیٹ اپ، سائن اپ کے لیے کوئی دستاویزات نہیں، فی ادا شدہ انوائس 1%، اور جب چاہیں پے آؤٹس۔

اپنا اکاؤنٹ بنائیں ڈاکس پڑھیں