VibeFox Worldline for PrestaShop — सहायता
आवश्यकताएँ
PrestaShop: 8.0 से 9.x।
PHP: 8.0 या बाद का संस्करण। मॉड्यूल पुराने PHP संस्करणों पर इंस्टॉल होने से इनकार करता है।
Worldline खाता: एक Worldline Direct (पहले Ingenico Direct) मर्चेंट खाता। टेस्ट और लाइव खाते अलग होते हैं और उनके क्रेडेंशियल भी अलग होते हैं। हर खाते के लिए आपको Merchant ID (आपका PSPID), एक API Key ID और उसकी Secret API Key, तथा एक वेबहुक कुंजी और उसका secret चाहिए। ये सभी Worldline Merchant Portal में बनाए जाते हैं (देखें कॉन्फ़िगरेशन)।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. बैक ऑफिस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।
2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox Worldline Gateway खोजकर Configure पर क्लिक करें।
3. अपनी VibeFox लाइसेंस कुंजी को Configure पेज के ऊपर वाले लाइसेंस ब्लॉक में License key में पेस्ट करें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।
4. टेस्ट क्रेडेंशियल दर्ज करें, Save पर क्लिक करें और फिर Test credentials पर।
5. टेस्ट खाते के Merchant Portal में वेबहुक URL जोड़ें और वेबहुक कुंजी व secret दर्ज करें (देखें कॉन्फ़िगरेशन)।
6. Enable/Disable चालू करें और एक टेस्ट भुगतान करें। फिर लाइव क्रेडेंशियल दर्ज करें, अपने लाइव खाते में वेबहुक सेटअप दोहराएँ, Live credentials पर क्लिक करें और Test Mode बंद करें।
इंस्टॉल होने पर मॉड्यूल दो ऑर्डर स्थितियाँ बनाता है: Awaiting Worldline capture और Worldline payment on hold। PrestaShop उस समय सक्रिय देशों के लिए एक नया भुगतान मॉड्यूल सक्षम करता है। Payment > Preferences में मुद्राएँ, देश और ग्राहक समूह जाँचें, और बाद में जोड़े गए देशों पर वहीं टिक लगाएँ।
कॉन्फ़िगरेशन
सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox Worldline Gateway > Configure। हर सेक्शन का अपना Save बटन होता है, जो पूरा पेज सहेजता है। फ़ील्ड्स के ऊपर, यदि वर्तमान मोड के क्रेडेंशियल (Merchant ID, API Key ID, Secret API Key) अधूरे हैं, तो पेज चेतावनी देता है, क्योंकि तब चेकआउट पर भुगतान विधि छिप जाती है। टेस्ट मोड चालू होने पर पेज Test mode is on (pre-production environment): no real money is charged. दिखाता है।
Worldline (Ingenico)
Enable/Disable: Enable Worldline Gateway भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखता है। यही नाम ऑर्डर में भी भुगतान विधि के रूप में सेव होता है। डिफ़ॉल्ट: Worldline। आवश्यक।
Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला टेक्स्ट। डिफ़ॉल्ट: Pay securely via Worldline.
Worldline Direct API
क्रेडेंशियल टेस्ट खाते और लाइव खाते के Worldline Merchant Portal से लें। आपका PSPID ही Merchant ID है। Developer > Payment API में API Key ID और Secret API Key बनते हैं, और Developer > Webhooks में वेबहुक कुंजी और secret। इस सेक्शन में दोनों पोर्टल और Worldline दस्तावेज़ीकरण के लिंक हैं।
Test Mode: API एंडपॉइंट और क्रेडेंशियल दोनों बदलता है। टेस्ट मोड प्री-प्रोडक्शन एनवायरनमेंट और टेस्ट क्रेडेंशियल का उपयोग करता है, जबकि लाइव मोड प्रोडक्शन एनवायरनमेंट और लाइव क्रेडेंशियल का। डिफ़ॉल्ट: चालू। वास्तविक भुगतान लेने के लिए इसे बंद करें। टेस्ट मोड चालू होने पर ग्राहक भुगतान विधि के नीचे Test mode — no real money is charged. देखते हैं।
टेस्ट खाता (प्री-प्रोडक्शन)
Test Merchant ID (PSPID): आपके टेस्ट खाते का PSPID।
Test API Key ID: टेस्ट खाते की Developer > Payment API में बनाई गई API Key ID।
Test Secret API Key: उस API Key ID से संबंधित Secret API Key।
Test Webhook Key ID: वैकल्पिक। सेट होने पर केवल इसी कुंजी से भेजे गए वेबहुक स्वीकार होते हैं।
Test Webhook Secret: टेस्ट खाते का वेबहुक secret। हर वेबहुक के हस्ताक्षर की जाँच के लिए इसका उपयोग होता है।
लाइव खाता (प्रोडक्शन)
Live Merchant ID (PSPID): आपके लाइव खाते का PSPID।
Live API Key ID: लाइव खाते की Developer > Payment API में बनाई गई API Key ID।
Live Secret API Key: उस API Key ID से संबंधित Secret API Key।
Live Webhook Key ID: वैकल्पिक। सेट होने पर केवल इसी कुंजी से भेजे गए वेबहुक स्वीकार होते हैं।
Live Webhook Secret: लाइव खाते का वेबहुक secret।
सेव किए गए secret keys और वेबहुक secret फिर कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल तभी नया मान दर्ज करें जब उसे बदलना हो।
Clear saved secrets: किसी secret पर टिक लगाएँ और उसे हटाने के लिए Save पर क्लिक करें। खाली फ़ील्ड सेव किए गए मान को बनाए रखता है।
Check credentials: Test credentials और Live credentials बटन Worldline पर एक टेस्ट कॉल के जरिए हर खाते के सेव किए गए क्रेडेंशियल की जाँच करते हैं। पहले अपने बदलाव सेव करें। परिणाम पेज के ऊपर दिखता है, उदाहरण के लिए Test credentials: connection successful., API credentials are not configured., या Worldline से मिली त्रुटि।
वेबहुक
वेबहुक आपके स्टोर को भुगतानों के बारे में सूचित करता है, भले ही ग्राहक स्टोर पर वापस न आए, जैसे ब्राउज़र बंद करने पर, या जब कोई भुगतान बाद में पुष्ट हो। Merchant Portal में टेस्ट खाते का Developer > Webhooks खोलें और इस सेक्शन में Endpoint URL के नीचे दिखाया गया URL जोड़ें। फ़्रेंडली URL के साथ यह कुछ ऐसा दिखता है: https://your-shop/module/wcp_worldline_gateway/webhook, संभवतः /en/ जैसे भाषा कोड के साथ। URL को ठीक वैसे ही कॉपी करें जैसे सेटिंग्स में दिखता है: उसे बिना रीडायरेक्ट के जवाब देना होगा। फिर वेबहुक कुंजी ID और secret को Test Webhook Key ID और Test Webhook Secret में दर्ज करें। लाइव खाते में भी लाइव फ़ील्ड के साथ यही करें।
मॉड्यूल Worldline के एंडपॉइंट सत्यापन अनुरोध का अपने-आप जवाब देता है। यह भुगतान इवेंट (भुगतान स्थिति में बदलाव) और रिफ़ंड इवेंट (रिफ़ंड स्थिति में बदलाव) संभालता है। अन्य इवेंट स्वीकार किए जाते हैं और अनदेखे कर दिए जाते हैं। वैध हस्ताक्षर के बिना वेबहुक अस्वीकार होते हैं। किसी इवेंट पर उस खाते के secret से हस्ताक्षर होना चाहिए जिसमें भुगतान हुआ था, इसलिए टेस्ट वेबहुक कभी लाइव भुगतान की पुष्टि नहीं करता। जो वेबहुक किसी ऐसे Merchant ID से आता है जो उस खाते का नहीं है जिसके secret से वह हस्ताक्षरित है, उसे भी अनदेखा किया जाता है। वेबहुक के बिना, ऑर्डर तभी बनता है जब ग्राहक भुगतान के बाद स्टोर पर लौटता है।
भुगतान पेज और ऑर्डर
Payment page template: Merchant Portal में अपलोड किए गए होस्टेड भुगतान पेज टेम्पलेट (वेरिएंट) का वैकल्पिक नाम, उदाहरण के लिए SimplifiedCustomPaymentPage। डिफ़ॉल्ट Worldline पेज के लिए इसे खाली छोड़ें।
Order Status After Payment: Worldline के कैप्चर किए गए भुगतान की पुष्टि के बाद ऑर्डर की स्थिति। भुगतान हमेशा सीधी बिक्री (अधिकृति और कैप्चर) के रूप में माँगे जाते हैं।
अधिकृत भुगतान Awaiting Worldline capture में प्रतीक्षा करते हैं। राशि या मुद्रा का मेल न खाना हमेशा Worldline payment on hold में जाता है।
एडवांस्ड
Logging: सभी API अनुरोध और वेबहुक मॉड्यूल फ़ोल्डर में logs/wlg_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खुल सकती। त्रुटियाँ और चेतावनियाँ इस विकल्प के बंद होने पर भी हमेशा लॉग होती हैं। कुंजियाँ, कार्ड डेटा और व्यक्तिगत डेटा मास्क होते हैं। डिफ़ॉल्ट: बंद।
Log: लॉग का आकार और नवीनतम एंट्री दिखाता है। खाली करने के लिए Clear log पर क्लिक करें।
Delete Data: चालू होने पर मॉड्यूल हटाने से मॉड्यूल की सेटिंग्स और लॉग हट जाते हैं। Worldline के लेन-देन और रिफ़ंड तथा मॉड्यूल की ऑर्डर स्थितियाँ हमेशा रहती हैं, क्योंकि मौजूदा ऑर्डर को रिफ़ंड के लिए उनकी ज़रूरत होती है। डिफ़ॉल्ट: बंद।
चेकआउट
भुगतान के चरण में ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Worldline) और पुष्टि करता है। मॉड्यूल कार्ट की राशि के लिए कार्ट की मुद्रा में एक Worldline होस्टेड भुगतान पेज बनाता है और ग्राहक को Worldline भुगतान पेज पर भेजता है। वहाँ ग्राहक कार्ड, वॉलेट या आपके Worldline खाते में सक्षम किसी अन्य भुगतान विधि से भुगतान करता है। बिलिंग नाम, पता, ईमेल और फ़ोन Worldline को भेजे जाते हैं, और जब Worldline समर्थन करता है तो भुगतान पेज ग्राहक की भाषा में खुलता है। हर भुगतान प्रयास को कार्ट ID और एक यादृच्छिक हिस्से से बना अपना संदर्भ मिलता है। इस समय तक कोई ऑर्डर मौजूद नहीं होता।
भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। मॉड्यूल वापसी को सहेजे गए प्रयास से मिलाता है और सर्वर पर Worldline से भुगतान की स्थिति पढ़ता है। ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब Worldline उसकी पुष्टि कर दे: इस स्टेटस जाँच से या हस्ताक्षरित वेबहुक से। फिर ऑर्डर बनता है और ग्राहक को Your payment with Worldline has been received. वाला मानक ऑर्डर पुष्टि पेज दिखता है। यदि भुगतान अधिकृत है पर अभी कैप्चर नहीं हुआ, तो पेज पर Your payment is authorized. The order is confirmed as soon as Worldline confirms the capture. दिखता है। यदि ऐसे ऑर्डर का भुगतान बाद में विफल हो जाए, तो पेज पर Your Worldline payment was not completed. Please contact us about this order. दिखता है।
यदि भुगतान पूरा नहीं हुआ, तो कोई ऑर्डर नहीं बनता, कार्ट रहता है, और ग्राहक इस संदेश के साथ चेकआउट पर लौट आता है:
यदि स्थिति अभी जाँची नहीं जा सकी, तो Payment confirmation पेज पर We could not confirm your payment yet. If you completed the payment, please do not pay again — you will receive a confirmation as soon as Worldline confirms it. दिखता है, साथ में Check again और Back to checkout बटन होते हैं। वेबहुक आते ही ऑर्डर बना देता है।
जब ग्राहक वही कार्ट फिर से भुगतान करता है, तो मॉड्यूल पहले पिछले प्रयास की जाँच करता है। यदि वह इस बीच भुगतान हो चुका है, तो ग्राहक सीधे ऑर्डर पुष्टि पर जाता है और उससे दोबारा शुल्क नहीं लिया जाता। यदि पिछला भुगतान पेज उसी राशि और मोड के लिए अभी भी खुला है और 30 मिनट से कम पहले बना था, तो ग्राहक को उसी पर वापस भेजा जाता है।
यदि Worldline भुगतान शुरू नहीं कर पाता, तो ग्राहक Payment error: Could not create checkout session. Please try again. के साथ चेकआउट पर ही रहता है। कारण लॉग में लिखा जाता है। यदि वर्तमान मोड के क्रेडेंशियल गायब हैं, तो ग्राहक को This payment method is not available at the moment. Please choose another payment method. दिखता है।
वेबहुक तब भी काम करता है जब स्टोर मेंटेनेंस मोड में हो, और आपके स्टोर की देश-सीमा से अवरुद्ध नहीं होता।
मॉड्यूल Worldline पेज पर एकमुश्त भुगतान को सीधी बिक्री के रूप में लेता है। इसमें सेव किए गए कार्ड या टोकनाइज़ेशन, सब्सक्रिप्शन, एम्बेडेड कार्ड फ़ॉर्म, PrestaShop से कैप्चर या रद्द करने वाला केवल-अधिकृत मोड, सरचार्ज या स्वचालित वेबहुक पंजीकरण नहीं है।
ऑर्डर और रिफ़ंड
ऑर्डर स्थितियाँ
No order yet: ग्राहक को Worldline पर भेजा गया और उसने भुगतान नहीं किया, या Worldline ने अभी भुगतान की पुष्टि नहीं की है। केवल कार्ट मौजूद है।
Payment accepted or Delivered: भुगतान कैप्चर हो गया है। स्थिति Order Status After Payment के अनुसार होती है। भुगतान को Worldline भुगतान ID के साथ लेन-देन ID के रूप में दर्ज किया जाता है, और एक नोट में राशि, भुगतान ID और पुष्टि का तरीका (हस्ताक्षरित वेबहुक या स्टेटस जाँच) दिखता है।
Awaiting Worldline capture: Worldline भुगतान को अधिकृत या कैप्चर का अनुरोध किया हुआ बताता है, पर वह अभी कैप्चर नहीं हुआ है। अभी कोई भुगतान दर्ज नहीं हुआ है। जब वेबहुक कैप्चर की पुष्टि करता है, तो ऑर्डर भुगतान किए हुए स्टेटस में चला जाता है। यदि नोट कहता है कि भुगतान कैप्चर नहीं हुआ है, तो उसे Worldline Merchant Portal में कैप्चर करें।
Worldline payment on hold: भुगतान कार्ट से मेल नहीं खाता, उदाहरण के लिए राशि या मुद्रा अलग है (भुगतान शुरू होने के बाद कार्ट बदला गया), या भुगतान किसी दूसरे प्रयास का है। नोट में भुगतान की गई राशि, ऑर्डर का कुल और संदर्भ दिखता है। ऑर्डर की जाँच करें और उसे पूरा करें, या भुगतान रिफ़ंड करें।
Payment error: Worldline ने कैप्चर की प्रतीक्षा कर रहे ऑर्डर का भुगतान अस्वीकार या रद्द किया।
Refunded: भुगतान मॉड्यूल के ज़रिए पूरी तरह रिफ़ंड किया गया।
यदि रद्द किए गए या रिफ़ंड किए गए ऑर्डर के लिए भुगतान आता है, तो ऑर्डर दोबारा नहीं खुलता। एक नोट आपसे Worldline Merchant Portal में भुगतान रिफ़ंड या रद्द करने, या ऑर्डर को मैन्युअली बहाल करने के लिए कहता है। लौटने वाले ग्राहक को Your payment was received after this order had been cancelled. Please contact us — we will restore the order or refund the payment. दिखता है। यदि पहले से भुगतान किए गए ऑर्डर के लिए दूसरा भुगतान आता है, तो ऑर्डर नहीं बदलता। एक नोट आपसे Worldline Merchant Portal में दूसरा भुगतान रिफ़ंड करने के लिए कहता है।
Worldline भुगतान ब्लॉक
ऑर्डर पेज पर Worldline payment ब्लॉक दिखता है, जिसमें भुगतान ID, मर्चेंट संदर्भ, होस्टेड भुगतान पेज, प्रयास की स्थिति, वसूली गई राशि और रिफ़ंड की गई राशि, परीक्षण भुगतानों के लिए Test environment बैज, रिफ़ंड इतिहास और ऑर्डर के Payment notes शामिल हैं।
रिफ़ंड
Worldline payment ब्लॉक में राशि दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है, वह पहले से भरी होती है), वैकल्पिक रूप से कारण लिखें, और Refund via Worldline पर क्लिक करें। Refund this amount through Worldline? This cannot be undone. प्रश्न की पुष्टि करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। भुगतान कैप्चर हुआ होना चाहिए। आपको ऑर्डर संपादित करने का अधिकार चाहिए; मॉड्यूल पेज की पहुँच ज़रूरी नहीं है। रिफ़ंड उस राशि और मुद्रा में होते हैं जो Worldline ने वसूली है, इसलिए राशि या मुद्रा के मेल न खाने के बाद आप ऑर्डर के कुल तक नहीं, बल्कि ग्राहक द्वारा वास्तव में भुगतान की गई राशि तक रिफ़ंड कर सकते हैं। रिफ़ंड हमेशा मूल भुगतान के वातावरण (टेस्ट या लाइव) में उस खाते के क्रेडेंशियल के साथ भेजा जाता है, इसलिए वे सेट होने चाहिए। टाइमआउट के बाद दोबारा प्रयास किया गया रिफ़ंड दो बार नहीं चलता, और एक ऑर्डर का केवल एक रिफ़ंड एक समय में चलता है। यदि Worldline रिफ़ंड से इनकार करता है, तो ब्लॉक त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। स्वीकृत रिफ़ंड, Worldline रिफ़ंड ID और स्थिति के साथ, रिफ़ंड इतिहास और नोट्स में जुड़ जाता है। पूर्ण रिफ़ंड ऑर्डर को Refunded पर सेट करता है। आंशिक रिफ़ंड स्थिति नहीं बदलता।
मॉड्यूल क्रेडिट स्लिप नहीं बनाता। ऑर्डर पेज के PrestaShop के मानक रिफ़ंड बटन Worldline के ज़रिए पैसे वापस नहीं भेजते।
Worldline से रिफ़ंड स्थिति में बदलाव वेबहुक से आते हैं, रिफ़ंड इतिहास अपडेट करते हैं और नोट्स में जुड़ते हैं। Merchant Portal में किए गए रिफ़ंड ऑर्डर की स्थिति नहीं बदलते और क्रेडिट स्लिप नहीं बनाते। ज़रूरत हो तो उन्हें मैन्युअली अपडेट करें।
लाइसेंस कुंजी
मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox Worldline Gateway लाइसेंस ब्लॉक, Modules > Module Manager > VibeFox Worldline Gateway > Configure पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में पेस्ट करें और Activate पर क्लिक करें। इसके बाद ब्लॉक में कुंजी मास्क की हुई दिखती है, स्टेटस (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन), और बटन Check now (स्टेटस दोबारा जाँचने के लिए), Change key (दूसरी कुंजी डालने के लिए) और Remove key (इस स्टोर से कुंजी हटाने के लिए) दिखते हैं। उनके नीचे Product: presta-payment-worldline वाली पंक्ति और 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 खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना, चेकआउट पर ग्राहकों को Worldline नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू किया जाता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। PrestaShop स्टोरफ़्रंट को पता नहीं होता कि आप बैक ऑफिस में लॉग इन हैं, इसलिए भुगतान तरीका आपसे भी छिपा रहता है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, पर चेकआउट पर उसकी जाँच नहीं कर सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं उनकी पुष्टि होती रहती है, और रिफ़ंड चलते रहते हैं।
लाइसेंस समाप्त होने पर मॉड्यूल चलता रहता है, पर अपडेट और सपोर्ट के लिए नवीनीकरण ज़रूरी है। बैक ऑफिस में काम करते समय स्टेटस अपने आप दोबारा जाँचा जाता है: कुंजी डालने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हर हफ़्ते एक बार। कोई cron job नहीं चाहिए। मॉड्यूल को अनइंस्टॉल या रीसेट करने पर लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हट जाते हैं।
समस्या निवारण
चेकआउट पर Worldline दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और वर्तमान मोड में Merchant ID, API Key ID और Secret API Key हैं: टेस्ट मोड में टेस्ट फ़ील्ड, लाइव मोड में लाइव फ़ील्ड। वे गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है। Payment > Preferences में जाँचें कि मॉड्यूल कार्ट की मुद्रा, ग्राहक के देश और ग्राहक के समूह के लिए अनुमत है।
भुगतान हो गया, पर कोई ऑर्डर नहीं बना: वेबहुक काम नहीं कर रहा। जिस खाते (टेस्ट या लाइव) का आप उपयोग करते हैं, उसके Merchant Portal में जाँचें कि एंडपॉइंट मौजूद है और उसका URL ठीक वही है जो Endpoint URL में दिखता है, बिना रीडायरेक्ट के। जाँचें कि उस खाते का वेबहुक secret सही फ़ील्ड में है (Test Webhook Secret या Live Webhook Secret) और वेबहुक कुंजी ID फ़ील्ड खाली है या कुंजी से मेल खाता है। ग्राहक के भुगतान के बाद स्टोर पर लौटने पर भी ऑर्डर बनता है।
वेबहुक Webhook secret not configured का जवाब देता है: कोई वेबहुक secret सेट नहीं है। सेटिंग्स में वेबहुक secret दर्ज करें। Worldline वेबहुक को फिर से भेजेगा।
वेबहुक Invalid signature का जवाब देता है: वेबहुक secret किसी दूसरे खाते या दूसरी कुंजी का है, या वेबहुक कुंजी ID उस कुंजी से मेल नहीं खाता जिससे वेबहुक भेजा गया था। जाँचें कि टेस्ट और लाइव secret आपस में बदले तो नहीं गए हैं।
वेबहुक Missing signature, Empty body या Invalid JSON का जवाब देता है: अनुरोध अपेक्षित रूप में Worldline से नहीं आया, या किसी प्रॉक्सी या रीडायरेक्ट ने उसे बदल दिया। जाँचें कि URL बिना रीडायरेक्ट के जवाब देता है।
वेबहुक Ignored का जवाब देता है: वेबहुक उस मोड की सेटिंग्स के Merchant ID से भिन्न Merchant ID से आया। Test Merchant ID (PSPID) या Live Merchant ID (PSPID) जाँचें।
वेबहुक Retry later का जवाब देता है: ऑर्डर उसी समय किसी दूसरे अनुरोध से पुष्ट हो रहा था, या ऑर्डर नहीं बन सका (उदाहरण के लिए मॉड्यूल बंद है)। Worldline वेबहुक को फिर से भेजेगा। कारण के लिए Log फ़ील्ड देखें।
ब्राउज़र में वेबहुक URL Method not allowed दिखाता है: यह सामान्य है। यह URL केवल Worldline के अनुरोध स्वीकार करता है।
Test credentials या Live credentials में त्रुटि दिखती है: पहले सेटिंग्स सेव करें, फिर जाँचें कि Merchant ID, API Key ID और Secret API Key एक ही खाते के हैं और टेस्ट मान टेस्ट फ़ील्ड में व लाइव मान लाइव फ़ील्ड में हैं।
ग्राहक Worldline चुनते समय त्रुटि देखता है: मॉड्यूल पेज पर Log फ़ील्ड देखें। त्रुटियाँ Logging बंद होने पर भी लॉग होती हैं। अनुरोधों का पूरा विवरण देखने के लिए Logging चालू करें और फिर से प्रयास करें।
टेस्ट भुगतान लाइव भुगतान की पुष्टि नहीं करते: टेस्ट और लाइव अलग रखे जाते हैं। Test Mode को वांछित मोड पर बदलें और उस खाते के क्रेडेंशियल व वेबहुक का उपयोग करें।
भुगतान के बाद ऑर्डर Worldline payment on hold या Awaiting Worldline capture में है: Worldline payment ब्लॉक के नोट्स पढ़ें (देखें ऑर्डर स्थितियाँ)। या तो Worldline ने अभी कैप्चर की पुष्टि नहीं की है (वेबहुक ऑर्डर पूरा करता है), या भुगतान की गई राशि या मुद्रा कार्ट से अलग थी।
रिफ़ंड वातावरण से जुड़े संदेश के साथ विफल होता है: भुगतान टेस्ट या लाइव वातावरण में किया गया था, और उस वातावरण के क्रेडेंशियल सेट नहीं हैं। उन्हें दर्ज करें और फिर से प्रयास करें।
डेवलपर्स: हुक actionWlgHostedCheckoutData भेजे जाने से पहले होस्टेड भुगतान अनुरोध को बदलता है, उदाहरण के लिए दिखाई जाने वाली भुगतान विधियों को सीमित करने के लिए।
अनइंस्टॉल
Modules > Module Manager पर जाएँ, VibeFox Worldline Gateway के बगल वाला मेनू खोलें और Uninstall चुनें। इस मॉड्यूल की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटा दिए जाते हैं। यदि Delete Data चालू है, तो मॉड्यूल की सेटिंग्स और लॉग हट जाते हैं। यदि बंद है, तो बाद में फिर से इंस्टॉल करने के लिए सभी सेटिंग्स रखी जाती हैं। Worldline के लेन-देन और रिफ़ंड तथा ऑर्डर स्थितियाँ Awaiting Worldline capture और Worldline payment on hold हमेशा रखी जाती हैं, ताकि पहले भुगतान किए गए ऑर्डर फिर से इंस्टॉल करने के बाद भी रिफ़ंड किए जा सकें। मौजूदा ऑर्डर अपने भुगतान नोट्स और लेन-देन ID बनाए रखते हैं।
Worldline उसके संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल Worldline से संबद्ध नहीं है और न ही Worldline द्वारा समर्थित है।