VibeFox Yoco for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 6.2 या उसके बाद का संस्करण।

WooCommerce: 8.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। WooCommerce के बिना प्लगइन सक्रिय नहीं होता।

PHP: 8.0 या उसके बाद का संस्करण।

स्टोर की मुद्रा: दक्षिण अफ़्रीकी रैंड (ZAR)। Yoco केवल ZAR स्वीकार करता है। किसी दूसरी मुद्रा में चेकआउट पर यह भुगतान विधि नहीं दिखती। ऑर्डर की कुल राशि कम से कम R2.00 होनी चाहिए।

Yoco खाता: ऑनलाइन भुगतान वाला एक Yoco खाता। आपको उसकी सीक्रेट कुंजियों की ज़रूरत है, जो Yoco Business Portal में Selling Online > Payment Gateway के तहत मिलती हैं। केवल सीक्रेट कुंजियाँ दर्ज की जाती हैं। वेबहुक प्लगइन रजिस्टर करता है, और उसकी साइनिंग सीक्रेट आपके लिए भर दी जाती है।

सार्वजनिक साइट: Yoco आपकी साइट पर वेबहुक भेजता है, इसलिए साइट इंटरनेट से पहुँचने योग्य होनी चाहिए। वेबहुक URL को बिना रीडायरेक्ट के POST स्वीकार करना होगा।

VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक ही डोमेन पर काम करती है।

इंस्टॉलेशन

1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से wcp_yoco_pay फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।

2. Activate पर क्लिक करें।

3. सेटिंग्स खोलें: WooCommerce > Settings > Payments > Yoco > Manage।

4. पेज के ऊपर वाले लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।

5. टेस्ट सीक्रेट कुंजी (sk_test_...) चिपकाएँ और तैयार होने पर लाइव सीक्रेट कुंजी (sk_live_...)। सेटिंग्स सेव करें। जिस मोड में कुंजी है, उसके लिए वेबहुक रजिस्टर होता है।

6. Enable/Disable चालू करें। जब Test mode चालू हो, तब Yoco टेस्ट कार्ड से एक टेस्ट भुगतान करें, फिर असली भुगतान लेने के लिए Test mode का निशान हटा दें।

कॉन्फ़िगरेशन

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Yoco। जब स्टोर की मुद्रा ZAR न हो (तब चेकआउट पर Yoco नहीं दिया जाता) या वर्तमान मोड में सीक्रेट कुंजी न हो, तो फ़ील्ड्स के ऊपर पेज चेतावनी दिखाता है। भुगतान विधियों की सूची में, जब तक वर्तमान मोड में सीक्रेट कुंजी न हो, Yoco को सेटअप की ज़रूरत वाले के रूप में चिह्नित किया जाता है। सेव करने पर प्लगइन कुंजियों और वेबहुक सीक्रेट की जाँच करता है और वेबहुक रजिस्टर करता है। इससे जुड़े संदेश पेज के ऊपर दिखते हैं।

सामान्य

Enable/Disable: Enable Yoco भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: off।

Title: वह नाम जो ग्राहक चेकआउट पर भुगतान विधि के रूप में देखते हैं। डिफ़ॉल्ट: Card or Instant EFT (Yoco)।

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला टेक्स्ट। डिफ़ॉल्ट: You will be redirected to the secure Yoco page to pay by card or Instant EFT.

API कुंजियाँ

सीक्रेट कुंजियाँ Yoco Business Portal में Selling Online > Payment Gateway से कॉपी करें। Yoco के पास दोनों मोड के लिए एक ही API है: कुंजी तय करती है कि भुगतान टेस्ट है या असली। टेस्ट मोड केवल टेस्ट कुंजी का उपयोग करता है, लाइव मोड केवल लाइव कुंजी का।

Test mode: Use the test secret key (no real payments)। कोई असली पैसा नहीं कटता; Yoco टेस्ट कार्ड से भुगतान करें। डिफ़ॉल्ट: on। असली भुगतान लेने के लिए इसका निशान हटाएँ।

Test secret key: टेस्ट मोड की सीक्रेट कुंजी। यह sk_test_ से शुरू होती है।

