# Square Terminal गेटवे

Square Terminal गेटवे आपको WCPOS से सीधे [Square Terminal](https://squareup.com/hardware/terminal) हार्डवेयर पर WooCommerce ऑर्डर भुगतान स्वीकार करने देता है। भुगतान WooCommerce से अनुरोध किया जाता है और जोड़े गए Square Terminal डिवाइस पर पूरा होता है, फिर परिणाम ऑर्डर में वापस लिखा जाता है।

## विशेषताएँ[​](#features "विशेषताएँ के लिए सीधा लिंक")

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

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

#### आसान पेयरिंग

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

#### Webhook से पुष्टि

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

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

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

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

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

## यह कैसे काम करता है[​](#how-it-works "यह कैसे काम करता है के लिए सीधा लिंक")

ब्राउज़र-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 भेज सके।

## स्थापना[​](#installation "स्थापना के लिए सीधा लिंक")

1

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

`WP Admin > POS > Settings > Extensions` से स्थापित करें, या [GitHub releases page](https://github.com/wcpos/square-terminal-for-woocommerce/releases) से नवीनतम **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](https://developer.squareup.com/apps) से उपलब्ध है
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](https://developer.squareup.com/apps) में अपनी 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 सहेजें

## उपयोग[​](#usage "उपयोग के लिए सीधा लिंक")

### भुगतान प्रोसेस करना[​](#processing-payments "भुगतान प्रोसेस करना के लिए सीधा लिंक")

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 होता है।

### भुगतान नियंत्रण[​](#payment-controls "भुगतान नियंत्रण के लिए सीधा लिंक")

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

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

### ऑर्डर प्रबंधन[​](#order-management "ऑर्डर प्रबंधन के लिए सीधा लिंक")

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

## आवश्यकताएँ[​](#requirements "आवश्यकताएँ के लिए सीधा लिंक")

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 आवश्यक है

## हार्डवेयर संगतता[​](#hardware-compatibility "हार्डवेयर संगतता के लिए सीधा लिंक")

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

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 करने में सक्षम होना चाहिए।

### समर्थित टर्मिनल[​](#supported-terminals "समर्थित टर्मिनल के लिए सीधा लिंक")

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

## दायरा और सीमाएँ[​](#scope-and-limitations "दायरा और सीमाएँ के लिए सीधा लिंक")

v0.1 दायरा

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

## समस्या निवारण[​](#troubleshooting "समस्या निवारण के लिए सीधा लिंक")

### सामान्य समस्याएँ[​](#common-issues "सामान्य समस्याएँ के लिए सीधा लिंक")

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

* सुनिश्चित करें कि आपने 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 देखें

### सहायता प्राप्त करना[​](#getting-help "सहायता प्राप्त करना के लिए सीधा लिंक")

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

* समस्याएँ report करने के लिए [GitHub repository](https://github.com/wcpos/square-terminal-for-woocommerce) पर जाएँ
* hardware और API guidance के लिए [Square Terminal API documentation](https://developer.squareup.com/docs/terminal-api/overview) देखें
* account और hardware issues के लिए Square support से संपर्क करें

## स्क्रीनशॉट[​](#screenshots "स्क्रीनशॉट के लिए सीधा लिंक")

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

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