VibeFox Cardcom for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

HTTPS: आपकी साइट इंटरनेट से HTTPS पर पहुँच योग्य होनी चाहिए, ताकि Cardcom भुगतान की सूचना भेज सके।

मुद्रा: ऑर्डर की मुद्रा ILS, USD, EUR या GBP होनी चाहिए। किसी अन्य मुद्रा के लिए चेकआउट पर भुगतान विधि छिपी रहती है।

Cardcom खाता: लाइव भुगतानों के लिए आपको Cardcom मर्चेंट खाता चाहिए, जिसमें टर्मिनल नंबर, API username और API password हों। भुगतानों के लिए केवल टर्मिनल नंबर और API username चाहिए। API password केवल WooCommerce से रिफ़ंड के लिए उपयोग होता है। टेस्ट मोड Cardcom खाते के बिना काम करता है।

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

इंस्टॉलेशन

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

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

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

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

5. Enable/Disable चालू करें, Test Mode चालू रहने दें और कार्ड 4580 0000 0000 0000, भविष्य की कोई भी एक्सपायरी तिथि, CVV 123 से एक टेस्ट ऑर्डर दें।

6. असली भुगतानों के लिए Test Mode का निशान हटाएँ और Cardcom से मिले Terminal Number, API Username और API Password दर्ज करें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Cardcom। फ़ील्ड के ऊपर, जब टेस्ट मोड चालू होता है, पेज Test mode is on. दिखाता है। लाइव मोड में, यदि टर्मिनल नंबर या API username गायब हो, तो पेज चेतावनी देता है (तब Cardcom चेकआउट पर छिपा रहता है), और याद दिलाता है कि API password के बिना WooCommerce से रिफ़ंड संभव नहीं हैं। स्टोर की मुद्रा समर्थित न होने पर भी यह चेतावनी देता है। लाइव मोड को बिना टर्मिनल नंबर या API username के सहेजने पर त्रुटि संदेश बताता है कि इन्हें भरे जाने तक गेटवे चेकआउट पर छिपा रहेगा।

सामान्य

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

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

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely with your credit card via Cardcom।

टेस्ट मोड

टेस्ट मोड सार्वजनिक Cardcom टेस्ट टर्मिनल 1000 (API user CardTest1994) का उपयोग करता है। कोई असली पैसा नहीं लिया जाता और Cardcom खाते की ज़रूरत नहीं होती। टेस्ट कार्ड: 4580 0000 0000 0000, भविष्य की कोई भी एक्सपायरी तिथि, CVV 123। टेस्ट मोड में चेकआउट पर इस टेस्ट कार्ड का संकेत भी दिखता है।

Test Mode: Enable test mode (terminal 1000, no real money)। डिफ़ॉल्ट: on। असली भुगतान स्वीकार करने के लिए इसका निशान हटाएँ; तब नीचे दिए लाइव क्रेडेंशियल उपयोग होंगे। रिफ़ंड हमेशा उसी मोड के क्रेडेंशियल से भेजे जाते हैं जिसमें ऑर्डर का भुगतान हुआ था।

लाइव क्रेडेंशियल

Terminal Number, API username और API password आपको आपके मर्चेंट खाते के साथ Cardcom देता है: Cardcom डैशबोर्ड में API settings के अंतर्गत, या Cardcom सहायता से। ये फ़ील्ड केवल लाइव मोड में उपयोग होते हैं।

Terminal Number: आपका Cardcom टर्मिनल नंबर। इसमें केवल अंक होने चाहिए। कुछ और दर्ज करने पर त्रुटि दिखती है और पिछला मान रहता है।

API Username: इस टर्मिनल के लिए आपका Cardcom API username (ApiName)। सहेजते समय स्पेस हटा दिए जाते हैं।

API Password: आपका Cardcom API password। यह केवल WooCommerce से रिफ़ंड के लिए चाहिए और जैसा टाइप किया जाता है, वैसा ही सहेजा जाता है।

भुगतान पेज

Cardcom भुगतान की सूचनाएँ (IndicatorUrl) इस सेक्शन में दिखाए गए पते पर भेजता है। यह ऐसा दिखता है: https://your-site/wc-api/cardcom_p_callback/। यह पता हर भुगतान के साथ ऑर्डर ID सहित अपने-आप Cardcom को भेजा जाता है, इसलिए Cardcom में कुछ सेट करने की ज़रूरत नहीं है। यह इंटरनेट से पहुँच योग्य होना चाहिए।

Operation: Cardcom भुगतान पेज पर क्या करता है।

Max Installments: Cardcom पेज पर ग्राहक जितनी अधिकतम किस्तें (भुगतान) चुन सकता है, 1 से 36 तक। 1 का अर्थ है कोई किस्त नहीं। डिफ़ॉल्ट: 1।

Success Order Status: पुष्ट भुगतान के बाद ऑर्डर की स्थिति। स्थिति एक ही बार में सेट होती है, दूसरे स्थिति-बदलाव के बिना।

