# Square और Pilotiko: आपका सेल्स अकाउंट जुड़ा हुआ, बिना किसी ऑटोमेशन के

> Square और Pilotiko का कनेक्शन: Pilotiko द्वारा मांगी गई तीन OAuth अनुमतियाँ कौन सी हैं, टोकन कितने समय तक चलते हैं, आज क्या मैन्युअल रहता है और Square का एक्सेस कैसे रद्द करें, जानिए यहाँ।

अपडेट किया गया 8 नवंबर 2026 · https://app.pilotiko.com/hi/integrations/square

Pilotiko आज आपके Square अकाउंट को OAuth से तीन अनुमतियों के साथ जोड़ सकता है: PAYMENTS_READ, PAYMENTS_WRITE और MERCHANT_PROFILE_READ। यह अभी कोई बिक्री नहीं पढ़ता और कोई भुगतान नहीं बनाता। स्थिति: केवल अकाउंट कनेक्शन: अभी कोई स्वचालित कार्रवाई नहीं। आपकी व्यक्तिगत और ऑनलाइन बिक्री Square में ही रहती है।

## संक्षेप में
- स्थिति: केवल अकाउंट कनेक्शन: अभी कोई स्वचालित कार्रवाई नहीं।
- मांगी गई अनुमतियाँ: PAYMENTS_READ, PAYMENTS_WRITE, MERCHANT_PROFILE_READ।
- Square एक्सेस टोकन 30 दिन बाद समाप्त कर देता है; वे रिफ्रेश टोकन से नवीनीकृत होते हैं।
- न बिक्री पढ़ना, न भुगतान, न रिफंड जुड़ा हुआ है।

## Pilotiko में Square कनेक्शन क्या करता है?

यह आपके Square विक्रेता अकाउंट पर Pilotiko को दी गई आपकी अनुमति को एन्क्रिप्टेड रूप में सहेजता है। अभी कोई भी फ़ंक्शन इसका उपयोग नहीं करता।

Square अक्सर एक साथ दो काम करता है: काउंटर का टर्मिनल और ऑनलाइन भुगतान। Pilotiko Square को « Encaissements » (भुगतान संग्रह) क्षमता में **केवल कनेक्शन** स्थिति के साथ रखता है: अनुमति की प्रक्रिया बनी है, लेकिन आपकी बिक्री पर कोई ऑपरेशन नहीं बना है। इसलिए Pilotiko मंगलवार सुबह काउंटर पर हुई किसी बिक्री को नहीं देखेगा, और उसे रिफंड भी नहीं कर पाएगा।

Square हर अनुमति का वर्णन उन एक्सेस पॉइंट्स से करता है जो वह खोलती है [1]। Pilotiko नीचे सूचीबद्ध तीन अनुमतियाँ मांगता है, भुगतान संग्रह और बिक्री के मिलान की तैयारी में। इन्हें मांगने का मतलब यह नहीं कि इनका उपयोग हो रहा है: Payments API या Merchants API को कोई कॉल नहीं की जाती।

Square टोकन JSON फ़ॉर्मेट में लौटाता है; अनुमति कोड 5 मिनट के लिए मान्य है और केवल एक बार काम आता है [2]। Pilotiko, Square के साथ PKCE का उपयोग नहीं करता: आदान-प्रदान सर्वर की ओर से ऐप के सीक्रेट के साथ होता है।

- **PAYMENTS_READ**: भुगतान पढ़ना, जैसे ListPayments या GetPayment [1]। आज उपयोग में नहीं।
- **PAYMENTS_WRITE**: भुगतान बनाना, रद्द करना और रिफंड करना, जैसे CreatePayment या RefundPayment [1]। आज उपयोग में नहीं; भविष्य में कोई भी उपयोग किसी व्यक्ति की मंज़ूरी का इंतज़ार करेगा।
- **MERCHANT_PROFILE_READ**: विक्रेता अकाउंट और उसके बिक्री केंद्रों की जानकारी, जैसे ListLocations या RetrieveMerchant [1]। आज उपयोग में नहीं।

## Square को Pilotiko से कैसे जोड़ें?

अनुमति देने वाला Square अकाउंट व्यवसाय का ही होना चाहिए। अगर Pilotiko ने अभी अपना Square ऐप सक्रिय नहीं किया है, तो कार्ड यह बताता है और कोई बटन नहीं दिखाता।