Live secret key: लाइव मोड की सीक्रेट कुंजी। यह sk_live_ से शुरू होती है।

जो कुंजी अपेक्षित प्रीफ़िक्स से शुरू नहीं होती, वह सेव नहीं होती: पेज एक त्रुटि दिखाता है और पिछला मान रखता है। वेबहुक रजिस्ट्रेशन के दौरान अगर Yoco बताए कि कोई कुंजी दूसरे मोड की है, तो पेज आपको यह बताता है।

वेबहुक

Yoco भुगतान और रिफ़ंड की सूचना इस सेक्शन में दिखाए गए वेबहुक URL पर देता है। यह कुछ ऐसा दिखता है: https://your-site/wc-api/yoco_pay_webhook/। आपको Yoco पोर्टल में वेबहुक बनाने की ज़रूरत नहीं है। सेटिंग्स सेव करने पर प्लगइन, हर उस मोड के लिए जिसमें सीक्रेट कुंजी है पर वेबहुक सीक्रेट नहीं है, URL Yoco में रजिस्टर करता है और साइनिंग सीक्रेट उस मोड के फ़ील्ड में सेव करता है। जब उस मोड की सीक्रेट कुंजी या वेबहुक URL बदलता है, तो वह URL फिर से रजिस्टर होता है। URL बदलने पर पुराना रजिस्ट्रेशन हटा दिया जाता है।

हर मोड के लिए यह सेक्शन वेबहुक की स्थिति दिखाता है:

प्लगइन ये इवेंट संभालता है:

जिन वेबहुक पर वैध हस्ताक्षर नहीं है, वे अस्वीकार होते हैं। अगर आपकी साइट के URL में भाषा प्रीफ़िक्स है, तो URL को ठीक वैसा ही रखें जैसा सेटिंग्स दिखाती हैं, क्योंकि वेबहुक को बिना रीडायरेक्ट के आपके स्टोर तक पहुँचना चाहिए।

Test webhook secret: वेबहुक रजिस्टर होने पर अपने-आप भर जाता है। सीक्रेट (whsec_...) केवल तभी चिपकाएँ जब आपने वेबहुक URL खुद रजिस्टर किया हो।

Live webhook secret: वेबहुक रजिस्टर होने पर अपने-आप भर जाता है। फ़ील्ड खाली करें और वेबहुक फिर से रजिस्टर करने के लिए सेव करें।

वेबहुक सीक्रेट whsec_ जैसा होना चाहिए, जिसके बाद base64 टेक्स्ट हो। कोई और मान सेव नहीं होता, और पिछला मान रहता है।

उन्नत

Debug log: Log Yoco requests and webhooks अनुरोध और वेबहुक को WooCommerce > Status > Logs में लिखता है, स्रोत wcp_yoco_pay। त्रुटियाँ और चेतावनियाँ, जैसे Yoco के लिए विफल अनुरोध और अस्वीकृत वेबहुक, हमेशा लॉग होती हैं। कुंजियाँ, वेबहुक सीक्रेट और ईमेल पते मास्क होते हैं। डिफ़ॉल्ट: off।

Delete data: Delete the settings and logs of this plugin when it is deleted। डीएक्टिवेशन कभी कुछ नहीं मिटाता। ऑर्डर का डेटा (Yoco चेकआउट और भुगतान ID) हमेशा रखा जाता है, क्योंकि रिफ़ंड के लिए उसकी ज़रूरत होती है। डिफ़ॉल्ट: off।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Card or Instant EFT (Yoco)) और ऑर्डर देता है। टेस्ट मोड में चेकआउट पर Test mode — use a Yoco test card; no real money is charged. दिखता है। प्लगइन ऑर्डर की राशि के लिए सेंट में एक Yoco चेकआउट बनाता है और ग्राहक को Yoco के भुगतान पेज पर भेजता है, जहाँ वह कार्ड या Instant EFT से भुगतान करता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Yoco उसकी पुष्टि करे: ग्राहक के लौटने पर और हस्ताक्षरित वेबहुक आने पर प्लगइन Yoco से चेकआउट पूछता है। अगर Yoco ने अभी भुगतान की पुष्टि नहीं की है, तो ऑर्डर प्राप्ति पेज पर We are waiting for Yoco to confirm your payment. The order will be updated automatically — please do not pay again. दिखता है।

