VibeFox Peach Payments for OpenCart — सहायता

आवश्यकताएँ

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

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

मुद्रा: ग्राहक की चेकआउट मुद्रा ZAR, KES या MUR होनी चाहिए, इसलिए आपके स्टोर में System > Localisation > Currencies में इनमें से कम से कम एक मुद्रा होनी चाहिए। अन्य मुद्राओं में भुगतान करने वाले ग्राहकों के लिए भुगतान विधि छिपी रहती है। यदि स्टोर की डिफ़ॉल्ट मुद्रा इनमें से कोई नहीं है, तो सेटिंग्स पेज चेतावनी देता है।

Peach Payments खाता: आपको अपने Peach Payments खाते के Card API क्रेडेंशियल चाहिए: Entity ID और Access Token। परीक्षण क्रेडेंशियल Peach Payments के sandbox डैशबोर्ड से आते हैं, और लाइव क्रेडेंशियल Peach Payments डैशबोर्ड से; दोनों अलग होते हैं। वेबहुक के लिए आपको एक वेबहुक डिक्रिप्शन कुंजी भी चाहिए, जो Peach Payments आपके स्टोर के लिए Card वेबहुक सक्षम करने पर भेजता है (देखें कॉन्फ़िगरेशन)। वेबहुक प्राप्त करने के लिए आपका स्टोर इंटरनेट से पहुँच योग्य होना चाहिए।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. Peach Payments के sandbox डैशबोर्ड से परीक्षण Entity ID और Access Token दर्ज करें, और सेटिंग्स पेज पर दिखाए गए वेबहुक URL के लिए Peach Payments से Card वेबहुक सक्षम करने का अनुरोध करें (देखें कॉन्फ़िगरेशन)।

5. Enable/Disable चालू करें और Save पर क्लिक करें। Test mode चालू रखें और ZAR, KES या MUR में Peach Payments के sandbox टेस्ट कार्ड से एक भुगतान करें। फिर Test mode बंद करें, लाइव क्रेडेंशियल और लाइव वेबहुक कुंजी दर्ज करें, और Save पर क्लिक करें।

OpenCart 4

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

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

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

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

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

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

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

सेव करते समय Title खाली नहीं हो सकता और 128 अक्षरों से लंबा नहीं हो सकता (पेज Enter a title for the payment method (up to 128 characters). दिखाता है), Sort Order पूर्ण संख्या होनी चाहिए (ऋणात्मक मान स्वीकार हैं), Total 0 या उससे बड़ी संख्या होनी चाहिए, और जियो ज़ोन तथा ऑर्डर स्टेटस मौजूद होने चाहिए। अन्यथा कुछ भी सेव नहीं होता। क्रेडेंशियल से स्पेस हटा दिए जाते हैं। 64 अंकों के हेक्साडेसिमल मान के अलावा कोई वेबहुक कुंजी, या खाली कार्ड ब्रांड सूची, चेतावनी के साथ सेव होती है।

Peach Payments

Enable/Disable: Enable Peach Payments से भुगतान विधि चालू या बंद होती है। डिफ़ॉल्ट: बंद।

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

Description: Confirm Order चरण में पुष्टि बटन के ऊपर, कार्ड आइकन के साथ ग्राहक को दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely with your card. You will enter the card details in the Peach Payments form on the next page.

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

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

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

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

Card API का Access Token और Entity ID Peach Payments डैशबोर्ड में दिखाए जाते हैं (परीक्षण क्रेडेंशियल sandbox डैशबोर्ड में होते हैं)। यह सेक्शन दोनों डैशबोर्ड और Peach Payments के डेवलपर दस्तावेज़ के लिंक देता है।

Test mode: नए भुगतान परीक्षण क्रेडेंशियल के साथ Peach Payments sandbox में भेजता है, और कोई असली राशि नहीं काटी जाती। लाइव क्रेडेंशियल के साथ असली भुगतान स्वीकार करने के लिए इसे बंद करें। किसी एक मोड में शुरू हुआ भुगतान, मोड बदलने के बाद भी हमेशा उसी मोड में जाँचा जाता है। डिफ़ॉल्ट: चालू। चालू रहने पर ग्राहक को Confirm Order चरण में Test mode: no real payment will be made. दिखता है।

Test Entity ID: आपके sandbox खाते का Entity ID (3-D Secure चैनल)।

Test Access Token: आपके sandbox खाते का bearer access token।