1. **Square कार्ड ढूँढें** — Pilotiko में, Connexions पेज, Encaissements समूह में।
2. **कनेक्शन शुरू करें** — Connecter पर क्लिक करें; Pilotiko एक बार उपयोग वाला अनुरोध तैयार करता है, जो 10 मिनट के लिए मान्य है और आपके व्यवसाय और आपसे जुड़ा है।
3. **Square का अनुमति पेज पढ़ें** — Square मांगी गई तीन अनुमतियाँ दिखाता है; जाँच लें कि यह सही विक्रेता अकाउंट है।
4. **अनुमति दें** — Square आपको एक कोड के साथ Pilotiko पर वापस भेजता है; Pilotiko उसे टोकन से बदलता है और एन्क्रिप्ट करता है।
5. **जाँचें** — कार्ड « Connecté » (जुड़ा हुआ) हो जाता है और बताता है कि कोई स्वचालित कार्रवाई नहीं होती।

## Square के साथ क्या उपलब्ध है और क्या आने वाला है?

| फ़ंक्शन | स्थिति | विवरण |
|---|---|---|
| Square विक्रेता अकाउंट जोड़ना | केवल अकाउंट कनेक्शन: अभी कोई स्वचालित कार्रवाई नहीं | तीन अनुमतियाँ मांगी गईं, टोकन एन्क्रिप्टेड |
| काउंटर और ऑनलाइन की बिक्री पढ़ना | जल्द ही | Payments API को कोई कॉल नहीं |
| भुगतान बनाना या रिफंड करना | जल्द ही | किसी व्यक्ति की मंज़ूरी ज़रूरी होगी |
| आपके बिक्री केंद्र (Locations) पढ़ना | जल्द ही | Merchants API को कोई कॉल नहीं |
| Pilotiko की ओर से Square को डिस्कनेक्ट करना | उपलब्ध | टोकन मिटा दिए जाते हैं, ऑडिट लॉग |

## Square की एक दिन की बिक्री में से Pilotiko क्या देखता है?

**उदाहरण: 2 बिक्री केंद्रों वाला एक हेयर सैलून और एक शनिवार को Square की 41 बिक्री**

सैलून अपनी दोनों शाखाओं में Square से काउंटर पर भुगतान लेता है और कुछ अग्रिम राशियाँ ऑनलाइन लेता है। Square एक हफ़्ते से Pilotiko से जुड़ा है।

- काउंटर की बिक्री (2 शाखाएँ) : 35
- ऑनलाइन चुकाई गई अग्रिम राशियाँ : 6
- Pilotiko द्वारा पढ़ी गई बिक्री : 0
- Pilotiko द्वारा पढ़े गए बिक्री केंद्र : 2 में से 0
- Pilotiko द्वारा किए गए रिफंड : 0
- **= 41 बिक्री Square में ही रहती हैं; Pilotiko में उस दिन की अपॉइंटमेंट अपने आप « चुकाई गई » चिह्नित नहीं होतीं।**

## आपका Square डेटा कैसे सुरक्षित है (Loi 25)?

Square टोकन स्टोरेज में एन्क्रिप्टेड (AES-256-GCM) रहता है और कभी नहीं दिखाया जाता, न इंटरफ़ेस में, न लॉग में। निजी क्षेत्र पर क्यूबेक के कानून के अनुसार, हर व्यवसाय अपने पास मौजूद व्यक्तिगत जानकारी के लिए ज़िम्मेदार है, और सर्वोच्च अधिकार वाला व्यक्ति कानून के पालन की निगरानी करता है [3]। Pilotiko आज Square की कोई बिक्री डेटा एकत्र नहीं करता: टोकन के अलावा सुरक्षित करने के लिए और कुछ नहीं है।

जिस दिन बिक्री पढ़ी जाएगी, उसमें आपके ग्राहकों की जानकारी होगी; तब कानून एक्सेस का अधिकार देता है, अनुरोध पर संरचित और आमतौर पर इस्तेमाल होने वाले फ़ॉर्मेट में प्रति के साथ [3]। CAI याद दिलाता है कि पोर्टेबिलिटी का यह अधिकार 22 सितंबर 2024 से लागू है [4]। विवरण: [आपके अधिकार](/vos-droits) और [सब-प्रोसेसर](/sous-traitants)।

