VibeFox Yoco for OpenCart — सहायता

आवश्यकताएँ

OpenCart: 3.0.x (3.0.5.0 पर परीक्षित) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षित)।

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

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

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

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

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

इंस्टॉलेशन

डाउनलोड एक zip फ़ाइल है जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_yoco_pay-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_yoco_pay.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।

OpenCart 3

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_yoco_pay-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD संशोधन नहीं है, इसलिए Extensions > Modifications को रिफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर के बजाय आप इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।

2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Yoco Pay Gateway खोजें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता के पास भुगतान एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।

3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। पेज के शीर्ष पर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी License key में दर्ज करें और Activate पर क्लिक करें (देखें License key)।

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

5. Enable/Disable चालू करें और Save पर क्लिक करें। Test mode चालू रहते हुए Yoco टेस्ट कार्ड से टेस्ट भुगतान करें, फिर वास्तविक भुगतान लेने के लिए Test mode बंद करें।

OpenCart 4

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_yoco_pay.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।

2. पैकेज इसी पेज पर इंस्टॉल किए गए एक्सटेंशन की सूची में दिखता है। उसके आगे Install (हरा + बटन) पर क्लिक करें।

3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Yoco Pay Gateway ढूँढें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।

4. लाइसेंस कुंजी और Yoco कुंजियाँ OpenCart 3 के चरण 3 से 5 की तरह दर्ज करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल webhook URL अलग है (देखें Webhook); इसे सेव करने पर Yoco में उसी तरह रजिस्टर किया जाता है।

नई इंस्टॉलेशन भुगतान विधि बंद और टेस्ट मोड चालू के साथ शुरू होती है।

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Yoco Pay Gateway > Edit. अनुभाग बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। एक्सटेंशन बदलने का अधिकार न हो तो पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

सेटिंग्स के ऊपर पेज सक्रिय मोड दिखाता है (Test mode: the test secret key is used, no real money is charged. या Live mode: real payments are accepted.)। यदि स्टोर की डिफ़ॉल्ट मुद्रा ZAR नहीं है, तो यह चेतावनी देता है (तब Yoco केवल तभी दिया जाता है जब ग्राहक ZAR में भुगतान करे, या कोई ZAR मुद्रा सक्षम न हो तो बिल्कुल नहीं दिया जाता), और यदि वर्तमान मोड में सीक्रेट कुंजी नहीं है, तो भी चेतावनी देता है, जैसे Enter the test secret key to offer Yoco at checkout (test mode).

सेव करते समय Title अधिकतम 128 अक्षर का हो सकता है, Sort Order पूर्ण संख्या होनी चाहिए (ऋणात्मक संख्याएँ मान्य हैं), Total 0 या उससे अधिक की संख्या होनी चाहिए, और जियो ज़ोन तथा ऑर्डर स्थितियाँ मौजूद होनी चाहिए। अन्यथा कुछ भी सेव नहीं होता और पेज वह फ़ील्ड बताता है। फिर एक्सटेंशन कुंजियों और वेबहुक सीक्रेट की जाँच करता है और वेबहुक रजिस्टर करता है। इस बारे में संदेश सेटिंग्स के ऊपर दिखाई देते हैं।

Yoco

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

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

Description: Confirm Order चरण पर पुष्टि बटन के ऊपर ग्राहक को दिखाया गया पाठ। डिफ़ॉल्ट: You will be redirected to the secure Yoco page to pay by card or Instant EFT.

Sort Order: चेकआउट पर भुगतान विधियों में Yoco की स्थिति। खाली छोड़ें या पूर्ण संख्या दर्ज करें।

Geo Zone: Yoco केवल चुने हुए जियो ज़ोन के भुगतान पते के लिए दें। डिफ़ॉल्ट: All zones। जियो ज़ोन System > Localisation > Geo Zones में सेट होते हैं।

