Square Terminal गेटवे

Square Terminal गेटवे आपको WCPOS से सीधे Square Terminal हार्डवेयर पर WooCommerce ऑर्डर भुगतान स्वीकार करने देता है। भुगतान WooCommerce से अनुरोध किया जाता है और जोड़े गए Square Terminal डिवाइस पर पूरा होता है, फिर परिणाम ऑर्डर में वापस लिखा जाता है।

विशेषताएँ

हार्डवेयर एकीकरण

जोड़े गए Square Terminal डिवाइसों पर भुगतान भेजें और व्यक्तिगत कार्ड भुगतान स्वीकार करें

आसान पेयरिंग

थोड़े समय के लिए मान्य Square डिवाइस कोड का उपयोग करके WooCommerce से टर्मिनल पेयर करें

Webhook से पुष्टि

सत्यापित Square webhooks पूरा होने की पुष्टि करते हैं, और प्रतीक्षा करते समय लाइव स्थिति दिखती है

सुरक्षित लेनदेन

Square हार्डवेयर पर संभाली जाने वाली PCI-अनुपालक, कार्ड-प्रेजेंट प्रोसेसिंग

सैंडबॉक्स और उत्पादन

लाइव भुगतान पर जाने से पहले Square सैंडबॉक्स में सत्यापन करें

यह कैसे काम करता है

ब्राउज़र-SDK गेटवे के विपरीत, Square Terminal Square की server-side Terminal API का उपयोग करता है। जब आप भुगतान शुरू करते हैं, WooCommerce ऑर्डर के लिए Terminal Checkout बनाता है और Square उसे जोड़े गए डिवाइस पर भेजता है। ग्राहक टर्मिनल पर भुगतान करता है, और Square आपके साइट को signed webhook से सूचित करता है। Webhook ही अधिकृत completion signal है; POS भी polling करता है ताकि प्रतीक्षा करते समय स्थिति अपडेट होती रहे।

इसका मतलब है कि Square Terminal डिवाइस ऑनलाइन होना चाहिए और उसी Square खाते और location में साइन इन होना चाहिए। आपकी साइट भी HTTPS पर सार्वजनिक रूप से पहुंच योग्य होनी चाहिए ताकि Square webhooks भेज सके।

स्थापना

1

Square Terminal for WooCommerce स्थापित करें

WP Admin > POS > Settings > Extensions से स्थापित करें, या GitHub releases page से नवीनतम plugin zip asset डाउनलोड करें (GitHub source-code zip या tarball नहीं) और उसे Plugins > Add New > Upload Plugin के माध्यम से अपलोड करें।

2

Square सेटिंग्स कॉन्फ़िगर करें

1. WP Admin > WooCommerce > Settings > Payments पर जाएँ
2. भुगतान विधियों की सूची में Square Terminal खोजें और सेटिंग्स खोलने के लिए उस पर क्लिक करें
3. Environment चुनें (Sandbox परीक्षण के लिए, Production लाइव भुगतान के लिए)
4. चुने गए environment (Sandbox या Production) के लिए अपना Access Token दर्ज करें, जो Square Developer Dashboard से उपलब्ध है
5. अपना Location ID दर्ज करें — वह Square location जहाँ Terminal भुगतान लिए जाते हैं
6. अपना Webhook Signature Key और Webhook Notification URL दर्ज करें (अगला चरण देखें)
7. credentials काम कर रहे हैं यह पुष्टि करने के लिए सेटिंग्स सत्यापित करें पर क्लिक करें, फिर सहेजें

नोट

आपको WooCommerce सेटिंग्स में Square Terminal गेटवे सक्षम करने की आवश्यकता नहीं है। इसे बाद के चरण में POS के लिए अलग से सक्षम किया जाएगा।

3

Square में Webhooks सेट करें

Terminal भुगतान पूरा होने पर Square signed webhook भेजता है, और यही ऑर्डर को paid के रूप में चिह्नित करता है।

1. Square Developer Dashboard में अपनी application खोलें और Webhooks अनुभाग पर जाएँ
2. terminal.checkout.updated event के लिए subscription जोड़ें
3. notification URL को plugin settings में दिखाए गए Webhook Notification URL पर सेट करें — यह बिल्कुल समान होना चाहिए
4. आने वाले events को verify करने के लिए Webhook Signature Key को plugin settings में कॉपी करें

महत्वपूर्ण

Square में Webhook Notification URL plugin settings के value से बिल्कुल मेल खाना चाहिए, और Webhook Signature Key सही होना चाहिए। यदि ये मेल नहीं खाते, तो Square भुगतान डिवाइस पर पूरा हो जाएगा लेकिन WooCommerce ऑर्डर अपडेट नहीं होगा।

4

अपना Square Terminal पेयर करें

1. उसी settings page पर Create Device Code पर क्लिक करें
2. pairing code generate होकर आपको दिखाया जाएगा
3. अपने Square Terminal पर sign in करें और device-pairing screen पर code दर्ज करें
4. पेयर होने के बाद terminal आपकी configured location से जुड़ जाता है। उसका Device ID नोट करें — भुगतान लेते समय आपको इसे दर्ज करना होगा

महत्वपूर्ण

भुगतान process करने से पहले terminal सफलतापूर्वक paired और online होना चाहिए। आगे बढ़ने से पहले सुनिश्चित करें कि pairing पूरी हो गई है।

5

WCPOS में सक्षम करें