अगर ग्राहक Yoco पेज पर रद्द कर देता है, तो ऑर्डर बिना भुगतान के रहता है और ग्राहक Pay for order पेज पर पहुँचता है, जहाँ संदेश होता है The Yoco payment was cancelled. Your order is saved — you can pay again below or choose another payment method. अगर भुगतान विफल होता है, तो संदेश है The Yoco payment was not successful. Please try again or choose another payment method. और ऑर्डर में एक नोट जुड़ता है।

ग्राहक Pay for order पेज से बिना भुगतान वाले ऑर्डर का दोबारा भुगतान कर सकता है। नए प्रयास से पहले प्लगइन पिछले प्रयास को Yoco से जाँचता है। अगर वह पहले ही भुगतान हो चुका है, तो ऑर्डर बिना नया भुगतान पेज दिखाए पूरा हो जाता है। अगर वह उसी राशि के लिए अब भी खुला है और 30 मिनट से कम पहले बना था, तो ग्राहक को फिर वही Yoco पेज मिलता है।

अगर Yoco भुगतान शुरू नहीं कर पाता, तो ग्राहक को Yoco could not start the payment. Please try again in a moment or choose another payment method. दिखता है, और कारण ऑर्डर नोट्स में जुड़ता है। R2.00 से कम के ऑर्डर पर Yoco requires an order total of at least R2.00. दिखता है।

यह भुगतान विधि क्लासिक चेकआउट, Checkout ब्लॉक और Pay for order पेज पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।

भुगतान Yoco पेज पर तुरंत लिए जाते हैं। प्लगइन में सेव किए गए कार्ड, सब्सक्रिप्शन या आवर्ती भुगतान नहीं हैं, साइट पर कार्ड फ़ॉर्म नहीं है, और अलग से ऑथराइज़ेशन और कैप्चर नहीं है, और यह ZAR के अलावा किसी मुद्रा में काम नहीं करता।

ऑर्डर और रिफ़ंड

ऑर्डर स्टेटस

Pending payment: ग्राहक को Yoco पर भेजा गया है और उसने अभी भुगतान नहीं किया, Yoco पेज पर रद्द किया, या Yoco ने अभी भुगतान की पुष्टि नहीं की है।

Processing or Completed: भुगतान की पुष्टि हो गई है। WooCommerce स्टेटस को प्रोसेसिंग पर सेट करता है, या केवल डाउनलोड होने वाले वर्चुअल उत्पादों वाले ऑर्डर के लिए पूर्ण पर। ऑर्डर नोट में राशि, Yoco भुगतान और चेकआउट ID, मोड, और भुगतान कैसे पक्का हुआ (ग्राहक की वापसी, वेबहुक, या नए भुगतान प्रयास से पहले की जाँच) दिखते हैं। ट्रांज़ैक्शन ID, Yoco भुगतान ID है।

On hold: Yoco ने ऑर्डर की कुल राशि से अलग राशि या मुद्रा बताई, उदाहरण के लिए भुगतान शुरू होने के बाद ऑर्डर संपादित होने के कारण। नोट इसे समझाता है, और Yoco से लौटने वाले ग्राहक को We received your payment and are reviewing it. We will contact you if anything else is needed. दिखता है। शिपिंग से पहले भुगतान की जाँच करें।

Cancelled or Refunded: ऐसे ऑर्डर के लिए आने वाला भुगतान ऑर्डर को नहीं बदलता। एक नोट आपसे कहता है कि Yoco पोर्टल में भुगतान रिफ़ंड करें या ऑर्डर मैन्युअली बहाल करें। Yoco से लौटने वाले ग्राहक को Your payment was received after the order had been cancelled. Please contact us — do not pay again. दिखता है।