Total: चेकआउट कुल, स्टोर की डिफ़ॉल्ट मुद्रा में, जिस तक पहुँचने पर ही Yoco दिया जाए। किसी भी कुल के लिए Yoco देने हेतु खाली छोड़ें। Yoco स्वयं हमेशा कम से कम R2.00 माँगता है।

API कुंजियाँ

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

Test mode: टेस्ट सीक्रेट कुंजी का उपयोग करता है। कोई वास्तविक पैसा नहीं लिया जाता; Yoco टेस्ट कार्ड से भुगतान करें। डिफ़ॉल्ट: on। वास्तविक भुगतान लेने के लिए इसे बंद करें। चालू रहने पर ग्राहक Confirm Order चरण पर Test mode — use a Yoco test card; no real money is charged. देखते हैं।

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

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

जो कुंजी अपेक्षित उपसर्ग से शुरू नहीं होती, वह सेव नहीं होती: पेज एक त्रुटि दिखाता है, उदाहरण के लिए Yoco: the test secret key must start with sk_test_ — the previous value was kept. बाकी सेटिंग्स सेव हो जाती हैं। यदि वेबहुक रजिस्ट्रेशन के दौरान Yoco बताता है कि कोई कुंजी दूसरे मोड की है, तो पेज आपको यह बताता है।

सेव की गई कुंजियाँ और सीक्रेट दोबारा कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें। सेव किया गया मान हटाने के लिए फ़ील्ड के नीचे Clear the saved value पर टिक करें और Save पर क्लिक करें।

Webhooks

Yoco भुगतान और रिफ़ंड की सूचना इस अनुभाग में Webhook URL पर दिखाए गए URL पर भेजता है। OpenCart 3 पर यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_yoco_pay/webhook, OpenCart 4 पर https://your-store/index.php?route=extension/wcp_yoco_pay/payment/wcp_yoco_pay.webhook। यह आपकी OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। वेबहुक आपको Yoco पोर्टल में बनाने की ज़रूरत नहीं है। सेटिंग्स सेव करने पर एक्सटेंशन हर उस मोड के लिए, जिसकी सीक्रेट कुंजी है पर वेबहुक सीक्रेट नहीं है, Yoco के साथ URL रजिस्टर करता है, और साइनिंग सीक्रेट उस मोड के फ़ील्ड में सेव करता है। जब उस मोड की सीक्रेट कुंजी बदलती है या वेबहुक URL बदलता है, तो वह URL दोबारा रजिस्टर करता है। URL बदलने पर पुराना रजिस्ट्रेशन हटा दिया जाता है।

हर मोड (Test और Live) के लिए यह अनुभाग वेबहुक की स्थिति दिखाता है:

एक्सटेंशन ये इवेंट संभालता है (ये इस अनुभाग में भी सूचीबद्ध हैं):

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

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

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

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

ऑर्डर

OpenCart ऑर्डर को Confirm Order चरण पर बिना स्थिति के (एक लापता ऑर्डर के रूप में) बनाता है। ऑर्डर को स्थिति तभी मिलती है जब Yoco API के माध्यम से भुगतान की पुष्टि कर दे। नीचे का हर फ़ील्ड आपकी OpenCart ऑर्डर स्थितियाँ सूचीबद्ध करता है।

Paid Order Status: पुष्ट भुगतान के बाद की स्थिति। डिफ़ॉल्ट: Processing।

On Hold Status: ऐसा भुगतान जिसकी राशि या मुद्रा ऑर्डर कुल से मेल नहीं खाती, ऑर्डर को इस स्थिति में डाल देता है और एक नोट जोड़ता है। सही राशि वाला बाद का भुगतान इसे निपटा देता है। डिफ़ॉल्ट: Pending, क्योंकि OpenCart में On hold स्थिति नहीं है। आप System > Localisation > Order Statuses में अपनी स्थिति बना सकते हैं और यहाँ चुन सकते हैं।

