Square منسلک کریں

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

فیلڈ	یہ کیا کرتا ہے
Access token	ہمیں checkout link بنانے کے لیے Square کو کال کرنے دیتی ہے۔ خفیہ۔
Webhook signature key	تصدیق کرتی ہے کہ ایک webhook واقعی Square سے آیا۔ خفیہ۔
Location ID	وہ Square مقام جو ادائیگی وصول کرتا ہے۔ کرنسی طے کرتا ہے۔
Success URL / Cancel URL	ادائیگی کے بعد یا واپس ہٹنے کے بعد خریدار کہاں پہنچتا ہے۔

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

Access token

checkout link بنانے کی اجازت دیتا ہے، تاکہ چارج آپ کے اکاؤنٹ کے ذریعے چلے۔

Webhook signature key

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

Location ID

Square کو بتاتا ہے کہ کون سا مقام رقم وصول کرتا ہے، اور چیک آؤٹ کرنسی طے کرتا ہے۔ خفیہ نہیں۔

Success and Cancel URL

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

سیٹ اپ

Square Developer ڈیش بورڈ کھولیں
developer.squareup.com پر سائن اِن کریں۔ ہر ایپلیکیشن کے اپنے اسناد ہوتے ہیں، اور ٹیسٹنگ کے لیے اس کے ساتھ ایک مفت Sandbox بنایا جاتا ہے۔ یہ رہنما Sandbox کے ذریعے چلتا ہے؛ Live بہاؤ بالکل یکساں ہے، بس Sandbox / Production ٹوگل پلٹیں اور اپنے production اسناد استعمال کریں۔ ایک نئی ایپ بنانے کے لیے، Applications اسکرین پر + ٹائل پر کلک کریں۔
Square Developer → Applications
اپنی ایپلیکیشن کا نام دیں
ایپلیکیشن کو ایک ایسا نام دیں جسے آپ پہچانیں (مثلاً "Coin Moebius")، پھر Next پر کلک کریں۔
Square → Name your application
اپنا access token کاپی کریں
ایپ کھولیں اور Credentials پر جائیں۔ اوپر موجود Sandbox / Production ٹوگل تصدیق کریں کہ وہ اس ماحول سے مطابقت رکھتا ہے جسے آپ ترتیب دے رہے ہیں۔ Access token کے ساتھ copy آئکن پر کلک کریں اور اسے الگ رکھیں۔
Square → Credentials
access token خفیہ ہے، اسے پاس ورڈ کی طرح سمجھیں۔ Sandbox اور Production کے الگ ٹوکن ہوتے ہیں، تو انہیں آپس میں ملائیں نہیں۔
اپنا Location ID کاپی کریں
بائیں مینو میں، Locations کھولیں۔ اُس مقام کا Location ID کاپی کریں جو ادائیگیاں وصول کرے۔ یہ چیک آؤٹ کرنسی طے کرتا ہے، تو وہ مقام چنیں جس کی کرنسی میں آپ چارج کرنا چاہتے ہیں۔
Square → Locations
Webhooks → Subscriptions کھولیں
Square ایک webhook endpoint کو "subscription" کہتا ہے۔ بائیں مینو میں، Webhooks پھیلائیں، Subscriptions کھولیں، اور Add subscription پر کلک کریں۔
Square → Webhooks → Subscriptions → Add subscription
subscription شامل کریں اور ایونٹس منتخب کریں
اسے ایک نام دیں (جیسے "coin-moebius")۔ Notification URL میں، اپنے پروجیکٹ کا Square webhook پتہ (نیچے) پیسٹ کریں۔ پھر، Events کے تحت، وہ ایونٹس تلاش کریں اور چیک کریں جنہیں Coin Moebius سنتا ہے، اور Save پر کلک کریں۔
- ایک-بار کی ادائیگیاں: payment.created, payment.updated, refund.created, refund.updated, dispute.created, dispute.state.updated۔
- سبسکرپشنز (صرف اگر آپ انہیں بیچتے ہیں): subscription.created, subscription.updated, subscription.canceled, subscription.deactivated, invoice.payment_made, invoice.scheduled_charge_failed۔ اگر آپ بار بار بلنگ نہیں کرتے، تو انہیں چھوڑ دیں۔
```
https://api.coinmoebius.com/webhook/square/<your project id>
```
Square → Add a webhook subscription
آپ کی پروجیکٹ id Coin Moebius ڈیش بورڈ میں پروجیکٹ کے نام کے نیچے ہے؛ اسے اوپر دیے گئے پتے میں ڈالیں۔ اضافی ایونٹس بے ضرر ہیں، جو ہم استعمال نہیں کرتے اسے نظر انداز کر دیتے ہیں۔ منسلک فراہم کنندہ کارڈ (آخری مرحلہ) حوالے کے لیے وہی URL دکھاتا ہے۔
ابھی بنائی گئی subscription کھولیں
Square subscription محفوظ کرتا ہے اور اسے Webhooks کے تحت Enabled حیثیت کے ساتھ درج کرتا ہے۔ تفصیلات پینل کھولنے کے لیے اس کے نام پر کلک کریں جہاں signing key موجود ہے۔
Square → Webhooks → آپ کی subscription (Enabled)
Signature key کاپی کریں
subscription کے Properties پینل میں، Signature key کے ساتھ copy آئکن پر کلک کریں۔ یہ وہ قدر ہے جو Coin Moebius اس بات کی تصدیق کرنے کے لیے استعمال کرتا ہے کہ ہر webhook واقعی Square سے آیا۔ یہ صرف subscription بنانے کے بعد موجود ہوتی ہے، یہی وجہ ہے کہ webhook منسلک مرحلے سے پہلے آیا۔
Square → آپ کی subscription → Signature key
Coin Moebius میں: Add provider → Square
اپنے پروجیکٹ میں، Providers ٹیب کھولیں، Add provider پر کلک کریں، Connect a service چنیں، اور Square منتخب کریں۔ اپنا Success URL اور Cancel URL سیٹ کریں۔ Live ٹیب پر، اپنا Access token، Webhook signature key، اور Location ID پیسٹ کریں، پھر Save پر کلک کریں۔ پہلے sandbox اسناد کے ساتھ ترتیب دینا چاہتے ہیں؟ انہیں Test ٹیب پر پیسٹ کریں، پھر بعد میں Edit سے live اسناد شامل کریں۔
Coin Moebius → Add provider → Square
آپ منسلک ہو گئے
Square اب آپ کے Providers ٹیب پر منسلک ہونے کی تاریخ کے ساتھ ظاہر ہوتا ہے۔ کارڈ وہی webhook URL دکھاتا ہے جو آپ نے Square میں پیسٹ کی، ساتھ میں Edit اور Disconnect بھی۔ لائیو جانے سے پہلے ایک sandbox آرڈر کو سرے سے سرے تک چلانے کے لیے Test mode ٹوگل استعمال کریں۔
Coin Moebius → Providers → Square (connected)
Sandbox کارڈز کبھی کسی حقیقی کارڈ پر چارج نہیں کرتے۔ کارڈ 4111 1111 1111 1111، CVV 111، کوئی بھی مستقبل کی میعاد، کوئی بھی درست پوسٹل کوڈ (مثلاً 94103) استعمال کریں۔

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