उन्नत

Debug log: Log API requests and notifications को WooCommerce > Status > Logs में, source wcp_cardcom_payment_gateway के साथ लिखता है। त्रुटियाँ हमेशा लॉग होती हैं। क्रेडेंशियल, कार्ड टोकन और कार्डधारक का विवरण कभी नहीं लिखा जाता। डिफ़ॉल्ट: off।

Delete on Uninstall: Delete all plugin data when uninstalling। चालू होने पर प्लगइन हटाने से सेटिंग्स, ऑर्डरों पर संग्रहीत Cardcom डेटा और लॉग स्थायी रूप से हट जाते हैं। ऑर्डर स्वयं बने रहते हैं। डिफ़ॉल्ट: off।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit Card (Cardcom)) और ऑर्डर देता है। प्लगइन ऑर्डर की कुल राशि के लिए ऑर्डर की मुद्रा में Cardcom भुगतान पेज बनाता है और ग्राहक को वहाँ भेजता है। साइट की भाषा हिब्रू होने पर पेज हिब्रू में खुलता है, अन्यथा अंग्रेज़ी में। ऑर्डर के आइटम उत्पाद के नाम के रूप में Cardcom को भेजे जाते हैं। ग्राहक कार्ड का विवरण दर्ज करता है और, यदि किस्तें अनुमत हैं, तो भुगतानों की संख्या चुनता है।

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

यदि भुगतान पूरा नहीं होता, तो Cardcom ग्राहक को चेकआउट (या Pay for order पेज) पर वापस भेजता है, जहाँ The card payment was not completed. Please try again or choose a different payment method. दिखता है। Cardcom द्वारा पुष्ट अस्वीकृत भुगतान ऑर्डर को Failed बना देता है। ग्राहक ऐसे ऑर्डर का भुगतान दोबारा कर सकता है जिसका भुगतान अभी नहीं हुआ है, उदाहरण के लिए Pay for order पेज से। उसी ऑर्डर के पुराने भुगतान पेज पर किया गया भुगतान अब भी पहचाना जाता है। यदि ग्राहक ने दूसरी भुगतान विधि चुनी, लेकिन Cardcom पेज पर भुगतान किया, तो भुगतान दर्ज होता है और भुगतान विधि वापस Cardcom पर सेट हो जाती है।

यदि Cardcom भुगतान पेज नहीं खोल पाता, तो ग्राहक को एक छोटा संदेश दिखता है, उदाहरण के लिए Could not connect to Cardcom. Please try again in a moment. या यह कि Cardcom भुगतान पेज नहीं खोल पाया, साथ में Cardcom कोड। ग्राहक दूसरी भुगतान विधि चुन सकता है।

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

प्लगइन कार्ड भुगतान केवल Cardcom पेज पर लेता है। इसमें सेव किए गए कार्ड या वन-क्लिक भुगतान नहीं हैं, सब्सक्रिप्शन नहीं हैं, संग्रहीत टोकन पर शुल्क नहीं लिया जाता, Cardcom इनवॉइस या रसीद सेटिंग्स नहीं हैं, Cardcom के माध्यम से Bit, Apple Pay, Google Pay या PayPal नहीं हैं, iframe मोड नहीं है और बाद में कैप्चर होने वाले सौदे नहीं हैं। छोड़े गए भुगतान पेज अपने-आप नहीं जाँचे जाते।

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

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

Pending payment: ग्राहक को Cardcom पर भेजा गया है और उसने अभी भुगतान नहीं किया है, या Cardcom ने अभी भुगतान की पुष्टि नहीं की है।

Processing, Completed या On Hold: भुगतान की पुष्टि हुई। स्थिति Success Order Status का अनुसरण करती है। ऑर्डर नोट में Cardcom लेन-देन दिखता है, और जब Cardcom इन्हें भेजता है, तो कार्ड के अंतिम चार अंक, इनवॉइस नंबर और किस्तों की संख्या। टेस्ट भुगतान Test mode — no real money was charged. के रूप में चिह्नित होते हैं। ऑर्डर का लेन-देन ID Cardcom डील नंबर है।

On hold after payment: Cardcom ने ऐसे भुगतान की पुष्टि की जो ऑर्डर से मेल नहीं खाता, उदाहरण के लिए भुगतान पेज खुलने के बाद ऑर्डर की कुल राशि बदल दी गई, या कोई अलग राशि या मुद्रा चार्ज हुई। ऑर्डर नोट इसे समझाता है। Cardcom डैशबोर्ड में भुगतान की ऑर्डर से तुलना करें, फिर ऑर्डर पूरा करें या भुगतान का रिफ़ंड करें।