1. WP Admin > POS > Settings > Checkout पर जाएँ
2. सूची में Square Terminal gateway खोजें
3. POS में उपयोग के लिए gateway सक्षम करें
4. अपनी settings सहेजें

उपयोग

भुगतान प्रोसेस करना

1. आइटम जोड़ें: POS में अपने cart में products जोड़ें
2. Gateway चुनें: payment method के रूप में "Square Terminal" चुनें
3. डिवाइस चुनें: उस paired terminal का Terminal Device ID दर्ज करें जो payment लेगा
4. भुगतान शुरू करें: भुगतान शुरू करें पर क्लिक करें — Square checkout को डिवाइस पर push करता है
5. ग्राहक भुगतान: ग्राहक Square Terminal पर अपना card tap, insert या swipe करता है
6. स्वचालित पूर्णता: जब Square का verified webhook payment की पुष्टि करता है, order paid mark हो जाता है। प्रतीक्षा करते समय live status update होता है।

भुगतान नियंत्रण

Square Terminal gateway का उपयोग करते समय आपके पास ये विकल्प होते हैं:

• भुगतान शुरू करें: चुने गए terminal पर नया payment request भेजें
• भुगतान रद्द करें: terminal पर चल रहे payment को cancel करें
• भुगतान स्थिति: live status area payment की current state दिखाता है
• भुगतान लॉग: per-order log हर महत्वपूर्ण Square step और outcome दर्ज करता है

ऑर्डर प्रबंधन

• Webhook को अधिकृत पूर्णता संकेत मानना: orders केवल तब paid mark होते हैं जब verified Square webhook Terminal payment की पुष्टि करता है
• भुगतान ट्रैकिंग: Square identifiers और payment log order पर store होते हैं, और मुख्य steps order notes में लिखे जाते हैं
• रसीद बनाना: successful payments के बाद standard POS receipts generate होती हैं

आवश्यकताएँ

Square खाता: सक्रिय Square seller account

API प्रमाणपत्र: Square Developer Dashboard से Access Token, Location ID, और Webhook Signature Key

संगत हार्डवेयर: एक Square Terminal डिवाइस, online और उसी Square location में sign in किया हुआ

सार्वजनिक HTTPS साइट: आपकी साइट HTTPS पर पहुंच योग्य होनी चाहिए ताकि Square webhooks भेज सके

WCPOS: POS checkout के लिए Pro version आवश्यक है

हार्डवेयर संगतता

कनेक्टिविटी आवश्यकताएँ

Square Terminal Square की server-side Terminal API का उपयोग करता है: checkout आपकी site बनाती है और Square उसे paired device तक पहुंचाता है। terminal online होना चाहिए और उसी Square account और location में sign in होना चाहिए, और orders update करने के लिए आपकी site को HTTPS पर Square webhooks receive करने में सक्षम होना चाहिए।

समर्थित टर्मिनल

• Square Terminal ✅ — Square का dedicated countertop card terminal

दायरा और सीमाएँ

v0.1 दायरा

• यह शुरुआती release POS / order-pay flows पर केंद्रित है। customer-facing storefront checkout पर उपलब्धता default रूप से off है और इसे स्पष्ट रूप से enable करना होगा।
• यह केवल payments collect करता है — refunds अभी supported नहीं हैं। Square identifiers order पर store होते हैं ताकि refund support बाद में जोड़ा जा सके।

समस्या निवारण

सामान्य समस्याएँ

डिवाइस पेयर नहीं हो रहा

• सुनिश्चित करें कि आपने Device Code expire होने से पहले दर्ज किया है — जरूरत हो तो Create Device Code से नया code generate करें
• पुष्टि करें कि terminal online है और plugin वाले same Square account और Location ID में sign in है
• जाँचें कि Environment (Sandbox/Production) और Access Token उस account से मेल खाते हैं जिसमें terminal sign in है

सेटिंग्स सत्यापित करना असफल होता है

• सत्यापित करें कि Access Token चुने गए Environment से मेल खाता है (Sandbox token Production में काम नहीं करेगा, और इसके उलट भी)
• पुष्टि करें कि Location ID उसी account से संबंधित है
• अनचाहे characters से बचने के लिए Square Developer Dashboard से token फिर से copy करें

Terminal पर payment पूरा होता है लेकिन order update नहीं होता

• Square में Webhook Notification URL plugin setting से बिल्कुल समान होना चाहिए
• सुनिश्चित करें कि Square Developer Dashboard में terminal.checkout.updated event subscribed है
• पुष्टि करें कि plugin में Webhook Signature Key Square वाले key से मेल खाता है
• सुनिश्चित करें कि आपकी site HTTPS पर सार्वजनिक रूप से reachable है; Square Dashboard में webhook delivery attempts देखें

भुगतान शुरू नहीं होता

• पुष्टि करें कि valid Terminal Device ID दर्ज है और device paired और online है
• जाँचें कि device configured Location ID में sign in है
• Square API messages के लिए Payment Log और WordPress error logs देखें

सहायता प्राप्त करना

तकनीकी सहायता के लिए:

• समस्याएँ report करने के लिए GitHub repository पर जाएँ
• hardware और API guidance के लिए Square Terminal API documentation देखें
• account और hardware issues के लिए Square support से संपर्क करें

स्क्रीनशॉट

Screenshots भविष्य के update में जोड़े जाएँगे ताकि यह दिखाया जा सके:

• Square credentials, webhook, और device-pairing configuration
• WCPOS settings में gateway enablement
• POS checkout में payment processing workflow