Test Webhook Decryption Key: sandbox के Card वेबहुक को डिक्रिप्ट करने के लिए उपयोग होने वाली 64 अक्षरों की हेक्साडेसिमल कुंजी।

Live Entity ID: आपके लाइव खाते का Entity ID (3-D Secure चैनल)।

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

Live Webhook Decryption Key: आपके लाइव खाते के Card वेबहुक को डिक्रिप्ट करने के लिए उपयोग होने वाली 64 अक्षरों की हेक्साडेसिमल कुंजी।

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

वेबहुक

वेबहुक भुगतान की पुष्टि तब भी करते हैं जब ग्राहक स्टोर पर लौटने से पहले ब्राउज़र बंद कर दे। Webhook URL फ़ील्ड आपके स्टोर का वेबहुक URL दिखाता है। OpenCart 3 में यह https://your-store/index.php?route=extension/payment/wcp_peach_pay/webhook जैसा दिखता है, और OpenCart 4 में https://your-store/index.php?route=extension/wcp_peach_pay/payment/wcp_peach_pay.webhook जैसा। यह आपके OpenCart इंस्टॉलेशन के storefront पते से बनता है। URL को ठीक वैसा ही कॉपी करें जैसा सेटिंग्स दिखाती हैं। इस URL के साथ अपने खाते के लिए Card वेबहुक सक्षम करने के लिए Peach Payments (support@peachpayments.com) से अनुरोध करें, फिर जो डिक्रिप्शन कुंजी मिले उसे उसी मोड के Webhook Decryption Key फ़ील्ड में दर्ज करें।

Peach Payments हर वेबहुक को एन्क्रिप्ट करता है (AES-256-GCM)। जो वेबहुक परीक्षण या लाइव कुंजी से डिक्रिप्ट नहीं हो सकता, वह अस्वीकार होता है, इसलिए आपके ऑर्डर केवल Peach Payments बदल सकता है। किसी एक मोड की कुंजी से डिक्रिप्ट हुआ वेबहुक केवल उसी मोड में शुरू हुए भुगतानों पर लागू होता है। एक्सटेंशन ये भुगतान सूचनाएँ उपयोग करता है:

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

भुगतान फ़ॉर्म

Card brands: Peach Payments फ़ॉर्म में दिखाए गए ब्रांड: Visa, Mastercard, American Express, Diners Club। केवल वे ब्रांड चुनें जो आपके Entity ID के लिए सक्षम हैं। डिफ़ॉल्ट: Visa और Mastercard। यदि कोई ब्रांड नहीं चुना गया, तो सेव करने पर चेतावनी दिखती है और फ़ॉर्म में Visa और Mastercard दिखते हैं।

ऑर्डर

ऑर्डर Confirm Order चरण में बिना स्टेटस के (एक लापता ऑर्डर) बनता है, और स्टेटस केवल तब मिलता है जब Peach Payments भुगतान की पुष्टि कर दे। अस्वीकृत या छोड़ा गया भुगतान ऑर्डर को बिना स्टेटस के छोड़ता है, और कार्ट सुरक्षित रहता है। नीचे का हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस की सूची दिखाता है।

Order Status After Payment: तब सेट होता है जब Peach Payments भुगतान की पुष्टि करे और राशि तथा मुद्रा मेल खाएँ। डिफ़ॉल्ट: Processing।

Awaiting Payment Status: Peach Payments ने एक असिंक्रोनस भुगतान की सूचना दी जो पुष्टि की प्रतीक्षा में है; वेबहुक इसे बाद में पुष्ट करता है। डिफ़ॉल्ट: Pending, क्योंकि OpenCart में On hold स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।

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

Payment Failed Status: तब सेट होता है जब वह असिंक्रोनस भुगतान अस्वीकृत हो जिसकी ऑर्डर प्रतीक्षा कर रहा था। इसके बाद का सफल भुगतान फिर भी ऑर्डर पूरा करता है। डिफ़ॉल्ट: Failed।

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

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

उन्नत

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

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

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

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

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

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

