VibeFox HyperPay for OpenCart — सहायता

आवश्यकताएँ

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

PHP: 8.0 या उसके बाद का संस्करण, OpenSSL एक्सटेंशन के साथ (यह वेबहुक को डिक्रिप्ट करता है)।

HyperPay खाता: आपका मर्चेंट खाता सेट होने पर HyperPay Access Token और Entity ID जारी करता है। टेस्ट और लाइव क्रेडेंशियल अलग-अलग होते हैं। आपको HyperPay डैशबोर्ड में एक भुगतान वेबहुक और उसकी डिक्रिप्शन कुंजी (webhook key) भी चाहिए, जो Administration > Webhooks में दिखती है (देखें कॉन्फ़िगरेशन)।

कार्ड का डेटा: कार्ड केवल HyperPay विजेट में दर्ज होता है, इसलिए कार्ड का डेटा कभी आपके सर्वर से नहीं गुज़रता (PCI DSS SAQ A)।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. HyperPay द्वारा जारी टेस्ट Access Token, Entity ID और वेबहुक कुंजी दर्ज करें और Test Mode चालू रखें।

5. HyperPay डैशबोर्ड (Administration > Webhooks) में इस सेक्शन के Webhook में दिखाए गए URL के साथ एक भुगतान वेबहुक जोड़ें और उसकी डिक्रिप्शन कुंजी उसी मोड की वेबहुक कुंजी वाली फ़ील्ड में कॉपी करें।

6. Enable/Disable चालू करें, Save पर क्लिक करें और HyperPay टेस्ट कार्ड से एक टेस्ट भुगतान करें। फिर लाइव क्रेडेंशियल दर्ज करें और Test Mode बंद करें।

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox HyperPay Payment Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर, जब तक टेस्ट मोड चालू है, पेज Test mode is on: payments go to the HyperPay test system and no real money is charged. दिखाता है। यदि वर्तमान मोड के लिए Access Token या Entity ID नहीं है (तब चेकआउट पर भुगतान विधि नहीं दिखती), या वर्तमान मोड में कोई मान्य वेबहुक कुंजी नहीं है (तब भुगतान केवल तभी पक्के होते हैं जब ग्राहक स्टोर पर लौटता है), तो पेज आपको चेतावनी देता है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

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

HyperPay

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

Title: वह शीर्षक जो ग्राहक चेकआउट के दौरान देखता है। यही ऑर्डर में सहेजा गया भुगतान विधि का नाम भी है। डिफ़ॉल्ट: Credit/Debit Card (HyperPay)। अनिवार्य।

Description: वह पाठ जो ग्राहक को Confirm Order चरण में, कन्फ़र्म बटन के ऊपर और कार्ड आइकन के नीचे दिखता है। डिफ़ॉल्ट: Pay securely using your credit or debit card.

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

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

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

API क्रेडेंशियल

Access Token, Entity ID और वेबहुक कुंजी आपका मर्चेंट खाता सेट होने पर HyperPay जारी करता है। टेस्ट और लाइव क्रेडेंशियल अलग-अलग होते हैं। वेबहुक कुंजी HyperPay डैशबोर्ड में Administration > Webhooks के अंतर्गत दिखती है। इस सेक्शन में HyperPay वेबसाइट और डेवलपर दस्तावेज़ों के लिंक हैं।

Test Mode: HyperPay टेस्ट सिस्टम (eu-test.oppwa.com) और टेस्ट क्रेडेंशियल का उपयोग करता है। कोई वास्तविक राशि नहीं ली जाती। लाइव क्रेडेंशियल (eu-prod.oppwa.com) से असली भुगतान स्वीकार करने के लिए इसे बंद करें। डिफ़ॉल्ट: चालू। चालू रहने पर ग्राहक Confirm Order चरण में Test mode: no real payment will be made. देखते हैं।

Test Access Token: आपके HyperPay टेस्ट खाते का bearer token।

Test Entity ID: टेस्ट भुगतान चैनल का Entity ID।

Test Webhook Key: 64 अक्षरों की हेक्साडेसिमल कुंजी, जिससे टेस्ट सिस्टम की वेबहुक सूचनाएँ डिक्रिप्ट होती हैं।