Refunded Status: रिफ़ंड जब भुगतान की गई राशि तक पहुँचते हैं, तब सेट होता है। डिफ़ॉल्ट: Refunded।

उन्नत

Debug log: Yoco अनुरोधों और वेबहुक को OpenCart लॉग फ़ोल्डर (storage/logs, OpenCart 4 पर system/storage/logs) में yoco_p_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती, और 5 MB होने पर इसे yoco_p_debug.old.log.php में ले जाया जाता है। त्रुटियाँ और चेतावनियाँ, जैसे Yoco को विफल अनुरोध और अस्वीकृत वेबहुक, हमेशा दर्ज होती हैं। कुंजियाँ, वेबहुक सीक्रेट और ईमेल पते छिपाए जाते हैं। डिफ़ॉल्ट: off।

Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।

Delete data: चालू होने पर एक्सटेंशन अनइंस्टॉल करने से गेटवे सेटिंग्स, लॉग, और एक्सटेंशन द्वारा Yoco पर रजिस्टर किए गए वेबहुक हट जाते हैं। ऑर्डर का डेटा (Yoco चेकआउट और भुगतान ID, रिफ़ंड) हमेशा रहता है, क्योंकि रिफ़ंड के लिए उसकी ज़रूरत होती है। डिफ़ॉल्ट: off।

आयात / निर्यात

Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सेव करता है। सीक्रेट कुंजियाँ और वेबहुक सीक्रेट निर्यात नहीं होते।

Import: पहले निर्यात किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सेव किए गए सीक्रेट बने रहते हैं, और आयात से कोई वेबहुक रजिस्टर नहीं होता।

चेकआउट

जब ग्राहक ZAR में भुगतान करता है और ऑर्डर कुल कम से कम R2.00 होता है, तब भुगतान विधि दिखाई जाती है। ग्राहक इसे Payment Method चरण पर चुनता है (डिफ़ॉल्ट रूप से Card or Instant EFT (Yoco))। Confirm Order चरण पर ग्राहक आपका विवरण देखता है। OpenCart इसी चरण पर ऑर्डर बनाता है, अभी भी बिना स्थिति के। OpenCart 4 पर ग्राहक भुगतान विधि भुगतान विधि के ब्लॉक के Choose बटन से चुनता है, विंडो Payment method options में, और पेज के नीचे Confirm Order पर क्लिक करता है। जब ग्राहक Confirm Order पर क्लिक करता है, तब एक्सटेंशन ऑर्डर कुल के लिए सेंट में एक Yoco चेकआउट बनाता है और ग्राहक को Yoco भुगतान पेज पर भेजता है, जहाँ वह कार्ड या Instant EFT से भुगतान करता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर को भुगतान किया हुआ तभी चिह्नित किया जाता है जब Yoco उसकी पुष्टि करे: एक्सटेंशन ग्राहक के लौटने पर और हस्ताक्षरित वेबहुक आने पर Yoco से चेकआउट माँगता है। फिर ऑर्डर को OpenCart के मानक तरीके से स्थिति मिलती है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक Your payment with Yoco has been received. के साथ OpenCart ऑर्डर सफलता पेज देखता है। यदि ग्राहक के लौटने तक Yoco ने भुगतान की पुष्टि नहीं की है, तो एक Payment confirmation पेज We are waiting for Yoco to confirm your payment. The order will be updated automatically — please do not pay again. दिखाता है, साथ में Check again और Back to checkout बटन होते हैं; वेबहुक आते ही ऑर्डर स्थिति सेट कर देता है। OpenCart 4 पर, जब ग्राहक Yoco पेज से लौटता है, तो एक छोटा मध्यवर्ती पेज आपके स्टोर का वापसी पता फिर से खोलता है, ताकि कार्ट और ग्राहक लॉगिन सुरक्षित रहें।

