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

आवश्यकताएँ

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

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

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

Currency: स्टोर की मुद्रा ZAR, KES या MUR होनी चाहिए। दूसरी मुद्राओं में भुगतान विधि छिप जाती है और सेटिंग पेज पर इसकी सूचना मिलती है।

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

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

स्थापना

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

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

3. सेटिंग खोलें: WooCommerce > Settings > Payments > Peach Payments > Manage, या प्लगइन पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।

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

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

6. Enable/Disable चालू करके सेव करें। Test mode चालू रखें और Peach Payments सैंडबॉक्स टेस्ट कार्ड से भुगतान करें। फिर Test mode का चयन हटाएँ, लाइव क्रेडेंशियल और लाइव वेबहुक कुंजी दर्ज करके सेव करें।

अपडेट के बाद संस्करण 1.0 की सेटिंग अपने-आप नए फ़ील्ड में चली जाती हैं।

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

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

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

Title: चेकआउट पर ग्राहक को दिखने वाला भुगतान विधि का नाम। डिफ़ॉल्ट: Credit / Debit Card (Peach Payments)।

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely with your card. You will enter the card details in the Peach Payments form on the next page.

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

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

Test mode: Enable test mode टेस्ट क्रेडेंशियल के साथ नए भुगतान Peach Payments सैंडबॉक्स में भेजता है और वास्तविक धन नहीं लिया जाता। लाइव क्रेडेंशियल से वास्तविक भुगतान लेने के लिए चयन हटाएँ। एक मोड में शुरू भुगतान हमेशा उसी मोड में जाँचा जाता है, भले ही बाद में मोड बदलें। डिफ़ॉल्ट: चालू।

Test Entity ID: आपके सैंडबॉक्स खाते का Entity ID (3-D Secure चैनल)।

Test Access Token: आपके सैंडबॉक्स खाते का bearer एक्सेस टोकन।

Test Webhook Decryption Key: सैंडबॉक्स के Card वेबहुक डिक्रिप्ट करने की 64-अक्षर वाली हेक्साडेसिमल कुंजी।

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

Live Access Token: आपके लाइव खाते का bearer एक्सेस टोकन।

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

वेबहुक

ग्राहक के स्टोर में लौटने से पहले ब्राउज़र बंद कर देने पर भी वेबहुक भुगतान की पुष्टि करते हैं। यह खंड आपके स्टोर का वेबहुक URL दिखाता है, जो https://your-site/wp-json/peach-pay/v1/webhook जैसा होता है। उसे सेटिंग में दिखे अनुसार हूबहू कॉपी करें। Peach Payments (support@peachpayments.com) से इस URL के साथ खाते के Card वेबहुक सक्षम करने को कहें, फिर मिली डिक्रिप्शन कुंजी उसी मोड के Webhook Decryption Key फ़ील्ड में दर्ज करें।

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

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

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

Card brands: Peach Payments फ़ॉर्म में दिखने वाले ब्रांड: Visa, Mastercard, American Express, Diners Club। केवल अपने Entity ID के लिए सक्षम ब्रांड चुनें। डिफ़ॉल्ट: Visa और Mastercard।

उन्नत

Logging: Log API requests and payment results डिबग जानकारी WooCommerce > Status > Logs में, स्रोत wcp_peach_pay के अंतर्गत लिखता है। त्रुटियाँ और चेतावनियाँ हमेशा लॉग होती हैं। लॉग में कार्ड डेटा, कुंजियाँ या ग्राहक डेटा नहीं होता। डिफ़ॉल्ट: बंद।