जिस ऑर्डर का भुगतान पहले ही हो चुका है, उसके लिए दूसरा भुगतान आए, तो ऑर्डर फिर से नहीं बदलता। एक नोट आपसे कहता है कि उसे Yoco पोर्टल में रिफ़ंड करें।

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और अपने भुगतान विधि के नाम वाले Refund via बटन पर क्लिक करें (डिफ़ॉल्ट रूप से Card or Instant EFT (Yoco))। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड उसी मोड में भेजा जाता है जिसमें भुगतान हुआ था (टेस्ट या लाइव), इसलिए उस मोड की सीक्रेट कुंजी सेट होनी चाहिए। किसी खोए हुए उत्तर के बाद दोहराया गया रिफ़ंड दो बार नहीं भेजा जाता।

सफल रिफ़ंड Yoco रिफ़ंड ID के साथ ऑर्डर नोट्स में जुड़ता है। अगर Yoco रिफ़ंड अस्वीकार करता है, तो WooCommerce कारण के साथ Yoco refused the refund: दिखाता है, और कोई रिफ़ंड दर्ज नहीं होता। अगर Yoco रिफ़ंड को लंबित बताता है, तो WooCommerce दिखाता है कि वह अभी लंबित है और कुछ दर्ज नहीं करता। इसे दोबारा न करें: Yoco द्वारा वेबहुक से पुष्टि होने पर यह ऑर्डर में जुड़ जाएगा।

Yoco पोर्टल में किए गए रिफ़ंड refund.succeeded वेबहुक से आते हैं और बिना सामान को स्टॉक में वापस जोड़े, अपने-आप WooCommerce रिफ़ंड के रूप में दर्ज होते हैं। बचे हुए रिफ़ंड योग्य राशि से बड़ा रिफ़ंड दर्ज नहीं होता, और एक नोट आपसे ऑर्डर की जाँच करने को कहता है। विफल रिफ़ंड एक नोट जोड़ता है कि पैसा ग्राहक को वापस नहीं किया गया।

लाइसेंस कुंजी

प्लगइन vibefox.net की एक VibeFox लाइसेंस कुंजी से काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > Yoco के ऊपर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस साइट से कुंजी हटाने के लिए Remove key का उपयोग करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।

एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से डोमेन स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।

सक्रिय कुंजी के बिना Yoco ग्राहकों को चेकआउट पर नहीं दिखाया जाता। फिर भी अगर भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। लॉग इन किए स्टोर मैनेजर को भुगतान विधि अब भी दिखती है, जिस पर (unlicensed — visible to admins only) लिखा होता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट अप और टेस्ट कर सकें। प्लगइन्स पेज और WooCommerce पेजों पर एक याद दिलाने वाला संदेश दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान शुरू हो चुके हैं वे अब भी पक्के होते हैं, और रिफ़ंड काम करते हैं।

लाइसेंस की समय-सीमा खत्म होने पर प्लगइन काम करता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण चाहिए। स्थिति बैकग्राउंड में अपने-आप दोबारा जाँची जाती है।

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

Yoco चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और वर्तमान मोड में सीक्रेट कुंजी है: टेस्ट मोड में Test secret key, लाइव मोड में Live secret key। स्टोर या ऑर्डर की मुद्रा ZAR होनी चाहिए, और ऑर्डर की कुल राशि कम से कम R2.00। जब कुंजी न हो या मुद्रा ZAR न हो, तो सेटिंग्स पेज चेतावनी दिखाता है।

भुगतान हो गया, पर ऑर्डर Pending payment पर रहता है: वेबहुक काम नहीं कर रहा है। सेटिंग्स का Webhooks सेक्शन खोलें और जिस मोड का उपयोग कर रहे हैं, उसकी स्थिति जाँचें। अगर वह रजिस्टर नहीं है, या किसी दूसरे URL के लिए रजिस्टर है, तो सेटिंग्स सेव करें। अगर रजिस्ट्रेशन विफल होता है, तो पेज कारण दिखाता है। अगर आपने सीक्रेट खुद दर्ज किया है, तो जाँचें कि वह इस URL और मोड के वेबहुक का है। ग्राहक के भुगतान के बाद स्टोर पर लौटने पर और दोबारा भुगतान की कोशिश करने पर भी ऑर्डर की पुष्टि होती है।