यदि ग्राहक Yoco पेज पर रद्द करता है, तो वह The Yoco payment was cancelled. Your cart is saved — you can pay again or choose another payment method. के साथ चेकआउट पर लौट आता है। यदि भुगतान विफल होता है, तो संदेश है The Yoco payment was not successful. Please try again or choose another payment method., और ऑर्डर में एक नोट जोड़ा जाता है। कार्ट सुरक्षित रहता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं।

OpenCart 3 हर बार जब Confirm Order चरण दिखाया जाता है, नया ऑर्डर बनाता है। OpenCart 4 चेकआउट के ऑर्डर को अपडेट करता है। नए भुगतान से पहले एक्सटेंशन कार्ट की जाँच करता है: यदि उसी कार्ट का कोई दूसरा ऑर्डर पहले से भुगतान किया हुआ है, तो ग्राहक सीधे सफलता पेज पर जाता है। इस ऑर्डर के और पिछले 24 घंटे के कार्ट के बिना भुगतान वाले Yoco चेकआउट पहले Yoco से जाँचे जाते हैं; यदि उनमें से कोई इस बीच भुगतान हो गया है, तो नया भुगतान बनाने के बजाय वही पुष्ट होता है। यदि उसी ऑर्डर का खुला चेकआउट उसी राशि और मोड का है और 30 मिनट से कम पहले बना है, तो ग्राहक को फिर से वही Yoco पेज मिलता है। अन्यथा नया Yoco चेकआउट बनाया जाता है। कार्ट में बदलाव, जिसमें नई मात्रा भी शामिल है, एक नए कार्ट के रूप में गिना जाता है जिसके लिए अपना भुगतान चाहिए।

OpenCart 4 भुगतान का सफलता पेज दिखाए जाने तक ऑर्डर को चेकआउट में रखता है, इसलिए रद्द या विफल भुगतान के बाद ग्राहक उसी ऑर्डर का दोबारा भुगतान करता है। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए आपने उसे रद्द किया), तो ग्राहक Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. के साथ चेकआउट पर वापस भेजा जाता है, और अगला Confirm Order नया ऑर्डर भुगतान करता है।

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

स्टोर के मेंटेनेंस मोड में होने पर भी वेबहुक काम करता है, क्योंकि OpenCart भुगतान एक्सटेंशन के अनुरोधों को आगे जाने देता है। OpenCart 4 पर एक्सटेंशन की एक startup action webhook और ग्राहक की वापसी को आगे जाने देती है।

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

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

ऑर्डर स्थितियाँ

कोई स्थिति नहीं (लापता ऑर्डर): ग्राहक को Yoco पर भेजा गया और उसने भुगतान नहीं किया, Yoco पेज पर रद्द कर दिया, या Yoco ने अभी तक भुगतान की पुष्टि नहीं की है। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब फ़िल्टर Order Status को Missing Orders पर सेट किया गया हो। OpenCart 4.1 पर ऐसे ऑर्डर की स्थिति Voided भी हो सकती है, जिसे OpenCart तब सेट करता है जब confirm चरण फिर से दिखाया जाता है; एक्सटेंशन इसे बिना स्थिति वाला ऑर्डर मानता है।

Paid Order Status (डिफ़ॉल्ट Processing): भुगतान की पुष्टि हो गई। एक नोट राशि, Yoco भुगतान और चेकआउट ID, मोड, और भुगतान कैसे पुष्ट हुआ (ग्राहक की वापसी, वेबहुक, या नए भुगतान प्रयास से पहले की जाँच) दिखाता है।

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

Refunded Status (डिफ़ॉल्ट Refunded): रिफ़ंड भुगतान की गई राशि तक पहुँच गए।

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

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

नोट्स ऑर्डर के History की वे प्रविष्टियाँ हैं जिन्हें ग्राहक नहीं देखता। वे शब्द Yoco से शुरू होते हैं।

VibeFox Yoco Pay Gateway टैब

