पेमेंट्स (Stripe)
अपने खुद के Stripe अकाउंट (BYO मॉडल) का उपयोग करके कोटेशन्स पर पेमेंट लिंक्स जनरेट करें।
Payments इंटीग्रेशन आपके Stripe अकाउंट का उपयोग करता है (BYO मॉडल: आप अपना खुद का अकाउंट लाते हैं)। पेमेंट्स सीधे आपके Stripe अकाउंट में जाते हैं: हमारी तरफ से कोई लागत, मार्जिन या बिचौलियापन नहीं है। हम सिर्फ फील्ड्स और लिंक जनरेट करने वाला बटन जोड़ते हैं।
इंटीग्रेशन निष्क्रिय (inert) शुरू होता है: जब तक आप अपनी key पेस्ट करके सक्रिय नहीं करते, तब तक कुछ नहीं होता। keys CRM में एन्क्रिप्टेड स्टोर की जाती हैं और कभी वापस नहीं दिखाई जातीं।
पूर्वापेक्षाएं
- एक एक्टिव Stripe अकाउंट (असल में चार्ज करने के लिए, अकाउंट का आपके देश में पेमेंट्स के लिए सक्षम होना ज़रूरी है)।
- API keys देखने (Developers → API keys) और webhooks बनाने (Developers → Webhooks) की अनुमति के साथ Stripe Dashboard तक एक्सेस।
- Sellio में, Settings → Integrations में keys सेव करने और इंटीग्रेशन सक्रिय करने के लिए एडमिनिस्ट्रेटर एक्सेस।
आपको क्या पेस्ट करना है
- Secret key: Stripe Dashboard में, Developers → API keys के तहत (production में sk_live_ से शुरू होती है या test में sk_test_ से)।
- Webhook signing secret (शुरुआत में वैकल्पिक): यह तब जनरेट होता है जब आप Stripe में webhook बनाते हैं (whsec_ से शुरू होता है)। यही पेमेंट्स को ऑटोमैटिकली कन्फर्म होने देता है।
कैसे कॉन्फ़िगर करें
- Settings → Integrations खोलें और "भुगतान (Stripe)" कार्ड ढूंढें।
- अपनी Stripe secret key पेस्ट करें और "कुंजियाँ सहेजें" पर क्लिक करें।
- दिखाई देने वाला "Stripe वेबहुक URL" कॉपी करें और, Stripe Dashboard (Developers → Webhooks) में, उस URL के लिए events checkout.session.completed और payment_intent.succeeded के साथ एक endpoint बनाएं।
- CRM पर वापस जाएं, webhook signing secret (whsec_...) को secret key के साथ पेस्ट करें और फिर से सेव करें।
- "Activate" पर क्लिक करें।
पेमेंट लिंक कैसे जनरेट करें
- एक अवसर (opportunity) खोलें और Quotes सेक्शन में जाएं।
- मनचाहे वर्जन पर, "भुगतान लिंक" पर क्लिक करें: CRM कोटेशन की कुल राशि के साथ Stripe में एक लिंक बनाता है और उसे आपके क्लिपबोर्ड पर कॉपी करता है।
- लिंक ग्राहक को भेजें। जब वे भुगतान करते हैं, Stripe webhook के ज़रिए CRM को सूचित करता है और पेमेंट कोटेशन पर "Paid" के रूप में दिखाई देता है।
💡 अगर आप Stripe कॉन्फ़िगर किए बिना लिंक जनरेट करने की कोशिश करते हैं, तो CRM आपको साफ़ चेतावनी देता है और कुछ भी चार्ज नहीं होता। जब तक key मौजूद न हो, फीचर निष्क्रिय रहता है। जब किसी कोटेशन से जुड़ा पेमेंट कन्फर्म होता है, तो कोटेशन अपने-आप स्वीकृत (accepted) के रूप में चिह्नित हो जाता है।
webhook URL को गुप्त मानें और बदलते समय हमेशा दोनों keys एक साथ पेस्ट करें (सुरक्षा के लिए, CRM सेव की गई keys वापस नहीं दिखाता)।
कैसे टेस्ट करें
- असल में चार्ज न करने के लिए TEST keys का उपयोग करें (test mode की sk_test_.../whsec_)।
- किसी कोटेशन पर "भुगतान लिंक" जनरेट करें और उसे खोलें: आपको कोटेशन की कुल राशि के साथ Stripe checkout पर पहुंचना चाहिए।
- किसी Stripe test कार्ड से भुगतान करें (जैसे, 4242 4242 4242 4242)। पुष्टि करें कि कोटेशन "Paid" बन जाता है और स्वीकृत के रूप में चिह्नित होता है, यह संकेत है कि webhook पहुंच गया और सिग्नेचर सही निकला।
- Stripe Dashboard (Developers → Webhooks → आपका endpoint) में, डिलीवर हुए events का इतिहास और 200 स्टेटस देखें।
समस्या निवारण
- लिंक जनरेट करते समय एरर / Stripe पर 401: secret key गलत है या किसी दूसरे mode की है (आपने test वाली पेस्ट की पर production में हैं, या इसके उल्टा)। सही sk_ दोबारा पेस्ट करें।
- ग्राहक भुगतान कर देता है पर कोटेशन "Paid" नहीं बनता: webhook कन्फर्म नहीं कर रहा। जांचें कि आपने Stripe में "Stripe वेबहुक URL" पर पॉइंट करने वाला endpoint events checkout.session.completed और payment_intent.succeeded के साथ बनाया है।
- webhook पर invalid signature: CRM में webhook signing secret (whsec_...) Stripe में endpoint के secret से मेल नहीं खाता। endpoint का secret कॉपी करें और secret key के साथ TOGETHER पेस्ट करें (दोनों को एक साथ सेव करें)।
- webhook URL पर 404: इंटीग्रेशन सक्रिय नहीं है या URL टोकन बदल गया है। दोबारा सक्रिय करें और URL को Stripe में फिर से कॉपी करें।
- लिंक जनरेट करते समय कुछ नहीं होता: key न होने के कारण इंटीग्रेशन निष्क्रिय है। पहले secret key पेस्ट करें और सक्रिय करें।