VibeFox OpenPay for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

PHP: 8.0 या बाद का संस्करण। मॉड्यूल पुराने PHP संस्करणों पर इंस्टॉल नहीं होगा।

HTTPS: आपके स्टोर को HTTPS का उपयोग करना होगा, क्योंकि कार्ड फ़ॉर्म आपके चेकआउट पेज पर है।

OpenPay खाता: मेक्सिको, कोलंबिया या पेरू का OpenPay खाता। आपको उसका Merchant ID, निजी कुंजी (sk_...) और सार्वजनिक कुंजी (pk_...) चाहिए। सैंडबॉक्स और लाइव डैशबोर्ड के Merchant ID और कुंजियाँ अलग होती हैं, और मॉड्यूल उन्हें अलग रखता है।

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

कार्ड आपके चेकआउट पेज पर टाइप किया जाता है, लेकिन उसे ब्राउज़र में openpay.js पढ़ता और टोकनाइज़ करता है। कार्ड फ़ील्ड का कोई नाम नहीं होता और वे कभी आपके सर्वर पर नहीं भेजे जाते। चूँकि कार्ड फ़ॉर्म आपके पेज पर है, आपका PCI DSS दायरा SAQ A-EP है; अपने acquirer से पूछें।

इंस्टॉलेशन

1. बैक ऑफिस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox OpenPay Gateway खोजकर Configure पर क्लिक करें।

3. Configure पेज के ऊपर वाले लाइसेंस ब्लॉक में License key फ़ील्ड में अपनी VibeFox लाइसेंस कुंजी चिपकाएँ और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

4. Account country चुनें और सैंडबॉक्स तथा लाइव कुंजियाँ दर्ज करें (देखें कॉन्फ़िगरेशन)।

5. अनुशंसित: OpenPay डैशबोर्ड में वेबहुक URL जोड़ें (देखें कॉन्फ़िगरेशन)।

6. Enable / Disable चालू करें और Save पर क्लिक करें। OpenPay सैंडबॉक्स टेस्ट कार्ड से भुगतान का परीक्षण करें, फिर वास्तविक भुगतान लेने के लिए Sandbox mode बंद करें।

इंस्टॉल होने पर मॉड्यूल दो ऑर्डर स्टेटस बनाता है: Awaiting OpenPay payment और OpenPay payment on hold। PrestaShop आपके स्टोर की मुद्राओं, देशों और ग्राहक समूहों के लिए एक नया भुगतान मॉड्यूल देता है। आप इन्हें Payment > Preferences में सीमित कर सकते हैं।

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox OpenPay Gateway > Configure। हर सेक्शन का अपना Save बटन है, जो पूरे पेज को सेव करता है। फ़ील्ड के ऊपर पेज आपको चेतावनी देता है जब वर्तमान मोड की कुंजियाँ अधूरी हों (तब चेकआउट पर भुगतान विधि छिपी रहती है), जब आपके स्टोर की डिफ़ॉल्ट मुद्रा चुने गए खाता देश द्वारा स्वीकार नहीं की जाती, और सैंडबॉक्स मोड चालू होने पर Sandbox mode is enabled — no real charges are made. दिखाता है।

सेव करते समय कुंजियों की जाँच होती है। Merchant ID में केवल अक्षर और अंक हो सकते हैं, निजी कुंजी sk_ से और सार्वजनिक कुंजी pk_ से शुरू होनी चाहिए। अमान्य मान सेव नहीं होता: पिछला मान बना रहता है और त्रुटि दिखाई जाती है, जैसे Sandbox: The private key must start with sk_. यदि भुगतान विधि चालू है पर वर्तमान मोड की कुंजियाँ अधूरी हैं, तो आपको यह संदेश भी दिखेगा कि गेटवे चेकआउट पर छिपा रहेगा। खाली Title को Enter a title for the payment method. के साथ अस्वीकार किया जाता है।

OpenPay

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

Title: चेकआउट पर ग्राहकों को दिखने वाला भुगतान विधि का नाम। यही नाम ऑर्डर में भी सेव होता है। डिफ़ॉल्ट: Credit or debit card (OpenPay)। आवश्यक।