चेकआउट

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

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Peach Payments उसकी पुष्टि करे: स्टोर इस ऑर्डर के चेकआउट का परिणाम उसी मोड में Peach Payments API से पढ़ता है जिसमें चेकआउट बना था, और जाँचता है कि भुगतान इसी ऑर्डर का है। वेबहुक भी स्वतंत्र रूप से यही करता है; जो पहले पहुँचे वह ऑर्डर स्टेटस सेट करता है, और दूसरा कुछ नहीं बदलता। उसके बाद ऑर्डर को OpenCart के सामान्य तरीके से स्टेटस मिलता है, सामान्य ऑर्डर ईमेल भेजे जाते हैं और स्टॉक अपडेट होता है, और ग्राहक OpenCart का ऑर्डर सफलता पेज देखता है। OpenCart 4 पर, जब ग्राहक बैंक के 3-D Secure पेज से लौटता है, तो एक छोटा मध्यवर्ती पेज आपके स्टोर का वापसी पता फिर से खोलता है, ताकि कार्ट और ग्राहक का लॉगिन बना रहे।

यदि भुगतान पूरा नहीं होता, तो ग्राहक एक संदेश के साथ चेकआउट पर लौटता है और फिर से प्रयास कर सकता है: Payment failed: के बाद Peach Payments का कारण, और Please try again or use another card., या The payment was not completed. Please try again. कार्ट सुरक्षित रहता है। यदि परिणाम अभी पुष्ट नहीं हो सकता (उदाहरण के लिए, Peach Payments ने उत्तर नहीं दिया, या वेबहुक उसी समय उसी कार्ट को संसाधित कर रहा है), तो संदेश है: We could not confirm your payment yet. If you were charged, the order will be updated automatically; otherwise please try again. जब भुगतान के मोड के लिए कोई वेबहुक कुंजी सेट नहीं है, तो ग्राहक से इसके बजाय आपसे संपर्क करने को कहा जाता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखते हैं।

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

OpenCart 4 में ऑर्डर सफलता पेज दिखाए जाने तक चेकआउट में रखा जाता है। अस्वीकृत प्रयास के बाद ग्राहक नए Peach Payments चेकआउट के साथ उसी ऑर्डर का फिर से भुगतान करता है। यदि वह ऑर्डर इस बीच बंद हो गया (उदाहरण के लिए उसका लंबित भुगतान विफल हुआ, या आपने उसे रद्द किया), तो ग्राहक Your previous order is already closed or paid. Please confirm the order again: the cart will be paid with a new order. के साथ चेकआउट पर लौट जाता है, और अगला Confirm Order एक नए ऑर्डर का भुगतान करता है। यदि ऑर्डर का भुगतान हो चुका था और आपने उसे बाद में रद्द या रिफ़ंड किया, तो संदेश This order was cancelled or refunded by the store. Please contact the store about its payment, or confirm the order again: the cart will be paid with a new order. होता है।

यदि भुगतान फ़ॉर्म तैयार नहीं हो पाता, तो ग्राहक Confirm Order चरण पर एक संक्षिप्त संदेश के साथ रहता है: The payment form is not available right now (payment configuration error). Please contact us or choose another payment method. (क्रेडेंशियल गायब या गलत होने पर), एक संदेश कि कुछ बिलिंग विवरण भुगतान प्रदाता ने स्वीकार नहीं किए, या The payment form could not be loaded. Please try again in a moment. तकनीकी कारण लॉग में लिखा जाता है।

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

एक्सटेंशन में चेकआउट चरण पर स्वयं कोई कार्ड फ़ॉर्म नहीं है, न सेव किए गए कार्ड, न सब्सक्रिप्शन, न प्री-ऑथॉराइज़ेशन और बाद में कैप्चर, और न EFT, BNPL, QR या अन्य गैर-कार्ड विधियाँ।

ऑर्डर

ऑर्डर स्टेटस

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

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

Awaiting Payment Status (default Pending): Peach Payments ने एक भुगतान की सूचना दी जो पुष्टि की प्रतीक्षा में है। वेबहुक बाद में ऑर्डर को Order Status After Payment या Payment Failed Status पर ले जाता है।

On Hold (Review) Status (default Pending): भुगतान की गई राशि या मुद्रा ऑर्डर से मेल नहीं खाती (नोट amount/currency mismatch — manual review required), या ऑर्डर रद्द होने के बाद भुगतान आया। Peach Payments डैशबोर्ड में भुगतान जाँचें, फिर ऑर्डर प्रोसेस करें या भुगतान रिफ़ंड करें।

Payment Failed Status (default Failed): Peach Payments ने वह भुगतान अस्वीकृत किया जिसका लंबित ऑर्डर इंतज़ार कर रहा था। अस्वीकृत प्रयास कभी भुगतान किए हुए या समीक्षा में चल रहे ऑर्डर को नहीं बदलता।

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

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