Sales > Orders में Yoco से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Yoco Pay Gateway टैब में Checkout ID, Payment ID, Mode (टेस्ट भुगतानों के लिए Test लेबल के साथ), भुगतान की Status, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, Yoco checkouts of this order तालिका, Refunds इतिहास और ऑर्डर के Yoco notes दिखाई देते हैं। यह टैब उन उपयोगकर्ताओं को दिखाया जाता है जिनके पास एक्सटेंशन तक पहुँच है।

रिफ़ंड

VibeFox Yoco Pay Gateway टैब में Amount दर्ज करें (जो राशि अभी तक रिफ़ंड नहीं हुई है, वह भर दी जाती है), वैकल्पिक रूप से Reason (optional), और Refund via Yoco पर क्लिक करें। Refund this amount through Yoco? This cannot be undone. प्रश्न की पुष्टि करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। आपके पास एक्सटेंशन बदलने का अधिकार होना चाहिए (System > Users > User Groups में सेट)। रिफ़ंड Yoco द्वारा चार्ज की गई राशि से बनते हैं, इसलिए ऑर्डर बाद में संपादित होने पर भी आप केवल वही रिफ़ंड कर सकते हैं जो ग्राहक ने वास्तव में चुकाया था। रिफ़ंड उसी मोड (टेस्ट या लाइव) में भेजा जाता है जिसमें भुगतान हुआ था, इसलिए उस मोड की सीक्रेट कुंजी सेट होनी चाहिए। खोए हुए उत्तर के बाद दोहराया गया रिफ़ंड दो बार नहीं दिया जाता।

सफल रिफ़ंड Yoco रिफ़ंड ID के साथ रिफ़ंड इतिहास और नोट्स में जोड़ा जाता है। जब रिफ़ंड भुगतान की गई राशि तक पहुँचते हैं, तो ऑर्डर ग्राहक को सूचित किए बिना और उत्पादों को स्टॉक में वापस किए बिना Refunded Status पाता है; आंशिक रिफ़ंड स्थिति नहीं बदलता। यदि Yoco रिफ़ंड से इनकार करता है, तो टैब कारण के साथ Yoco refused the refund: दिखाता है, और कोई रिफ़ंड दर्ज नहीं होता। यदि Yoco रिफ़ंड को लंबित बताता है, तो टैब यह बताता है। उसे दोबारा न करें: जब Yoco उसकी वेबहुक से पुष्टि करेगा, तब वह दर्ज हो जाएगा। रिफ़ंड उन ऑर्डरों के लिए उपलब्ध हैं जो Yoco चेकआउट से भुगतान किए गए हैं। On Hold Status वाले ऑर्डर में रिफ़ंड करने योग्य पुष्ट भुगतान नहीं होता; उसे Yoco पोर्टल में रिफ़ंड करें।

Sales > Returns में उत्पाद वापसी Yoco के माध्यम से पैसा वापस नहीं भेजती।

Yoco पोर्टल में किए गए रिफ़ंड refund.succeeded वेबहुक के द्वारा आते हैं और रिफ़ंड इतिहास और नोट्स में दर्ज होते हैं। जब वे भुगतान की गई राशि तक पहुँचते हैं, तो ऑर्डर को Refunded Status मिलता है। शेष रिफ़ंड योग्य राशि से बड़ा रिफ़ंड दर्ज नहीं होता, और एक नोट आपसे ऑर्डर जाँचने के लिए कहता है। विफल रिफ़ंड एक नोट जोड़ता है कि पैसा ग्राहक को वापस नहीं किया गया।

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

यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Yoco Pay Gateway Extensions > Extensions > Payments > VibeFox Yoco Pay Gateway > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक में मास्क की हुई कुंजी, स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन) और ये बटन दिखते हैं: Check now स्थिति दोबारा जाँचने के लिए, Change key दूसरी कुंजी दर्ज करने के लिए, और Remove key इस स्टोर से कुंजी हटाने के लिए। उनके नीचे Product: opencart-payment-yoco की पंक्ति और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। केवल एक्सटेंशन के लिए Modify अनुमति वाले एडमिन उपयोगकर्ता ही कुंजी बदल सकते हैं। ब्लॉक के पाठ एडमिन भाषा का अनुसरण करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, उदाहरण के लिए Key not found, This key belongs to another product, Domain limit reached या License expired on के साथ एक तारीख। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो एक्सटेंशन अंतिम ज्ञात स्थिति पर काम करता रहता है।

एक कुंजी एक डोमेन पर काम करती है: OpenCart कॉन्फ़िगरेशन में दिया गया स्टोर का पता। स्टोर से कुंजी हटाने से उसका डोमेन स्लॉट मुक्त नहीं होता। अपने vibefox.net खाते में स्लॉट मुक्त करें।

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

लाइसेंस समाप्त होने पर एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। जब आप एडमिन Dashboard या Edit पेज खोलते हैं, तो स्थिति अपने-आप दोबारा जाँची जाती है: कुंजी दर्ज करने के बाद पहले 14 दिनों में दिन में एक बार, फिर सप्ताह में एक बार। कोई cron जॉब आवश्यक नहीं है। एक्सटेंशन अनइंस्टॉल करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं।

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

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

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

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

वेबहुक अस्वीकार होते हैं: अस्वीकृत वेबहुक लॉग में लिखे जाते हैं। 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 वेबहुक दोबारा भेजता है।

ब्राउज़र में वेबहुक URL केवल POST दिखाता है: यह सामान्य है। यह URL केवल Yoco के अनुरोध स्वीकार करता है।

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

Confirm Order के बाद ग्राहक को त्रुटि दिखती है: एक्सटेंशन पेज पर Log फ़ील्ड देखें। Yoco is not available at the moment. Please choose another payment method. का अर्थ है कि वर्तमान मोड में सीक्रेट कुंजी नहीं है।

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

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

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

डेवलपर्स के लिए: Yoco चेकआउट बनने से पहले एक्सटेंशन अनुरोध डेटा और ऑर्डर के साथ OpenCart इवेंट yoco_p_checkout_payload ट्रिगर करता है, ताकि कोई दूसरा एक्सटेंशन अनुरोध में जोड़ सके।

अनइंस्टॉल

Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Yoco Pay Gateway के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटा देता है: Enable/Disable, Sort Order, Geo Zone, Total और Orders अनुभाग की ऑर्डर स्थितियाँ, जो फिर से इंस्टॉल करने पर डिफ़ॉल्ट पर लौट आती हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर उसके इवेंट्स और उसकी startup action भी, जो maintenance mode में webhook और ग्राहक की वापसी को आगे जाने देती है)। यदि Delete data चालू है, तो बाकी गेटवे सेटिंग्स (शीर्षक, विवरण, टेस्ट मोड, कुंजियाँ, वेबहुक सीक्रेट, लॉगिंग), लॉग, और एक्सटेंशन द्वारा Yoco पर रजिस्टर किए गए वेबहुक हटा दिए जाते हैं। यदि यह बंद है, तो उन्हें बाद में दोबारा इंस्टॉल करने के लिए रखा जाता है। Yoco चेकआउट और रिफ़ंड हमेशा रखे जाते हैं, इसलिए पहले से भुगतान किए गए ऑर्डर दोबारा इंस्टॉल करने के बाद भी रिफ़ंड किए जा सकते हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स रखते हैं।

OpenCart 4 पर फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ और इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox Yoco Pay Gateway के आगे Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किए गए पैकेज को हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।

Yoco अपने-अपने स्वामी का ट्रेडमार्क है। यह एक्सटेंशन Yoco से संबद्ध नहीं है और न ही Yoco द्वारा समर्थित है।