Description: चेकआउट पर कार्ड फ़ॉर्म के ऊपर दिखाया जाने वाला टेक्स्ट। डिफ़ॉल्ट: Pay securely with your credit or debit card. Your bank may ask you to confirm the payment (3D Secure).

OpenPay खाता

Merchant ID, निजी कुंजी (sk_) और सार्वजनिक कुंजी (pk_) आपके OpenPay डैशबोर्ड में Settings (Configuración) के अंतर्गत हैं। इस सेक्शन में मेक्सिको, कोलंबिया और पेरू के सैंडबॉक्स और लाइव डैशबोर्ड के लिंक हैं।

Account country: आपके OpenPay खाते का देश। यह OpenPay API, उस देश की openpay.js लाइब्रेरी और स्वीकृत मुद्राओं को चुनता है। डिफ़ॉल्ट: Mexico।

Sandbox mode: OpenPay सैंडबॉक्स का उपयोग करता है (टेस्ट कुंजियाँ, कोई वास्तविक शुल्क नहीं) और कुंजियों तथा API दोनों को सैंडबॉक्स में बदल देता है। चालू रहने पर चेकआउट पर SANDBOX MODE बैज दिखाया जाता है। डिफ़ॉल्ट: चालू। वास्तविक भुगतान लेने के लिए इसे बंद करें।

Sandbox Merchant ID: सैंडबॉक्स डैशबोर्ड से Merchant ID, Settings (Configuración), API कुंजियाँ।

Sandbox Private Key: सैंडबॉक्स निजी कुंजी। यह sk_ से शुरू होती है। इसका उपयोग केवल सर्वर पर होता है; इसे कभी साझा न करें।

Sandbox Public Key: सैंडबॉक्स सार्वजनिक कुंजी। यह pk_ से शुरू होती है। openpay.js इसे ब्राउज़र में कार्ड टोकनाइज़ करने के लिए उपयोग करता है।

Live Merchant ID: लाइव डैशबोर्ड से Merchant ID, Settings (Configuración), API कुंजियाँ।

Live Private Key: लाइव निजी कुंजी (sk_...)।

Live Public Key: लाइव सार्वजनिक कुंजी (pk_...)।

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

Clear saved secrets: किसी निजी कुंजी पर टिक लगाकर Save पर क्लिक करें, तो वह हट जाती है। खाली फ़ील्ड सेव किए गए मान को बनाए रखता है।

Webhook

वेबहुक अनिवार्य नहीं है, लेकिन इसकी अनुशंसा की जाती है। यह भुगतानों की पुष्टि करता है जब ग्राहक 3D Secure पेज से वापस नहीं लौटता, उदाहरण के लिए ब्राउज़र बंद कर देने पर। OpenPay डैशबोर्ड में Settings > Webhooks पर जाएँ और इस सेक्शन में Webhook URL के अंतर्गत दिखाया गया URL जोड़ें। फ़्रेंडली URL के साथ यह ऐसा दिखता है: https://your-shop/module/wcp_openpay_gateway/webhook, संभवतः /en/ जैसे भाषा कोड के साथ। इसे ठीक वैसे ही कॉपी करें जैसे सेटिंग्स में दिखाया गया है। जिस हर मोड (सैंडबॉक्स और लाइव) का आप उपयोग करते हैं, उसके डैशबोर्ड में वेबहुक जोड़ें।

वेबहुक जोड़ने पर OpenPay इस URL पर एक सत्यापन कोड भेजता है। यह कोड आगमन की तारीख के साथ इस सेक्शन में दिखता है, ताकि आप OpenPay डैशबोर्ड में वेबहुक की पुष्टि कर सकें।

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

OpenPay वेबहुक पर हस्ताक्षर नहीं करता, इसलिए मॉड्यूल अधिसूचना पर कभी भरोसा नहीं करता। वह इसका उपयोग केवल शुल्क खोजने के लिए करता है, फिर उस मोड और खाता देश की निजी कुंजी से, जिसमें भुगतान हुआ था, OpenPay API से शुल्क पढ़ता है। ऐसे शुल्क की अधिसूचना जिसे इस स्टोर ने नहीं बनाया, अनदेखी की जाती है। वेबहुक मेंटेनेंस मोड में स्टोर के रहते हुए भी काम करता है और आपके स्टोर की देश सीमा से अवरुद्ध नहीं होता।

