आपको क्या चाहिए
| फ़ील्ड | यह क्या करता है |
|---|---|
| Access token | हमें चेकआउट लिंक बनाने के लिए Square को कॉल करने देता है। गुप्त। |
| Webhook signature key | पुष्टि करता है कि कोई वेबहुक सचमुच Square से आया। गुप्त। |
| Location ID | वह Square location जो भुगतान प्राप्त करता है। मुद्रा तय करता है। |
| Success URL / Cancel URL | जहां खरीदार भुगतान करने या पीछे हटने के बाद पहुंचता है। |
हम हर फ़ील्ड क्यों मांगते हैं
Access token
चेकआउट लिंक बनाने को अधिकृत करता है, ताकि चार्ज आपके खाते के ज़रिए चले।
Webhook signature key
साबित करता है कि कोई आता हुआ वेबहुक सचमुच Square से है, ताकि कोई "paid" इवेंट नकली न बना सके। यह access token से एक अलग मान है।
Location ID
Square को बताता है कि कौन सा location पैसा प्राप्त करता है, और चेकआउट मुद्रा तय करता है। गुप्त नहीं।
Success and Cancel URL
सादी सेटिंग: जहां खरीदार भुगतान करने या पीछे हटने के बाद पहुंचता है। गुप्त नहीं।
सेट करें
- Square Developer डैशबोर्ड खोलें
developer.squareup.com पर साइन इन करें। हर application के अपने credentials होते हैं, और टेस्टिंग के लिए इसके साथ एक मुफ़्त Sandbox बनाई जाती है। यह गाइड Sandbox के साथ चलती है; Live flow बिल्कुल एक जैसा है, बस Sandbox / Production टॉगल पलटें और अपने production credentials उपयोग करें। एक नया app बनाने के लिए, Applications स्क्रीन पर + tile क्लिक करें।
Square Developer → Applications - अपने application को नाम दें
application को एक ऐसा नाम दें जो आपको पहचान में आए (उदाहरण के लिए "Coin Moebius"), फिर Next क्लिक करें।
Square → Name your application - अपना access token कॉपी करें
app खोलें और Credentials पर जाएं। ऊपर का Sandbox / Production टॉगल पुष्टि करें कि वह उस परिवेश से मेल खाता है जो आप सेट कर रहे हैं। Access token के बगल में copy icon क्लिक करें और इसे अलग रख लें।
Square → Credentials access token गुप्त है, इसे पासवर्ड की तरह संभालें। Sandbox और Production के अलग tokens होते हैं, इसलिए इन्हें न मिलाएं।
- अपना Location ID कॉपी करें
बाएं मेनू में, Locations खोलें। उस location का Location ID कॉपी करें जो भुगतान प्राप्त करना चाहिए। यह checkout currency तय करता है, इसलिए वह location चुनें जिसकी currency में आप charge करना चाहते हैं।
Square → Locations - Webhooks → Subscriptions खोलें
Square एक webhook endpoint को "subscription" कहता है। बाएं मेनू में, Webhooks expand करें, Subscriptions खोलें, और Add subscription क्लिक करें।
Square → Webhooks → Subscriptions → Add subscription - subscription जोड़ें और events चुनें
इसे एक नाम दें (जैसे "coin-moebius")। Notification URL में, अपने प्रोजेक्ट का Square webhook पता (नीचे) पेस्ट करें। फिर, Events के नीचे, वे events search करें और चेक करें जो Coin Moebius सुनता है, और Save क्लिक करें।
- एक बार के भुगतान: payment.created, payment.updated, refund.created, refund.updated, dispute.created, dispute.state.updated।
- Subscriptions (केवल तभी जब आप उन्हें बेचते हैं): subscription.created, subscription.updated, subscription.canceled, subscription.deactivated, invoice.payment_made, invoice.scheduled_charge_failed। अगर आप recurring basis पर billing नहीं कर रहे, तो इन्हें छोड़ दें।
https://api.coinmoebius.com/webhook/square/<your project id>Square → Add a webhook subscription आपकी project ID Coin Moebius डैशबोर्ड में project name के नीचे है; इसे ऊपर के पते में डालें। अतिरिक्त events हानिरहित हैं, हम जो उपयोग नहीं करते उसे अनदेखा करते हैं। कनेक्टेड provider card (अंतिम चरण) संदर्भ के लिए वही URL दिखाता है।
- अभी-बनाई subscription खोलें
Square subscription सहेजता है और इसे Webhooks के नीचे Enabled स्थिति के साथ सूचीबद्ध करता है। इसका नाम क्लिक करें तो विवरण panel खुलती है जहां signing key रहती है।
Square → Webhooks → your subscription (Enabled) - Signature key कॉपी करें
subscription की Properties panel में, Signature key के बगल में copy icon क्लिक करें। यह वह मान है जो Coin Moebius हर webhook की पुष्टि के लिए उपयोग करता है कि वह सचमुच Square से आया। यह केवल subscription बनने के बाद मौजूद होता है, यही कारण है कि webhook, connect चरण से पहले आया।
Square → your 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 credentials के साथ सेट करना चाहते हैं? उन्हें बजाय Test टैब पर पेस्ट करें, फिर बाद में Edit से live credentials जोड़ें।
Coin Moebius → Add provider → Square - आप कनेक्ट हो गए
Square अब आपके Providers टैब पर कनेक्ट होने की तारीख के साथ दिखाई देता है। Card वही webhook URL दिखाता है जो आपने Square में पेस्ट किया, साथ ही Edit और Disconnect। Live होने से पहले एक sandbox order को शुरू से अंत तक चलाने के लिए Test mode टॉगल का उपयोग करें।
Coin Moebius → Providers → Square (connected) Sandbox cards कभी किसी असली card को charge नहीं करते। card 4111 1111 1111 1111, CVV 111, कोई भी भविष्य की समाप्ति, कोई भी वैध डाक कोड (उदाहरण के लिए 94103) उपयोग करें।
कनेक्ट करने के बाद
लाइव होने से पहले एक टेस्ट भुगतान चलाएं:
- एक उत्पाद बनाएं और इसकी Environment को Testing पर सेट करें। यह उत्पाद को आपके sandbox क्रेडेंशियल पर चलाता है, ताकि आप बिना पैसा हिलाए एक पूरा ऑर्डर दे सकें। (अगर आपने sandbox सेट छोड़ दिया, तो एक Testing उत्पाद live पर वापस आ जाता है, इसलिए पहले इसे जोड़ें।)
- अपने प्रोजेक्ट पर इंगित किसी पेज पर बाय बटन रखें (एक स्थानीय HTML फ़ाइल काम करती है)।
- ऊपर दिए sandbox टेस्ट कार्ड से चेकआउट पूरा करें।
- Transactions टैब खोलें। एक नई पंक्ति दिखती है, Testing टैग के साथ। जब इसकी स्थिति succeeded तक पहुंचती है, तो आपके क्रेडेंशियल और वेबहुक दोनों शुरू से अंत तक काम कर रहे हैं।
जब आप असली भुगतान के लिए तैयार हों तो उत्पाद की Environment को Live पर बदलें।
समस्या निवारण
Verify से शुरू करें। डैशबोर्ड में, अपने access token और location को जांचने के लिए Verify (या Verify test credentials) क्लिक करें।
Verify विफल हो जाता है।
access token और Location ID फिर से कॉपी करें। Production और Sandbox की अलग टोकन होती हैं, इसलिए उन्हें न मिलाएं।
सिग्नेचर सत्यापन विफल हो जाता है, या ऑर्डर pending रहता है।
Square ठीक उस notification URL और बॉडी पर साइन करता है। जो URL आप Square में पंजीकृत करते हैं वह आपके वेबहुक URL से अक्षर-दर-अक्षर मेल खाना चाहिए, बिना किसी अंतिम स्लैश और बिना किसी अतिरिक्त query string के। फिर उसी endpoint से signature key फिर से कॉपी करें।
इसे शुरू से अंत तक पुष्ट करें।
Square Developer Console → Webhooks → your subscription → Send Test Event, फिर ऑर्डर अपडेट होते देखें।
जानना अच्छा है
मुद्रा location का अनुसरण करती है. चेकआउट उस location की मुद्रा में चार्ज करता है जिसकी id आप देते हैं।
secret घुमाना. access token या signature key को कभी भी घुमाएं, फिर नया मान पेस्ट करें। संपादन पर गुप्त फ़ील्ड खाली रहते हैं।
सवाल? Join our Discord