Delete data on uninstall: Delete the plugin settings and logs when the plugin is deleted। प्लगइन निष्क्रिय करने से कभी कुछ नहीं मिटता। ऑर्डर में सहेजा Peach Payments डेटा बना रहता है। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान विधि (डिफ़ॉल्ट Credit / Debit Card (Peach Payments)) चुनकर Continue to payment पर क्लिक करता है। वह आपके स्टोर के Pay for order पेज पर पहुँचता है। वहाँ प्लगइन ऑर्डर की कुल राशि और मुद्रा में Peach Payments चेकआउट तैयार करता है और चुने ब्रांड का Peach Payments कार्ड फ़ॉर्म दिखाता है; Peach Payments समर्थन दे तो साइट की भाषा में। टेस्ट मोड में पेज पर Test mode: use a Peach Payments test card, no real payment will be made. दिखता है। कार्ड विवरण Peach Payments फ़ॉर्म में दर्ज होता है और स्क्रिप्ट Subresource Integrity हैश के साथ लोड होती है।

भुगतान के बाद ग्राहक स्टोर में लौटता है। Peach Payments की पुष्टि के बाद ही ऑर्डर भुगतान किया हुआ चिह्नित होता है: स्टोर Peach Payments API से इस ऑर्डर के चेकआउट का परिणाम उसके निर्माण वाले मोड में पढ़ता है और जाँचता है कि भुगतान इसी ऑर्डर का है। वेबहुक स्वतंत्र रूप से यही करता है; जो पहले पहुँचे वह परिणाम लागू करता है और दूसरा कुछ नहीं बदलता। भुगतान कर चुके ग्राहक को Order received पेज दिखता है।

भुगतान पूरा न हो तो ग्राहक संदेश के साथ Pay for order पेज पर लौटकर फिर कोशिश कर सकता है: 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. होता है। मोड के लिए वेबहुक कुंजी न हो तो ग्राहक से इसके बजाय ऑर्डर नंबर के साथ आपसे संपर्क करने को कहा जाता है।

फ़ॉर्म तैयार न हो तो ग्राहक को छोटा संदेश और Try again बटन दिखता है: 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.। ऑर्डर में Peach Payments कोड और विवरण का नोट जुड़ता है।

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

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

ऑर्डर

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

Pending payment: ग्राहक ने अभी भुगतान नहीं किया या भुगतान पूरा नहीं हुआ। वह उसी ऑर्डर का फिर भुगतान कर सकता है।

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

On hold: भुगतान Peach Payments की पुष्टि की प्रतीक्षा में है (वेबहुक बाद में पूरा करता है या विफल चिह्नित करता है); भुगतान की राशि या मुद्रा अलग है (नोट amount/currency mismatch — manual review required); या भुगतान ऑर्डर रद्द होने के बाद पहुँचा। नोट बताता है कि क्या जाँचना है।

Failed: Peach Payments ने भुगतान लंबित ऑर्डर का भुगतान या होल्ड पर रखे ऑर्डर का प्रतीक्षित भुगतान अस्वीकार किया। अस्वीकृत प्रयास कभी भुगतान किए गए, अन्य कारण से होल्ड पर या रद्द ऑर्डर को नहीं बदलता। ग्राहक फिर भुगतान कर सकता है।

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

रिफ़ंड

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

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

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

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

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

लाइसेंस समाप्त होने पर प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में अपने-आप फिर जाँची जाती है।

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

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

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

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

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

वेबहुक का उत्तर Order busy, retry later है: उसी समय ग्राहक लौटने से ऑर्डर अपडेट हो रहा था। कुछ नहीं बदला और Peach Payments वेबहुक फिर भेजता है।

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

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

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

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

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

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

अनइंस्टॉल

निष्क्रिय करने से सभी डेटा बने रहते हैं। हटाने के लिए Plugins पेज पर निष्क्रिय करके मिटाएँ। इस प्लगइन की लाइसेंस कुंजी और स्थिति हमेशा हटती हैं। सेटिंग और लॉग (wcp_peach_pay स्रोत की लॉग फ़ाइलें और डेटाबेस लॉग प्रविष्टियाँ) केवल Delete data on uninstall चालू होने पर हटते हैं। अन्यथा दोबारा स्थापना के लिए बने रहते हैं। मौजूदा ऑर्डर के भुगतान नोट, लेन-देन ID और Peach Payments चेकआउट डेटा सुरक्षित रहते हैं।

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