उन्नत

Debug log: भुगतान के चरणों को मॉड्यूल फ़ोल्डर में logs/wc_opy_debug.log.php में दर्ज करता है। यह फ़ाइल वेब से नहीं खोली जा सकती। बंद होने पर भी त्रुटियाँ और चेतावनियाँ दर्ज होती हैं। कुंजियाँ, कार्ड डेटा और ग्राहक विवरण कभी दर्ज नहीं होते। डिफ़ॉल्ट: बंद।

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

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

चेकआउट

भुगतान चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit or debit card (OpenPay)) और Cardholder name, Card number, Expiry (MM/YY) और Card code (CVV) भरता है। सैंडबॉक्स मोड में फ़ॉर्म SANDBOX MODE — Test environment. No real charges will be made. दिखाता है। जब ग्राहक पुष्टि करता है, तो openpay.js ब्राउज़र में कार्ड को एक बार उपयोग होने वाले टोकन में बदलता है, और धोखाधड़ी-रोधी लाइब्रेरी एक डिवाइस सेशन ID जोड़ती है। आपके स्टोर को केवल ये दो मान और कार्ट नंबर भेजे जाते हैं। यदि फ़ॉर्म अधूरा है, तो फ़ॉर्म के नीचे Please fill in all card fields. दिखता है।

इसके बाद मॉड्यूल कार्ट की मुद्रा में, कार्ट के कुल योग के लिए 3D Secure के साथ शुल्क बनाता है और ग्राहक को उसके बैंक के 3D Secure पेज पर भेजता है, जिसे OpenPay दिखाता है। हर प्रयास को अपना OpenPay ऑर्डर संदर्भ मिलता है। शुल्क का विवरण Cart #, कार्ट नंबर और आपके स्टोर का नाम है। ग्राहक का नाम, ईमेल और फ़ोन OpenPay को भेजे जाते हैं; OpenPay पर कोई ग्राहक खाता नहीं बनता। इस बिंदु पर अभी कोई ऑर्डर मौजूद नहीं है।

जब ग्राहक लौटता है, तो मॉड्यूल OpenPay API से शुल्क पढ़ता है। ऑर्डर केवल OpenPay की पुष्टि के बाद ही भुगतान किया हुआ के रूप में चिह्नित होता है: शुल्क इसी कार्ट का होना चाहिए, पूरा हुआ होना चाहिए, और कार्ट के कुल योग व मुद्रा से बिल्कुल मेल खाना चाहिए। फिर ऑर्डर बनता है और ग्राहक को Your card payment has been received. के साथ ऑर्डर पुष्टि पेज दिखता है। यदि OpenPay शुल्क को प्रक्रियाधीन बताता है, तो ऑर्डर Awaiting OpenPay payment में बनता है और पेज पर We are confirming your card payment with OpenPay. The order will be updated automatically — please do not pay again. दिखता है। यदि परिणाम अभी ज्ञात नहीं है, तो वही पाठ और Check again बटन व Back to checkout बटन वाला Payment confirmation पेज दिखता है; वेबहुक आते ही ऑर्डर बना देता है। यदि प्रक्रियाधीन शुल्क बाद में विफल हो जाए, तो ऑर्डर पुष्टि पेज पर Your OpenPay card payment was not completed. Please contact us about this order. दिखता है।

यदि कार्ड अस्वीकार हो जाए या 3D Secure विफल हो, तो ग्राहक The card payment was not completed (declined or 3-D Secure failed). Please try again or use another card. के साथ चेकआउट पर वापस आता है और फिर से भुगतान कर सकता है। कार्ट सुरक्षित रहता है। नया प्रयास करने से पहले मॉड्यूल कार्ट के पिछले शुल्क की जाँच करता है: यदि वह वास्तव में भुगतान हो चुका है, तो दूसरे शुल्क के बिना उसी से ऑर्डर बनाया जाता है; यदि वह अभी प्रक्रियाधीन है, तो ऑर्डर Awaiting OpenPay payment में बनता है; यदि उसकी स्थिति जाँची नहीं जा सकती, तो कोई नया शुल्क नहीं लगता और ग्राहक को We could not confirm the status of your previous payment attempt. Please try again in a few minutes. दिखता है। जिस कार्ट का पहले से ऑर्डर है, उस पर दोबारा शुल्क कभी नहीं लगता।