VibeFox Peach Payments Pay Gateway टैब

Sales > Orders में Peach Payments से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, एक्सटेंशन का टैब Payment ID दिखाता है (परीक्षण भुगतानों के लिए Test mode लेबल के साथ), साथ में Checkout ID, Merchant transaction ID, Amount sent to Peach Payments, परिणाम कोड के साथ Result, और ऑर्डर के Peach Payments notes। यह टैब उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन की पहुँच है।

रिफ़ंड

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

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

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

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

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

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

Peach Payments चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड के Entity ID और Access Token दर्ज हैं (test mode में Test Entity ID और Test Access Token, live mode में Live Entity ID और Live Access Token), और ग्राहक ZAR, KES या MUR में भुगतान करता है। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है, और ऑर्डर सेटिंग्स के Total तक पहुँचता है। सेटिंग्स के ऊपर की सूचनाएँ समस्या बताती हैं।

भुगतान हो गया, पर ऑर्डर बिना स्टेटस के है: ग्राहक स्टोर पर नहीं लौटा और वेबहुक नहीं आया। जाँचें कि Peach Payments ने सेटिंग्स में दिखाए गए URL के लिए ही Card वेबहुक सक्षम किए हैं, जिस मोड में भुगतान हुआ उसकी Webhook Decryption Key दर्ज है, और कोई फ़ायरवॉल या पासवर्ड सुरक्षा URL को नहीं रोक रही। Logging चालू करें और अस्वीकृत वेबहुक के लिए Log फ़ील्ड देखें।

वेबहुक Decryption failed उत्तर देता है: वेबहुक परीक्षण या लाइव कुंजी से डिक्रिप्ट नहीं हो सका। कुंजी गलत है या किसी दूसरे खाते या मोड की है। इस वेबहुक URL के लिए Peach Payments द्वारा भेजी गई कुंजी दर्ज करें।

वेबहुक Webhook key not configured उत्तर देता है: कोई वेबहुक कुंजी सेट नहीं है या वैध नहीं है। 64 अक्षरों की कुंजी दर्ज करें। Peach Payments बाद में वेबहुक दोबारा भेजेगा।

वेबहुक Busy, retry later उत्तर देता है: ग्राहक की वापसी से उसी समय कार्ट संसाधित हो रहा था। कुछ नहीं बदला, और Peach Payments वेबहुक दोबारा भेजेगा। लॉग कारण दिखाता है।

वेबहुक Missing or malformed data उत्तर देता है: अनुरोध में एन्क्रिप्टेड बॉडी या X-Initialization-Vector / X-Authentication-Tag हेडर नहीं थे, उदाहरण के लिए किसी proxy ने उन्हें बदल दिया। कुछ नहीं बदला।

वेबहुक ignored उत्तर देता है: सूचना प्रामाणिक है, पर यह इस स्टोर के किसी चेकआउट से संबंधित नहीं है (उसी Entity ID वाला कोई दूसरा स्टोर), या यह भुगतान से अलग मोड से आई। कुछ नहीं बदला।

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

ग्राहक को The payment form is not available right now दिखता है: वर्तमान मोड का Access Token या Entity ID गलत है। क्रेडेंशियल और मोड जाँचें, और Peach Payments कोड के लिए लॉग पढ़ें।

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

भुगतान के बाद ऑर्डर समीक्षा स्टेटस में है: एक्सटेंशन टैब के नोट पढ़ें। भुगतान की गई राशि या मुद्रा ऑर्डर से अलग थी, या ऑर्डर रद्द होने के बाद भुगतान आया। Peach Payments डैशबोर्ड में भुगतान जाँचें, फिर ऑर्डर प्रोसेस करें या भुगतान रिफ़ंड करें।

सेव करते समय संदेश दिखता है कि वेबहुक कुंजी 64 अक्षरों की हेक्साडेसिमल कुंजी होनी चाहिए: दिया गया मान Peach Payments की कुंजी नहीं है। सही होने तक वेबहुक डिक्रिप्ट नहीं हो सकते।

अनइंस्टॉल

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

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

Peach Payments उसके संबंधित स्वामी का ट्रेडमार्क है। यह एक्सटेंशन Peach Payments से संबद्ध नहीं है और Peach Payments द्वारा समर्थित नहीं है।