Failed: Cardcom ने भुगतान अस्वीकार किया। ऑर्डर नोट में Cardcom का रिस्पॉन्स कोड दिखता है। पुराने भुगतान पेज की अस्वीकृति नए प्रयास को Failed नहीं बनाती, और देर से आई अस्वीकृति भुगतान किए गए ऑर्डर को कभी नहीं बदलती।

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

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via Credit Card (Cardcom) पर क्लिक करें (बटन पर भुगतान विधि का शीर्षक दिखता है)। पूर्ण और आंशिक रिफ़ंड समर्थित हैं, और एक ही ऑर्डर पर कई आंशिक रिफ़ंड किए जा सकते हैं। रिफ़ंड उसी मोड के क्रेडेंशियल से भेजा जाता है जिसमें ऑर्डर का भुगतान हुआ था: टेस्ट ऑर्डर का रिफ़ंड लाइव मोड पर स्विच करने के बाद भी Cardcom टेस्ट टर्मिनल पर होता है, और लाइव ऑर्डर हमेशा आपके लाइव क्रेडेंशियल उपयोग करते हैं। लाइव रिफ़ंड के लिए API Username और API Password चाहिए। यदि Cardcom रिफ़ंड स्वीकार नहीं करता, तो WooCommerce त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड Cardcom रिफ़ंड लेन-देन और कारण के साथ ऑर्डर नोट में जुड़ता है।

Cardcom डैशबोर्ड में किए गए रिफ़ंड स्टोर को वापस रिपोर्ट नहीं होते। ज़रूरत हो तो WooCommerce में, गेटवे के Refund via के बिना, मैनुअल रिफ़ंड बनाएँ।

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

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

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

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

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

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

Cardcom चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और ऑर्डर की मुद्रा ILS, USD, EUR या GBP है। लाइव मोड में जाँचें कि Terminal Number और API Username भरे हैं। कुछ गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है।

भुगतान हो गया, पर ऑर्डर Pending payment पर रहता है: Cardcom आपकी साइट तक नहीं पहुँच पाया, उदाहरण के लिए मेंटेनेंस मोड, फ़ायरवॉल, पासवर्ड सुरक्षा या लोकल डेवलपमेंट साइट के कारण। सूचना का पता इंटरनेट से HTTPS पर पहुँच योग्य होना चाहिए। ग्राहक के ऑर्डर प्राप्त पेज पर लौटने पर भी ऑर्डर की पुष्टि होती है। Debug log चालू करें और WooCommerce > Status > Logs में source wcp_cardcom_payment_gateway देखें।

Notification answers Missing or invalid lowprofilecode or Unknown lowprofilecode for this order: कॉल में इस ऑर्डर के लिए आपके स्टोर द्वारा जारी किया गया भुगतान पेज कोड नहीं था। ऑर्डर नहीं बदला जाता।

Notification answers Gateway not configured or Indicator check failed: जिस मोड में भुगतान पेज बना था, उसके क्रेडेंशियल गायब हैं, या जाँच के लिए Cardcom तक पहुँच नहीं हो पाई। ऑर्डर नहीं बदला जाता, और ग्राहक के स्टोर पर लौटने पर उसकी दोबारा जाँच होती है।

Notification answers ReturnValue mismatch or Terminal mismatch: Cardcom ने किसी दूसरे ऑर्डर या दूसरे टर्मिनल के भुगतान की सूचना दी। ऑर्डर नहीं बदला जाता। जाँचें कि Terminal Number आपके खाते का टर्मिनल है।

Payment error: this currency is not supported by Cardcom.: ग्राहक को यह संदेश दिखता है। ऑर्डर की मुद्रा ILS, USD, EUR या GBP नहीं है।

Card payment is temporarily unavailable. Please choose another payment method.: ग्राहक को यह संदेश दिखता है। लाइव मोड चालू है, लेकिन टर्मिनल नंबर या API username गायब है।

ऑर्डर देते समय ग्राहक को त्रुटि दिखती है: ऑर्डर नोट खोलें, या Debug log चालू करके लॉग देखें। कनेक्शन की समस्याएँ और Cardcom के त्रुटि कोड वहाँ लिखे जाते हैं।

Order is On hold after payment: ऑर्डर नोट पढ़ें। चुकाई गई राशि या मुद्रा ऑर्डर से मेल नहीं खाई। ऑर्डर पूरा करें या भुगतान का रिफ़ंड करें।

Refund fails with API username and API password are required for refunds: सेटिंग्स में API Password (और API Username) दर्ज करें और दोबारा कोशिश करें।

Refund fails with Could not connect to Cardcom: दोबारा कोशिश करने से पहले Cardcom डैशबोर्ड देखें, क्योंकि रिफ़ंड हुआ हो भी सकता है और नहीं भी।

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

डेवलपर्स के लिए: readme फ़ाइल में फ़िल्टर cardcom_p_supported_currencies दिया गया है, जो मुद्राओं की सूची बढ़ाता है (केवल वे मुद्राएँ जोड़ें जो आपके Cardcom टर्मिनल पर सक्षम हैं)।

अनइंस्टॉल

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

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