अस्वीकृत कार्ड को स्पष्ट संदेश मिलता है, उदाहरण के लिए The card has insufficient funds. Please use another card., The card has expired. Please use another card. या The security code (CVV) is not valid. Please check it and try again. OpenPay की तकनीकी त्रुटियाँ ग्राहकों को कभी नहीं दिखाई जातीं; वे लॉग में जाती हैं।

यदि भुगतान और उसकी पुष्टि के बीच कार्ट का कूपन मान्य नहीं रहता, तो वह ऑर्डर से हटा दिया जाता है। तब ऑर्डर एक नोट के साथ OpenPay payment on hold में चला जाता है, क्योंकि ग्राहक ने छूट वाली कीमत चुकाई है।

भुगतान विधि चेकआउट पर छिपी रहती है जब वह बंद हो, जब वर्तमान मोड की कुंजियाँ अधूरी हों, या जब कार्ट की मुद्रा खाता देश द्वारा स्वीकार न की जाए।

यह मॉड्यूल केवल कार्ड भुगतान स्वीकार करता है, जो तुरंत कैप्चर होते हैं। इसमें सेव किए गए कार्ड, सब्सक्रिप्शन, ब्याज-मुक्त किस्तें (MSI) या किस्त भुगतान, कार्ड पॉइंट्स से भुगतान, नकद, SPEI, PSE या CoDi भुगतान नहीं हैं, और न ही अलग-अलग ऑथराइज़ेशन और कैप्चर है।

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

ऑर्डर स्टेटस

अभी कोई ऑर्डर नहीं: ग्राहक 3D Secure पेज पर है, भुगतान पूरा नहीं किया है, या कार्ड अस्वीकार हो गया है। केवल कार्ट मौजूद है।

Payment accepted: भुगतान की पुष्टि हो गई। भुगतान OpenPay शुल्क ID को ट्रांज़ैक्शन ID के रूप में दर्ज होता है, और एक नोट शुल्क ID और मोड (लाइव या सैंडबॉक्स) दिखाता है।

Awaiting OpenPay payment: OpenPay शुल्क को प्रक्रियाधीन (अभी कैप्चर नहीं हुआ) बताता है। शुल्क पूरा होने पर ऑर्डर Payment accepted में, और विफल होने पर Payment error में चला जाता है।

OpenPay payment on hold: OpenPay कार्ट से अलग राशि या मुद्रा वाले पूरे हुए शुल्क की सूचना देता है (ऑर्डर भुगतान किया हुआ नहीं माना जाता, नोट में अंतर दिखता है), कूपन हटाया गया है, या ऐसे ऑर्डर के लिए भुगतान आया है जो पहले ही रद्द या रिफ़ंड हो चुका था (भुगतान दर्ज होता है)। ऑर्डर की जाँच करें और उसे पूरा करें, या OpenPay डैशबोर्ड में भुगतान रिफ़ंड करें।

Payment error: प्रक्रियाधीन शुल्क विफल हो गया, रद्द हो गया, या समाप्त हो गया।

Refunded: शुल्क मॉड्यूल के माध्यम से पूरी तरह रिफ़ंड किया गया।

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

OpenPay भुगतान ब्लॉक

ऑर्डर पेज पर OpenPay payment ब्लॉक दिखता है, जिसमें शुल्क ID, शुल्क स्थिति, वातावरण और खाता देश, वसूली गई राशि और ऑर्डर कुल, रिफ़ंड की गई राशि, सैंडबॉक्स भुगतानों के लिए Sandbox बैज, रिफ़ंड इतिहास और ऑर्डर के OpenPay notes शामिल हैं।

रिफ़ंड