Live Access Token: आपके HyperPay लाइव खाते का bearer token।

Live Entity ID: लाइव भुगतान चैनल का Entity ID।

Live Webhook Key: 64 अक्षरों की हेक्साडेसिमल कुंजी, जिससे लाइव सिस्टम की वेबहुक सूचनाएँ डिक्रिप्ट होती हैं।

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

Webhook

वेबहुक आपके स्टोर को भुगतानों के बारे में सूचित करता है, भले ही ग्राहक स्टोर पर लौटने से पहले ब्राउज़र बंद कर दे। HyperPay डैशबोर्ड (Administration > Webhooks) में इस सेक्शन के Webhook URL में दिखाए गए URL के साथ भुगतानों के लिए एक वेबहुक जोड़ें। OpenCart 3 में यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_hyperpay_payment_gateway/webhook, और OpenCart 4 में https://your-store/index.php?route=extension/wcp_hyperpay_payment_gateway/payment/wcp_hyperpay_payment_gateway.webhook; यह आपकी OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। URL को ठीक वैसे ही कॉपी करें जैसा सेटिंग्स में दिखता है। फिर वेबहुक डिक्रिप्शन कुंजी को उसी मोड के लिए Test Webhook Key या Live Webhook Key में कॉपी करें।

HyperPay वेबहुक एन्क्रिप्टेड होते हैं (AES-256-GCM)। जो वेबहुक आपकी कुंजियों से डिक्रिप्ट नहीं हो सकता, उसे अस्वीकार कर दिया जाता है। केवल भुगतान सूचनाएँ संसाधित होती हैं, और भुगतान आपके किसी ऑर्डर के चेकआउट से जुड़ा होना चाहिए, और उसी मोड में बना होना चाहिए जिस मोड की कुंजी ने उसे डिक्रिप्ट किया। HyperPay की टेस्ट सूचनाएँ स्वीकार कर ली जाती हैं। वेबहुक HyperPay डैशबोर्ड में किए गए कैप्चर, रिवर्सल, रिफ़ंड और चार्जबैक की भी सूचना देता है (देखें ऑर्डर और रिफ़ंड)। वेबहुक के बिना, भुगतान तभी पक्का होता है जब ग्राहक भुगतान के बाद स्टोर पर लौटता है। स्टोर मेंटेनेंस मोड में होने पर भी वेबहुक काम करता है: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को जाने देता है, और OpenCart 4 में एक्सटेंशन एक स्टार्टअप एक्शन जोड़ता है जो वेबहुक और HyperPay से ग्राहक की वापसी को जाने देता है।

Payment

Transaction Type: कार्ड से शुल्क कैसे लिया जाए।

Payment Brands: भुगतान विजेट में दिखने वाले ब्रांड: VISA, Mastercard, mada, American Express, STC Pay, Apple Pay। डिफ़ॉल्ट: VISA और Mastercard। यदि कोई ब्रांड चुना नहीं गया है, तो पेज चेतावनी देता है और विजेट VISA और Mastercard दिखाता है। केवल वही ब्रांड चुनें जो HyperPay ने आपके Entity ID के लिए सक्षम किए हैं; mada, STC Pay और Apple Pay अक्सर अपनी अलग entity इस्तेमाल करते हैं, जिसे यह एक्सटेंशन समर्थित नहीं करता।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के (गायब ऑर्डर) बनाता है। ऑर्डर को स्टेटस तभी मिलता है जब HyperPay भुगतान की पुष्टि कर दे। अस्वीकृत या अधूरे भुगतान से ऑर्डर बिना स्टेटस के रहता है, और कार्ट सुरक्षित रहता है। नीचे के हर फ़ील्ड में आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध हैं। OpenCart में On hold स्टेटस नहीं है, इसलिए उनमें से तीन का डिफ़ॉल्ट Pending है; आप System > Localisation > Order Statuses में अपने स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।