वेबहुक रजिस्टर नहीं हो सका: ग्राहकों के स्टोर पर लौटने पर भुगतान फिर भी पक्के होते हैं। संदेश में दिखाए गए कारण को ठीक करें, उदाहरण के लिए साइट HTTPS पर इंटरनेट से पहुँचने योग्य होनी चाहिए, और फिर सेव करें। आप URL खुद रजिस्टर करके साइनिंग सीक्रेट भी चिपका सकते हैं।

वेबहुक अस्वीकार हो रहे हैं: अस्वीकृत वेबहुक लॉग में लिखे जाते हैं, स्रोत wcp_yoco_pay। webhook secret not configured का अर्थ है कि कोई भी वेबहुक सीक्रेट सेट नहीं है। invalid signature का अर्थ है कि सीक्रेट किसी दूसरे रजिस्ट्रेशन या मोड का है। timestamp outside the tolerance का अर्थ है कि सर्वर की घड़ी गलत है: हस्ताक्षर सर्वर समय के 5 मिनट के भीतर ही स्वीकार होते हैं। checkout not completed yet — retry और could not confirm the checkout with Yoco — retry अस्थायी हैं; Yoco वेबहुक दोबारा भेजता है।

The secret key must start with sk_test_ / sk_live_ error on save: कुंजी गलत फ़ील्ड में चिपकाई गई थी। टेस्ट कुंजी sk_test_ से और लाइव कुंजी sk_live_ से शुरू होती है। पिछला मान रखा गया।

ग्राहक ऑर्डर देते समय त्रुटि देखता है: ऑर्डर नोट्स या WooCommerce > Status > Logs पढ़ें, स्रोत wcp_yoco_pay। Yoco is not available at the moment. Please choose another payment method. का अर्थ है कि वर्तमान मोड में सीक्रेट कुंजी नहीं है।

ग्राहक को बताया जाता है कि भुगतान की समीक्षा होनी है: पिछला प्रयास अलग राशि में चुकाया गया था, या ऑर्डर रद्द होने के बाद। ऑर्डर नोट पढ़ें और ऑर्डर पूरा करें, या Yoco पोर्टल में भुगतान रिफ़ंड करें।

मोड से जुड़े संदेश के साथ रिफ़ंड विफल होता है: भुगतान टेस्ट या लाइव मोड में हुआ था, और उस मोड की सीक्रेट कुंजी सेट नहीं है। उसे दर्ज करें और दोबारा कोशिश करें।

No answer from Yoco के साथ रिफ़ंड विफल होता है: WooCommerce में कुछ भी दर्ज नहीं हुआ। अगर Yoco ने रिफ़ंड प्रोसेस कर दिया था, तो वही रिफ़ंड दोहराएँ: वह दो बार रिफ़ंड नहीं होगा।

लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक का संदेश देखें। उदाहरण के लिए, अगर कुंजी किसी दूसरे डोमेन पर पहले से इस्तेमाल हो रही है, तो अपने vibefox.net खाते में स्लॉट खाली करें और Check now पर क्लिक करें। अगर साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने के लिए Check now पर क्लिक करें। अगर लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो प्लगइन आखिरी ज्ञात स्थिति पर काम करता रहता है।

अनइंस्टॉल

प्लगइन को डीएक्टिवेट करने पर सारा डेटा बना रहता है। हटाने के लिए उसे डीएक्टिवेट करें और Plugins पेज पर डिलीट करें। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती है। गेटवे सेटिंग्स, Yoco पर वेबहुक रजिस्ट्रेशन, और घुमाई गई लॉग फ़ाइलों सहित लॉग केवल तभी हटाए जाते हैं जब Delete data चालू था। नहीं तो वे बाद में दोबारा इंस्टॉल करने के लिए बने रहते हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स और ट्रांज़ैक्शन ID रखते हैं।

Yoco उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन Yoco से संबद्ध नहीं है और उसके द्वारा अनुमोदित नहीं है।