मेक्सिको और पेरू के खातों के लिए: OpenPay payment ब्लॉक में राशि दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है, वह भर दी जाती है), वैकल्पिक रूप से कारण लिखें, और Refund via OpenPay पर क्लिक करें। Refund this amount through OpenPay? This cannot be undone. प्रश्न की पुष्टि करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं, OpenPay द्वारा वसूली गई राशि तक। आपके पास ऑर्डर संपादित करने की अनुमति होनी चाहिए। रिफ़ंड उसी मोड और खाता देश की कुंजियों से भेजा जाता है जिसमें शुल्क लिया गया था, इसलिए उस मोड की कुंजियाँ सेट होनी चाहिए: जब तक सैंडबॉक्स ऑर्डर रिफ़ंड करने की संभावना हो, सैंडबॉक्स कुंजियाँ रखें। यदि OpenPay रिफ़ंड स्वीकार नहीं करता, तो ब्लॉक त्रुटि दिखाता है, जैसे OpenPay refund failed: ..., और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड OpenPay रिफ़ंड ID के साथ रिफ़ंड इतिहास और नोट्स में जोड़ा जाता है। पूर्ण रिफ़ंड ऑर्डर को Refunded पर सेट करता है। आंशिक रिफ़ंड स्थिति नहीं बदलता। रिफ़ंड केवल तब उपलब्ध हैं जब OpenPay भुगतान की पुष्टि कर चुका हो; राशि मेल न खाने के बाद OpenPay payment on hold में रखा गया ऑर्डर मॉड्यूल के माध्यम से रिफ़ंड नहीं होता।

OpenPay Colombia, आधिकारिक OpenPay प्लगइन की तरह, API के माध्यम से कार्ड रिफ़ंड का समर्थन नहीं करता। कोलंबियाई शुल्कों के लिए ब्लॉक रिफ़ंड फ़ॉर्म नहीं देता; शुल्क को OpenPay डैशबोर्ड में रिफ़ंड करें।

मॉड्यूल क्रेडिट स्लिप नहीं बनाता। ऑर्डर पेज के मानक PrestaShop रिफ़ंड बटन OpenPay के ज़रिए पैसा वापस नहीं भेजते।

OpenPay डैशबोर्ड में किए गए रिफ़ंड और चार्जबैक वेबहुक से आते हैं और नोट्स में एक बार जोड़े जाते हैं। ऑर्डर स्थिति और क्रेडिट स्लिप अपने-आप नहीं बदलतीं। ज़रूरत हो तो उन्हें मैन्युअली अपडेट करें।

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

मॉड्यूल vibefox.net से ली गई VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox OpenPay Gateway नाम का लाइसेंस ब्लॉक Modules > Module Manager > VibeFox OpenPay Gateway > Configure पेज पर सेटिंग्स के ऊपर सबसे पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। इसके बाद ब्लॉक में कुंजी छिपी हुई दिखती है, स्थिति (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन), और बटन Check now स्थिति दोबारा जाँचने के लिए, Change key दूसरी कुंजी डालने के लिए और Remove key इस स्टोर से कुंजी हटाने के लिए। उनके नीचे पंक्ति Product: presta-payment-openpay और लिंक Manage licenses and domains in your account है, जो आपका vibefox.net खाता खोलता है। केवल मॉड्यूल की Configure अनुमति वाले कर्मचारी कुंजी बदल सकते हैं। ब्लॉक के पाठ बैक ऑफिस की भाषा के अनुसार दिखते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

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

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

सक्रिय कुंजी के बिना चेकआउट पर OpenPay ग्राहकों को नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। PrestaShop स्टोरफ़्रंट को पता नहीं होता कि आप बैक ऑफिस में लॉग इन हैं, इसलिए भुगतान विधि आपके लिए भी छिपी रहती है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, पर चेकआउट पर उसका परीक्षण नहीं कर सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं उनकी पुष्टि होती रहती है, और रिफ़ंड काम करते हैं।

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

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

चेकआउट पर OpenPay दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable / Disable चालू है, और वर्तमान मोड में तीनों कुंजियाँ हैं: सैंडबॉक्स मोड में सैंडबॉक्स कुंजियाँ, लाइव मोड में लाइव कुंजियाँ। जाँचें कि कार्ट की मुद्रा Account country द्वारा स्वीकार की जाती है (मेक्सिको: MXN, USD; कोलंबिया: COP, USD; पेरू: PEN, USD)। सेटिंग्स पेज इन हर मामले में चेतावनी दिखाता है। Payment > Preferences में जाँचें कि मॉड्यूल कार्ट की मुद्रा, ग्राहक के देश और ग्राहक समूह के लिए अनुमत है।