Order Status After Payment: तब सेट होता है जब HyperPay सही राशि और मुद्रा वाले डेबिट की पुष्टि करता है, या प्री-ऑथराइज़ेशन कैप्चर होता है। डिफ़ॉल्ट: Processing।

Authorized (Capture Required) Status: प्री-ऑथराइज़ेशन ने राशि रोक ली है; इसे ऑर्डर टैब में कैप्चर करें। HyperPay डैशबोर्ड में रिवर्सल ऑर्डर को रद्द करता है, जब तक वह इस स्टेटस में है। डिफ़ॉल्ट: Pending।

Awaiting Payment Status: HyperPay ने ऐसा भुगतान बताया है जो पुष्टि की प्रतीक्षा में है; वेबहुक बाद में उसकी पुष्टि करेगा। डिफ़ॉल्ट: Pending।

On Hold (Review) Status: भुगतान की गई राशि या मुद्रा ऑर्डर से अलग है, या ऑर्डर रद्द होने के बाद भुगतान आया है। एक नोट कारण बताता है। डिफ़ॉल्ट: Pending।

Canceled Status: HyperPay में प्री-ऑथराइज़ेशन रिवर्स होने पर सेट होता है। इस स्टेटस वाले ऑर्डर के लिए भुगतान ऑर्डर को दोबारा खोलने के बजाय उसे होल्ड पर रखता है। डिफ़ॉल्ट: Canceled।

Refunded Status: इस स्टेटस वाले ऑर्डर के लिए मिला भुगतान केवल नोट किया जाता है; ऑर्डर नहीं बदलता। डिफ़ॉल्ट: Refunded।

उन्नत

Enable Logging: API अनुरोधों और उत्तरों को OpenCart लॉग फ़ोल्डर (storage/logs) में hyperpay_p_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती, और 5 MB पर इसे hyperpay_p_debug.old.log.php में बदल दिया जाता है। त्रुटियाँ और चेतावनियाँ हमेशा दर्ज होती हैं। लॉग में कार्ड का डेटा, कुंजियाँ या ग्राहक का डेटा नहीं होता। डिफ़ॉल्ट: बंद।

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

Delete Data on Uninstall: चालू होने पर एक्सटेंशन अनइंस्टॉल करने पर सेटिंग्स और लॉग फ़ाइलें हटा दी जाती हैं। ऑर्डर और HyperPay भुगतान प्रयास हमेशा रखे जाते हैं, क्योंकि देर से आने वाले वेबहुक और मौजूदा ऑर्डर के कैप्चर को उनकी ज़रूरत होती है। डिफ़ॉल्ट: बंद।

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

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

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit/Debit Card (HyperPay))। Confirm Order चरण पर ग्राहक आपका विवरण देखता है। OpenCart इसी चरण पर ऑर्डर बनाता है, अभी भी बिना स्टेटस के। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर की मुद्रा में ऑर्डर राशि के लिए HyperPay चेकआउट तैयार करता है और आपके स्टोर का HyperPay payment पेज खोलता है, जिसमें HyperPay विजेट और Please complete your payment below: होता है। यदि HyperPay ग्राहक की भाषा का समर्थन करता है, तो विजेट वही भाषा इस्तेमाल करता है। टेस्ट मोड में पेज Test mode: use a HyperPay test card, no real payment will be made. दिखाता है। ग्राहक विजेट में कार्ड का विवरण दर्ज करता है, या Choose another payment method का अनुसरण करके चेकआउट पर वापस जाता है। पेज रीलोड होने पर, जब तक ऑर्डर राशि नहीं बदलती, वही चेकआउट 25 मिनट तक दोबारा इस्तेमाल होता है; उसके बाद नया चेकआउट तैयार होता है।

OpenCart 4 में ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। डिफ़ॉल्ट रूप से OpenCart 4 भुगतान पता नहीं पूछता; तब एक्सटेंशन शिपिंग पता बिलिंग पते के रूप में HyperPay को भेजता है।

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