रद्द करना: Pilotiko में, Déconnecter टोकन मिटा देता है और कार्रवाई को ऑडिट लॉग में दर्ज करता है। Square में, विक्रेता ऐप का एक्सेस रद्द कर सकता है, जिससे उसके टोकन अमान्य हो जाते हैं [2]।

## Square की अपनी सीमाएँ क्या हैं?

Square अपने एक्सेस टोकन 30 दिन बाद समाप्त कर देता है [2]। इसलिए लंबे समय तक इस्तेमाल न हुए कनेक्शन को रिफ्रेश टोकन से नवीनीकृत करना होगा, वरना दोबारा जोड़ना होगा। Square के लिए Pilotiko का OAuth ऐप अभी पंजीकृत नहीं है।

सिर्फ़ ऑनलाइन भुगतान संग्रह के लिए [Stripe](https://app.pilotiko.com/hi/integrations/stripe) से तुलना करें; किसी दूसरे ब्रांड के टर्मिनल के लिए [Clover](https://app.pilotiko.com/hi/integrations/clover) देखें। सभी कनेक्शन [Intégrations](https://app.pilotiko.com/hi/integrations) पेज पर हैं, और आपकी अपॉइंटमेंट माइग्रेशन के ज़रिए पहले से [Acuity Scheduling](https://app.pilotiko.com/hi/integrations/acuity-scheduling) से आ सकती हैं।

## अक्सर पूछे जाने वाले सवाल

### क्या Pilotiko मेरे Square टर्मिनल पर हुई बिक्री देखता है?

नहीं, अभी नहीं। पढ़ने की अनुमति मांगी गई है, लेकिन कोई पढ़ना निर्धारित नहीं है। आपकी बिक्री केवल Square में दिखाई देती है।

### अगर Pilotiko भुगतान नहीं बनाता, तो वह PAYMENTS_WRITE क्यों मांगता है?

ताकि भुगतान संग्रह बाद में आपसे दोबारा एक्सेस मांगे बिना जोड़ा जा सके। आज कोई भुगतान नहीं बनाया जाता, और भविष्य का हर भुगतान किसी व्यक्ति की मंज़ूरी का इंतज़ार करेगा।

### Square की अनुमति कितने समय तक रहती है?

Square एक्सेस टोकन 30 दिन बाद समाप्त कर देता है और नया टोकन पाने के लिए रिफ्रेश टोकन देता है। अगर नवीनीकरण विफल हो जाए, तो कार्ड « à reconnecter » (दोबारा जोड़ें) हो जाता है।

### क्या मैं कई Square शाखाएँ जोड़ सकता हूँ?

कनेक्शन विक्रेता अकाउंट के स्तर पर होता है, जो अपने बिक्री केंद्रों को एक साथ रखता है। Pilotiko अभी इन बिक्री केंद्रों की सूची नहीं पढ़ता।

### Square तक Pilotiko की पहुँच कैसे बंद करें?

टोकन मिटाने के लिए Pilotiko में Déconnecter पर क्लिक करें। आप Square में ऐप को रद्द भी कर सकते हैं, जिससे उसके टोकन अमान्य हो जाते हैं।

### क्या मेरे ग्राहकों को भुगतान के समय कोई बदलाव दिखेगा?

नहीं। Square में कुछ नहीं बदलता: न काउंटर पर, न आपके ऑनलाइन भुगतान लिंक में।

## स्रोत

1. Square Developer, « OAuth permissions reference », https://developer.squareup.com/docs/oauth-api/square-permissions (देखा गया 2026-10-15)
2. Square Developer, « OAuth API overview », https://developer.squareup.com/docs/oauth-api/overview (देखा गया 2026-10-15)
3. LégisQuébec, « Loi sur la protection des renseignements personnels dans le secteur privé (RLRQ, c. P-39.1) », https://www.legisquebec.gouv.qc.ca/fr/document/lc/P-39.1 (देखा गया 2026-10-15)
4. Commission d'accès à l'information du Québec, « Principaux changements apportés par la Loi 25 », https://www.cai.gouv.qc.ca/protection-renseignements-personnels/sujets-et-domaines-dinteret/principaux-changements-loi-25 (देखा गया 2026-10-15)