भुगतान हो गया, पर कोई ऑर्डर नहीं बना: ग्राहक 3D Secure पेज से वापस नहीं आया और वेबहुक काम नहीं कर रहा। जाँचें कि जिस मोड का आप उपयोग करते हैं उसके OpenPay डैशबोर्ड में वेबहुक URL ठीक वैसे ही जोड़ा गया है जैसे सेटिंग्स दिखाती हैं, और ऊपर सूचीबद्ध इवेंट्स के साथ। जाँचें कि जिस मोड में भुगतान हुआ था उसकी कुंजियाँ भरी हुई हैं: उनके बिना वेबहुक not configured का उत्तर देता है और OpenPay बाद में फिर प्रयास करता है। ऑर्डर तब भी बनता है जब ग्राहक स्टोर पर लौटता है या वही कार्ट दोबारा भुगतान करने की कोशिश करता है।

वेबहुक ignored (unknown order) का उत्तर देता है: शुल्क इस स्टोर ने नहीं बनाया, उदाहरण के लिए उसी OpenPay खाते पर किसी दूसरे स्टोर का शुल्क। कुछ नहीं बदला जाता।

वेबहुक verification failed का उत्तर देता है: शुल्क पढ़ने के लिए OpenPay API तक पहुँचा नहीं जा सका। OpenPay वेबहुक दोबारा भेजता है।

वेबहुक busy का उत्तर देता है: उसी समय कार्ट किसी दूसरे अनुरोध से अपडेट हो रहा था, या ऑर्डर नहीं बन सका (उदाहरण के लिए मॉड्यूल बंद है)। OpenPay वेबहुक दोबारा भेजता है। कारण देखने के लिए Debug log चालू करें।

ग्राहक को The secure card form could not be loaded दिखता है: OpenPay का openpay.js या धोखाधड़ी-रोधी लाइब्रेरी ब्राउज़र में लोड नहीं हुई, या डिवाइस सेशन ID नहीं बन सका। ग्राहक से पेज रीलोड करके फिर कोशिश करने को कहें।

ग्राहक को The payment could not be processed right now दिखता है: OpenPay ने अनुरोध अस्वीकार किया या जवाब नहीं दिया। कारण लॉग में है। गलत Merchant ID या निजी कुंजी एक सामान्य कारण है। यदि OpenPay ने जवाब नहीं दिया, तो ग्राहक के दोबारा भुगतान करने से पहले OpenPay डैशबोर्ड में शुल्क जाँचें।

ग्राहक को This test card cannot be used for real payments दिखता है: सैंडबॉक्स मोड बंद होने पर सैंडबॉक्स टेस्ट कार्ड का उपयोग किया गया।

भुगतान के बाद ऑर्डर OpenPay payment on hold में है: ब्लॉक में OpenPay notes पढ़ें (देखें ऑर्डर स्टेटस), फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

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

The order is being updated right now के साथ रिफ़ंड विफल होता है: कोई वेबहुक या दूसरा अनुरोध उसी समय ऑर्डर अपडेट कर रहा था। थोड़ी देर बाद फिर कोशिश करें।

अनइंस्टॉल

Modules > Module Manager पर जाएँ, VibeFox OpenPay Gateway के बगल वाला मेनू खोलें और Uninstall चुनें। इस मॉड्यूल की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। यदि Delete data on uninstall चालू है, तो गेटवे सेटिंग्स, सहेजा गया वेबहुक सत्यापन कोड और लॉग हट जाते हैं। यदि बंद है, तो बाद में दोबारा इंस्टॉल करने के लिए सभी सेटिंग्स रखी जाती हैं। OpenPay शुल्क और रिफ़ंड रिकॉर्ड तथा ऑर्डर स्टेटस Awaiting OpenPay payment और OpenPay payment on hold हमेशा रखे जाते हैं, ताकि पहले भुगतान किए गए ऑर्डर दोबारा इंस्टॉल करने के बाद भी रिफ़ंड किए जा सकें। मौजूदा ऑर्डर अपने भुगतान नोट्स और ट्रांज़ैक्शन ID रखते हैं।

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