यदि भुगतान पूरा नहीं हुआ, तो ग्राहक एक संदेश के साथ चेकआउट पर लौटता है: Payment failed: और HyperPay से कारण, Payment was not completed. Please try again., या We could not confirm your payment yet. If you were charged, the order will be updated automatically; otherwise please try again. कार्ट सुरक्षित रहता है, और ग्राहक फिर से भुगतान कर सकता है। यदि भुगतान फ़ॉर्म तैयार नहीं हो सकता, तो ग्राहक Confirm Order चरण पर एक छोटे संदेश के साथ रहता है, जैसे यह कि भुगतान प्रदाता ने कुछ बिलिंग विवरण स्वीकार नहीं किए, या भुगतान कॉन्फ़िगरेशन त्रुटि के कारण भुगतान फ़ॉर्म उपलब्ध नहीं है। तकनीकी कारण लॉग में लिखा जाता है।

OpenCart 4 में ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं। OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर नया ऑर्डर बनाता है; OpenCart 4 चेकआउट का ऑर्डर अपडेट करता है, इसलिए अस्वीकृत भुगतान के बाद ग्राहक उसी ऑर्डर को नए भुगतान प्रयास से चुकाता है। यदि वही कार्ट किसी दूसरे ऑर्डर से पहले ही भुगतान हो चुका है, तो ग्राहक दोबारा भुगतान करने के बजाय सफलता पेज पर चला जाता है। कार्ट में कोई भी बदलाव, जिसमें नई मात्रा भी शामिल है, एक नया कार्ट माना जाता है जिसका अपना भुगतान ज़रूरी है।

OpenCart 4 सफलता पेज दिखाए जाने तक ऑर्डर को चेकआउट में रखता है। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए आपने उसे रद्द किया), तो ग्राहक Payment failed. Please try again or use another card. के साथ चेकआउट पर वापस भेज दिया जाता है। यदि वह भुगतान हो चुका था और फिर रद्द या रिफ़ंड किया गया, तो संदेश Your previous order was closed by the store. Please confirm the order again to pay with a new order. होता है। यदि वह पहले से भुगतान हो चुका है और कार्ट में अब नई खरीदारी है, तो संदेश Your previous order #(नंबर) has already been placed. Your cart has changed: please confirm the new order to pay for it. होता है। हर स्थिति में अगला Confirm Order कार्ट के लिए एक नया ऑर्डर भुगतान करता है। भुगतान किया हुआ ऑर्डर कभी किसी दूसरे कार्ट के लिए भुगतान किया हुआ नहीं दिखाया जाता।

HyperPay API की आवश्यकता के अनुसार राशियाँ दो दशमलव स्थानों के साथ भेजी जाती हैं। 3-दशमलव वाली मुद्राओं (KWD, BHD, JOD, OMR) में ऑर्डर का कुल मूल्य दो दशमलव तक पूर्णांकित किया जाता है।

इस एक्सटेंशन में OpenCart से रिफ़ंड या void नहीं हैं, सेव किए गए कार्ड या टोकनाइज़ेशन नहीं हैं, सब्सक्रिप्शन नहीं हैं, Apple Pay डोमेन सत्यापन नहीं है, हर ब्रांड की अलग entity नहीं है, और Tabby, Tamara या अन्य buy-now-pay-later विधियाँ नहीं हैं।

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

ऑर्डर स्टेटस

No status (missing order): ग्राहक को भुगतान पेज पर भेजा गया था और उसने भुगतान नहीं किया, भुगतान अस्वीकार हुआ, या HyperPay ने अभी भुगतान की पुष्टि नहीं की है। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो।

Order Status After Payment (default Processing): डेबिट भुगतान की पुष्टि हुई, या प्री-ऑथराइज़ेशन कैप्चर हुआ। एक नोट HyperPay का परिणाम कोड, विवरण और भुगतान ID दिखाता है। यदि HyperPay ने भुगतान को मैन्युअल समीक्षा के लिए चिह्नित किया है, तो नोट में यह लिखा होता है; भेजने से पहले इसे HyperPay डैशबोर्ड में जाँचें।

Authorized (Capture Required) Status (default Pending): प्री-ऑथराइज़ेशन से राशि रोकी गई है। इसे ऑर्डर टैब में या HyperPay डैशबोर्ड में कैप्चर करें; फिर कैप्चर वेबहुक ऑर्डर को Order Status After Payment पर ले जाता है।