لائیو ہونے سے پہلے ایک ٹیسٹ ادائیگی چلائیں:

ایک پروڈکٹ بنائیں اور اس کا Environment Testing پر سیٹ کریں۔ یہ پروڈکٹ کو آپ کے سینڈ باکس اسناد پر چلاتا ہے، تو آپ رقم منتقل کیے بغیر مکمل آرڈر دے سکتے ہیں۔ (اگر آپ نے سینڈ باکس سیٹ چھوڑ دیا، تو ایک Testing پروڈکٹ لائیو پر واپس آ جاتی ہے، تو پہلے اسے شامل کریں۔)
buy button کو ایک ایسے صفحے پر رکھیں (ایک مقامی HTML فائل کام کرتی ہے) جو آپ کے پروجیکٹ کی طرف اشارہ کرتا ہو۔
اوپر دیے گئے سینڈ باکس ٹیسٹ کارڈ سے چیک آؤٹ مکمل کریں۔
Transactions ٹیب کھولیں۔ ایک نئی قطار ظاہر ہوتی ہے، Testing کے ٹیگ کے ساتھ۔ جب اس کی حیثیت succeeded تک پہنچے، تو آپ کے اسناد اور webhook دونوں سرے سے سرے تک کام کر رہے ہیں۔

جب آپ حقیقی ادائیگیوں کے لیے تیار ہوں تو پروڈکٹ کا Environment Live پر سوئچ کریں۔

مسائل کا حل

Verify سے شروع کریں۔ ڈیش بورڈ میں، اپنا access token اور مقام جانچنے کے لیے Verify (یا Verify test credentials) پر کلک کریں۔

Verify ناکام ہو جاتا ہے۔

access token اور Location ID دوبارہ کاپی کریں۔ Production اور Sandbox کے الگ ٹوکن ہوتے ہیں، تو انہیں آپس میں ملائیں نہیں۔

دستخط کی تصدیق ناکام ہو جاتی ہے، یا آرڈر pending رہتا ہے۔

Square عین notification URL کے علاوہ باڈی پر دستخط کرتا ہے۔ جو URL آپ Square میں رجسٹر کرتے ہیں اسے آپ کے webhook URL سے حرف بہ حرف مطابقت رکھنی چاہیے، بغیر کسی ٹریلنگ سلیش اور بغیر کسی اضافی query string کے۔ پھر اُسی endpoint سے signature key دوبارہ کاپی کریں۔

سرے سے سرے تک تصدیق کریں۔

Square Developer Console → Webhooks → your subscription → Send Test Event، پھر آرڈر کو اپ ڈیٹ ہوتے دیکھیں۔

جاننا اچھا ہے

کرنسی مقام کی پیروی کرتی ہے. چیک آؤٹ اُس مقام کی کرنسی میں چارج کرتا ہے جس کی id آپ فراہم کرتے ہیں۔

secrets گھمانا. کسی بھی وقت access token یا signature key گھمائیں، پھر نئی قدر پیسٹ کریں۔ خفیہ فیلڈز ترمیم پر خالی رہتی ہیں۔

سوالات؟ Join our Discord

Square