Awaiting Payment Status (default Pending): HyperPay ने भुगतान को लंबित बताया है। जब HyperPay पुष्टि करता है, तो ऑर्डर Order Status After Payment पर चला जाता है।

On Hold (Review) Status (default Pending): HyperPay ने ऑर्डर से अलग राशि या मुद्रा बताई है (उदाहरण के लिए, भुगतान पेज खुलने के बाद कार्ट बदला गया), या ऑर्डर रद्द होने के बाद भुगतान आया है। नोट इसे समझाता है। HyperPay डैशबोर्ड में भुगतान जाँचें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

Canceled Status (default Canceled): HyperPay डैशबोर्ड में प्री-ऑथराइज़ेशन रिवर्स हुआ, और रिवर्सल वेबहुक अधिकृत ऑर्डर को रद्द करता है।

अस्वीकृति परिणाम कभी भी ऐसे ऑर्डर को नहीं बदलता जिसका पहले से स्टेटस है। यदि पहले से भुगतान किए गए ऑर्डर के लिए कोई और सफल भुगतान आता है, या पहले से भुगतान किए गए कार्ट का कोई और ऑर्डर भुगतान होता है, तो भुगतान किया हुआ ऑर्डर नहीं बदलता। एक नोट आपसे HyperPay डैशबोर्ड में डुप्लिकेट भुगतान रिफ़ंड करने को कहता है। Refunded Status वाले ऑर्डर के लिए सफल भुगतान केवल एक नोट जोड़ता है।

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

VibeFox HyperPay Payment Gateway टैब

Sales > Orders में HyperPay से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox HyperPay Payment Gateway टैब भुगतान ID (कैप्चर के बाद कैप्चर ID भी) दिखाता है, टेस्ट भुगतानों के लिए Test mode लेबल के साथ, लेन-देन का प्रकार, चेकआउट ID, मर्चेंट लेन-देन ID, HyperPay को भेजी गई राशि, परिणाम, और ऑर्डर के HyperPay notes। यह टैब उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन तक पहुँच है।

कैप्चर

प्री-ऑथराइज़्ड ऑर्डर के लिए, जो अभी कैप्चर नहीं हुआ है, टैब राशि के साथ Capture payment दिखाता है। उस पर क्लिक करें और Capture the pre-authorized amount through HyperPay? की पुष्टि करें। वर्तमान ऑर्डर कुल राशि उसी मोड में कैप्चर होती है जिसमें प्री-ऑथराइज़ेशन किया गया था, इसलिए उस मोड का Access Token और Entity ID सेट होने चाहिए। एक्सटेंशन बदलने का अधिकार आवश्यक है (System > Users > User Groups में सेट)। सफल कैप्चर के बाद ऑर्डर को Order Status After Payment मिलता है और कैप्चर ID टैब व नोट्स में जुड़ जाता है। स्टेटस सीधे लिखा जाता है, बिना ऑर्डर ईमेल या स्टॉक अपडेट के। यदि HyperPay कैप्चर अस्वीकार करता है, तो परिणाम कोड और विवरण दिखाए जाते हैं और नोट्स में जुड़ जाते हैं, और ऑर्डर अधिकृत बना रहता है। डबल क्लिक से दो बार कैप्चर नहीं होता। प्री-ऑथराइज़ेशन का रिवर्सल (void) HyperPay डैशबोर्ड में किया जाता है।

रिफ़ंड

OpenCart से रिफ़ंड समर्थित नहीं हैं। Sales > Returns में उत्पाद वापसी HyperPay के ज़रिए पैसे वापस नहीं भेजती। भुगतान को HyperPay डैशबोर्ड में रिफ़ंड करें। HyperPay में किए गए रिफ़ंड और चार्जबैक वेबहुक द्वारा ऑर्डर में नोट के रूप में जोड़े जाते हैं; ऑर्डर का स्टेटस नहीं बदलता। ज़रूरत हो तो उसे मैन्युअली अपडेट करें।

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

यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox HyperPay Payment Gateway, Extensions > Extensions > Payments > VibeFox HyperPay Payment Gateway > Edit पर पहला ब्लॉक है, जो सेटिंग्स के ऊपर होता है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क करके, स्टेटस (जैसे वह तारीख जब तक लाइसेंस सक्रिय है, और आपका डोमेन) दिखाता है, और ये बटन: Check now स्टेटस दोबारा जाँचने के लिए, Change key दूसरी कुंजी दर्ज करने के लिए और Remove key इस स्टोर से कुंजी हटाने के लिए। इनके नीचे Product: opencart-payment-hyperpay वाली पंक्ति और 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 खाते में स्लॉट खाली करें।

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

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

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

चेकआउट पर HyperPay दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और वर्तमान मोड में उसका Access Token और Entity ID है: टेस्ट मोड में टेस्ट वाले, लाइव मोड में लाइव वाले। सेटिंग्स पेज पर गायब होने पर चेतावनी दिखती है। यह भी जाँचें कि भुगतान पता चुने हुए Geo Zone में है, और ऑर्डर सेटिंग्स के Total तक पहुँचता है।

भुगतान हो गया, पर ऑर्डर बिना स्टेटस के रहा: वेबहुक काम नहीं कर रहा और ग्राहक स्टोर पर वापस नहीं आया। HyperPay डैशबोर्ड में जाँचें कि जिस मोड का आप उपयोग करते हैं, उसके लिए भुगतान वेबहुक मौजूद है, उसका URL बिल्कुल वही है जो Webhook URL में दिखता है, और उसकी डिक्रिप्शन कुंजी उसी मोड की वेबहुक कुंजी फ़ील्ड में है। Enable Logging चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें।

वेबहुक का उत्तर Decryption failed है: वेबहुक कुंजी किसी दूसरे वेबहुक या दूसरे मोड की है। HyperPay डैशबोर्ड से कुंजी फिर से कॉपी करें।

वेबहुक का उत्तर Webhook key not configured है: कोई मान्य वेबहुक कुंजी सेट नहीं है। 64 अक्षरों की कुंजी सेटिंग्स में चिपकाएँ। HyperPay वेबहुक फिर से भेजेगा।

वेबहुक का उत्तर Busy, retry later है: उसी समय कोई दूसरा अनुरोध ऑर्डर को संसाधित कर रहा था, या ऑर्डर स्टेटस सेट नहीं हो सका। HyperPay वेबहुक फिर से भेजेगा। कारण लॉग में है।

लॉग में Webhook ignored दिखता है: भुगतान इस स्टोर के किसी ऑर्डर का नहीं है, या दूसरे मोड में किया गया था। टेस्ट और लाइव भुगतान अलग रखे जाते हैं।

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

भुगतान फ़ॉर्म लोड नहीं होता: लॉग देखें। कॉन्फ़िगरेशन त्रुटि आमतौर पर वर्तमान मोड के लिए गलत Access Token या Entity ID का संकेत है। बिलिंग विवरण के बारे में संदेश का अर्थ है कि HyperPay ने ग्राहक का कुछ डेटा स्वीकार नहीं किया। सुनिश्चित करें कि चुने हुए Payment Brands आपके Entity ID के लिए सक्रिय हैं।

ग्राहक को The payment session was not found. Please confirm the order again.: दिखता है: इस ऑर्डर के लिए भुगतान पेज का लिंक अब मान्य नहीं है। ग्राहक चेकआउट पर ऑर्डर फिर से कन्फ़र्म करता है।

Order is in the on hold status: ऑर्डर टैब के नोट्स पढ़ें (देखें ऑर्डर स्टेटस), HyperPay डैशबोर्ड में भुगतान जाँचें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

कैप्चर विफल होता है: टैब और नोट्स में परिणाम कोड और विवरण पढ़ें। कैप्चर प्री-ऑथराइज़ेशन के मोड में भेजा जाता है, इसलिए उस मोड के क्रेडेंशियल सेट होने चाहिए; नहीं तो टैब बताएगा कि उस मोड के Access Token / Entity ID खाली हैं।

अनइंस्टॉल

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

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

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