VibeFox Pagar.me for OpenCart — सहायता

आवश्यकताएँ

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

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

Currency: ब्राज़ीलियाई रियल (BRL)। स्टोर में BRL मुद्रा होनी चाहिए (System > Localisation > Currencies), और भुगतान विधि तभी दिखाई जाती है जब ग्राहक BRL में चेकआउट करता है और ऑर्डर का कुल योग शून्य से अधिक है।

Pagar.me account: आपको अपने Pagar.me खाते की सीक्रेट कुंजियाँ चाहिए: टेस्ट कुंजी (sk_test_...) और लाइव पर जाने के लिए लाइव कुंजी (sk_...)। ये Pagar.me डैशबोर्ड में Development > Keys के अंतर्गत मिलती हैं। केवल सीक्रेट कुंजियाँ उपयोग होती हैं; पब्लिक कुंजी (pk_...) की आवश्यकता नहीं है। केवल वे भुगतान विधियाँ दी जा सकती हैं जो आपके Pagar.me खाते में सक्षम हैं।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. टेस्ट सीक्रेट कुंजी दर्ज करें और लाइव होने पर लाइव सीक्रेट कुंजी दर्ज करें।

5. Pagar.me डैशबोर्ड में सेटिंग्स में दिखाए गए URL के साथ वेबहुक बनाएँ (देखें कॉन्फ़िगरेशन)।

6. Enable / Disable चालू करें और Save पर क्लिक करें। Test mode चालू रखकर टेस्ट भुगतान करें, फिर वास्तविक भुगतान लेने के लिए इसे बंद करें।

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Pagar.me Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरे पेज को सहेजता है। सेटिंग्स के ऊपर पेज वर्तमान मोड दिखाता है: TEST MODE (भुगतान टेस्ट सीक्रेट कुंजी से बनाए जाते हैं, कोई वास्तविक शुल्क नहीं लगता) या LIVE। यह चेतावनी देता है जब वर्तमान मोड की सीक्रेट कुंजी गायब हो (तब भुगतान विधि चेकआउट पर छिपी रहती है), जब टेस्ट कुंजी sk_test_ से शुरू न हो, जब लाइव कुंजी sk_ से शुरू न हो या टेस्ट कुंजी हो, और जब स्टोर की डिफ़ॉल्ट मुद्रा BRL न हो। एक्सटेंशन बदलने के अधिकार के बिना पेज सेटिंग्स दिखाता है, लेकिन उन्हें सहेज नहीं सकता।

सहेजते समय Title खाली नहीं हो सकता (128 अक्षरों तक), Boleto due in (days) 1 से 30 के बीच की पूर्ण संख्या होनी चाहिए, Sort Order पूर्ण संख्या होनी चाहिए (ऋणात्मक संख्याएँ अनुमत हैं), Total 0 या उससे अधिक की संख्या होनी चाहिए, और जियो ज़ोन तथा ऑर्डर स्टेटस मौजूद होने चाहिए। यदि कोई मान गलत है, तो एक त्रुटि उसका नाम बताती है और कुछ भी सहेजा नहीं जाता।

Pagar.me

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

Title: भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। यह ऑर्डर में सहेजा गया भुगतान विधि का नाम भी है। डिफ़ॉल्ट: Pagar.me। अनिवार्य, 128 अक्षरों तक।

Description: वह पाठ जो ग्राहक को Confirm Order चरण में, पुष्टि बटन के ऊपर दिखाई देता है। डिफ़ॉल्ट: Pagar.me के माध्यम से सुरक्षित रूप से भुगतान करें (क्रेडिट कार्ड, PIX या boleto)। अपना भुगतान पूरा करने के लिए आपको रीडायरेक्ट किया जाएगा।

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

Geo Zone: Pagar.me केवल चुने हुए जियो ज़ोन के भुगतान पते के लिए दें। डिफ़ॉल्ट: All zones। जियो ज़ोन System > Localisation > Geo Zones में सेट होते हैं। OpenCart 4 पर, जब स्टोर भुगतान पता नहीं माँगता, तो शिपिंग पता उपयोग होता है।

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

API कुंजियाँ

Pagar.me डैशबोर्ड से सीक्रेट कुंजियाँ कॉपी करें (इस सेक्शन में उसका लिंक है): Development > Keys। Pagar.me टेस्ट और लाइव भुगतानों के लिए एक ही API पता उपयोग करता है; कुंजी तय करती है कि भुगतान टेस्ट है या वास्तविक।

Test mode: टेस्ट सीक्रेट कुंजी का उपयोग करता है, कोई वास्तविक शुल्क नहीं। चालू होने पर ग्राहकों को Confirm Order चरण पर TEST MODE — Use test credentials. No real charges. दिखाई देता है। किसी ऑर्डर की स्टेटस जाँच और रिफ़ंड हमेशा उसी मोड की कुंजी का उपयोग करते हैं जिसमें उसका भुगतान बनाया गया था। डिफ़ॉल्ट: चालू।

Test secret key: Pagar.me की टेस्ट सीक्रेट कुंजी (sk_test_...)। टेस्ट मोड चालू होने पर उपयोग होती है।

Live secret key: Pagar.me की लाइव सीक्रेट कुंजी (sk_...)। टेस्ट मोड बंद होने पर उपयोग होती है। इसे गोपनीय रखें।

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

भुगतान पेज

Pagar.me भुगतान पेज पर दिए गए तरीके, प्रत्येक के अपने स्विच के साथ। केवल वही तरीके चुनें जो आपके Pagar.me खाते में सक्षम हों। यदि कोई नहीं चुना गया, तो क्रेडिट कार्ड, PIX और boleto दिए जाते हैं। डिफ़ॉल्ट: क्रेडिट कार्ड, PIX और Boleto।

Boleto due in (days): boleto की देय तिथि तक दिनों की संख्या, 1 से 30। डिफ़ॉल्ट: 3। कोई अन्य मान सहेजते समय Boleto due in (days): enter a number from 1 to 30. के साथ अस्वीकार किया जाता है।

भुगतान सूचनाएँ (वेबहुक)

Pagar.me डैशबोर्ड में Settings > Webhooks खोलें और इस सेक्शन में Webhook URL के अंतर्गत दिखाए गए URL के साथ वेबहुक बनाएँ। OpenCart 3 पर यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_pagarme_gateway/webhook, OpenCart 4 पर: https://your-store/index.php?route=extension/wcp_pagarme_gateway/payment/wcp_pagarme_gateway.webhook। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। इसे सेटिंग्स में दिखाए अनुसार ठीक-ठीक कॉपी करें। URL इंटरनेट से पहुँचने योग्य होना चाहिए।

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

वेबहुक को किसी पासवर्ड या हस्ताक्षर की आवश्यकता नहीं है। इसकी सामग्री पर कभी भरोसा नहीं किया जाता: स्टोर उससे केवल Pagar.me ऑर्डर ID लेता है और उस ऑर्डर को, जिस मोड में वह बनाया गया था उसकी कुंजी से, Pagar.me API से पढ़ता है। ऐसे Pagar.me ऑर्डरों की सूचनाएँ अनदेखी की जाती हैं जो इस स्टोर द्वारा नहीं बनाए गए थे। वेबहुक के बिना, बाद में किए गए PIX और boleto भुगतानों की पुष्टि तभी होती है जब ग्राहक स्टोर पर लौटता है।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना किसी स्टेटस के बनाता है (एक लापता ऑर्डर, missing order)। ऑर्डर को तभी स्टेटस मिलता है जब Pagar.me वेबहुक के द्वारा या ग्राहक के लौटने पर भुगतान की सूचना देता है; Pagar.me ऑर्डर हमेशा API से दोबारा पढ़ा जाता है। नीचे का प्रत्येक फ़ील्ड आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध करता है।

Order Status After Payment: किसी सत्यापित Pagar.me भुगतान के बाद सेट किया गया स्टेटस। डिफ़ॉल्ट: प्रोसेसिंग।

Awaiting Pagar.me Payment Status: PIX कोड या boleto जारी हुआ, या कार्ड भुगतान विश्लेषण में है; Pagar.me बाद में राशि की पुष्टि करता है। डिफ़ॉल्ट: लंबित।

Pagar.me Payment On Hold Status: भुगतान को आपकी समीक्षा चाहिए (देखें ऑर्डर स्टेटस)। डिफ़ॉल्ट: लंबित, क्योंकि OpenCart में होल्ड स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।

Payment Failed Status: प्रतीक्षारत ऑर्डर का भुगतान विफल हुआ, रद्द हुआ या उसकी समय सीमा समाप्त हो गई। यदि Pagar.me बाद में उसे भुगतान किया हुआ बताता है, तो ऑर्डर को भुगतान के बाद का स्टेटस मिलता है। डिफ़ॉल्ट: विफल।

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

Refunded Status: ऑर्डर पेज से या Pagar.me डैशबोर्ड में भुगतान की पूरी राशि लौटाए जाने के बाद सेट होता है। डिफ़ॉल्ट: रिफ़ंड किया गया।

उन्नत

Debug log: API अनुरोध और सूचनाएँ OpenCart के लॉग फ़ोल्डर (storage/logs) में wc_pgm_debug.log.php में लिखता है। फ़ाइल वेब से नहीं खोली जा सकती। त्रुटियाँ और चेतावनियाँ हमेशा लॉग होती हैं। कुंजियाँ और ग्राहक डेटा (ईमेल, फ़ोन, CPF) लॉग नहीं किए जाते। डिफ़ॉल्ट: बंद।

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

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

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

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

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Pagar.me)। Confirm Order चरण पर ग्राहक को आपका विवरण और यह नोट दिखाई देता है: You will be redirected to the Pagar.me payment page to pay by credit card, PIX, boleto or debit card. OpenCart इस चरण पर ऑर्डर बनाता है, जो अभी भी बिना स्टेटस के होता है। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर कुल राशि के लिए BRL में एक Pagar.me ऑर्डर बनाता है और ग्राहक को Pagar.me भुगतान पेज पर भेजता है। कर, शिपिंग और अन्य अधिभार वाली ऑर्डर पंक्तियाँ आइटम के रूप में भेजी जाती हैं; जब ऑर्डर में छूट (कूपन, वाउचर, रिवार्ड पॉइंट) हो या पंक्तियाँ कुल राशि से मेल न खाएँ, तो ऑर्डर नंबर के साथ एक पंक्ति Order # कुल राशि के लिए भेजी जाती है। एक मान्य ईमेल आवश्यक है।

ग्राहक का नाम और ईमेल Pagar.me को दिए जाते हैं। CPF या CNPJ (11 या 14 अंक) ग्राहक या भुगतान पते के उस कस्टम फ़ील्ड से लिया जाता है जिसके नाम में CPF या CNPJ हो; OpenCart में डिफ़ॉल्ट रूप से ऐसा कोई फ़ील्ड नहीं होता, इसलिए यदि आप इसे भेजना चाहते हैं तो इसे Customers > Custom Fields में जोड़ें। OpenCart 4 पर, जब स्टोर भुगतान पता नहीं माँगता, तो शिपिंग पता और उसके कस्टम फ़ील्ड उपयोग होते हैं। एक ब्राज़ीलियाई मोबाइल नंबर भी भेजा जाता है। बिलिंग पता केवल ऐसे ब्राज़ीलियाई पते के लिए भेजा जाता है जिसमें 8 अंकों का CEP और राज्य हो। CPF या CNPJ न होने पर ग्राहक उसे Pagar.me पेज पर दर्ज करता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब Pagar.me पुष्टि करे: स्टोर Pagar.me ऑर्डर को API से पढ़ता है, और भुगतान की गई राशि व मुद्रा ऑर्डर से मेल खानी चाहिए। फिर ऑर्डर को सामान्य OpenCart तरीके से स्टेटस मिलता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखाई देता है। जारी किया गया लेकिन अभी तक न चुकाया गया PIX या boleto ऑर्डर को प्रतीक्षा स्थिति में डालता है, और पेज पर Your Pagar.me payment is awaiting confirmation (PIX / boleto). The order will be confirmed as soon as Pagar.me reports the payment. भी दिखता है। समीक्षा स्थिति वाले ऑर्डर के लिए We are confirming your payment with Pagar.me. The order will be updated automatically — please do not pay again. दिखाया जाता है। बाद की हर वापसी पर Pagar.me ऑर्डर फिर से पढ़ा जाता है, इसलिए वेबहुक न आने पर भी इस बीच चुकाया गया PIX या boleto लागू हो जाता है।

यदि ग्राहक बिना भुगतान किए लौटता है, तो वह The Pagar.me payment was not completed. You can try again or choose another payment method. के साथ चेकआउट पर वापस आ जाता है। यदि भुगतान अस्वीकार किया गया या रद्द किया गया, तो संदेश The Pagar.me payment was declined or canceled. You can try again or choose another payment method. होता है। कार्ट सुरक्षित रहता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखते हैं। यदि ऑर्डर का पहले से कोई स्टेटस है और उसका भुगतान विफल या समाप्त हो गया है, तो संदेश The Pagar.me payment of your order was declined, canceled or has expired. Please place a new order or contact us. होता है। यदि कार्ट पहले से खाली है (उदाहरण के लिए, PIX या boleto की समय सीमा समाप्त होने से पहले ऑर्डर सफलता पेज तक पहुँच चुका था), तो चेकआउट पर चुकाने के लिए कुछ नहीं है: एक Payment confirmation पेज The Pagar.me payment of order #N was not completed (declined, canceled or expired), so the order will not be shipped. To buy these items, please place a new order. कहता है, साथ में Continue बटन होता है। यदि Pagar.me तक पहुँचा नहीं जा सका, तो एक Payment confirmation पेज ग्राहक से दोबारा भुगतान न करने को कहता है और Check again तथा Back to checkout देता है।

OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है। OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है, इसलिए अधूरे या अस्वीकृत भुगतान के बाद ग्राहक उसी ऑर्डर का दोबारा भुगतान करता है। नए भुगतान से पहले एक्सटेंशन उसी कार्ट के पिछले प्रयासों की जाँच करता है: यदि उनमें से कोई भुगतान किया हुआ है, या उसका PIX या boleto प्रतीक्षा में है, तो ग्राहक बिना नए भुगतान के सफलता पेज पर चला जाता है। उसी ऑर्डर का खुला Pagar.me भुगतान पेज तब पुनः उपयोग होता है जब राशि और मोड समान हों; अन्य खुले पेज पहले Pagar.me पर बंद किए जाते हैं। यदि उसी कार्ट का दूसरा Pagar.me ऑर्डर फिर भी भुगतान हो जाता है, तो उसे लागू नहीं किया जाता, और भुगतान किए गए ऑर्डर का एक नोट आपसे उस डुप्लिकेट का रिफ़ंड करने को कहता है।

OpenCart 4 ऑर्डर को तब तक चेकआउट में रखता है जब तक सफलता पेज नहीं दिखता। यदि वह ऑर्डर इस बीच बंद हो गया (उदाहरण के लिए उसका PIX या boleto समाप्त हो गया, उसका भुगतान विफल हुआ, या आपने उसे रद्द या रिफ़ंड किया), तो Confirm Order ग्राहक को Your previous order was cancelled or its payment failed. Please confirm the order again. संदेश के साथ चेकआउट पर वापस भेजा जाता है, या, यदि ऑर्डर बंद करने से पहले उसका भुगतान हो चुका था, तो This order was closed by the store, so it will not be shipped. Your cart is kept: confirm the order again to pay. संदेश के साथ। अगला Confirm Order एक नए ऑर्डर का भुगतान करता है। जब ग्राहक Pagar.me से उस ऑर्डर पर लौटता है जो भुगतान होने के बाद आपने बंद किया था, तो ग्राहक चेकआउट पर वही संदेश देखता है, या, यदि कार्ट पहले से खाली है, तो Order #(संख्या) was closed by the store, so it will not be shipped. To buy these items, please place a new order. वाला पेज देखता है। यदि चेकआउट के ऑर्डर की पहले से कोई स्थिति है और कार्ट में अब दूसरे उत्पाद या मात्राएँ हैं, तो ग्राहक को चेकआउट पर वापस भेजा जाता है, और नए कार्ट को एक नया ऑर्डर मिलता है।

यदि Pagar.me भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर एक संक्षिप्त संदेश के साथ रहता है, जैसे Could not connect to Pagar.me. Please try again in a moment., या अमान्य बिलिंग विवरण के बारे में Pagar.me का संदेश। तकनीकी कारण लॉग में लिखा जाता है।

स्टोर के मेंटेनेंस मोड में होने पर भी वेबहुक काम करता है: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को जाने देता है, और OpenCart 4 पर एक्सटेंशन एक स्टार्टअप क्रिया जोड़ता है, जो वेबहुक और Pagar.me से ग्राहक की वापसी को आगे जाने देती है।

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

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

ऑर्डर स्टेटस

No status (missing order): ग्राहक को Pagar.me पर भेजा गया था और उसने अभी तक भुगतान नहीं किया या PIX या boleto जारी नहीं हुआ, या भुगतान अस्वीकार हुआ। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो।

OpenCart 4 पर चेकआउट का न चुकाया गया ऑर्डर Voided स्थिति पा सकता है, जिसे OpenCart 4 तब सेट करता है जब ग्राहक Confirm Order चरण पर लौटता है। एक्सटेंशन ऐसे ऑर्डर को बिना स्थिति वाला ऑर्डर मानता है, और बाद का भुगतान फिर भी उसकी पुष्टि करता है।

Order Status After Payment (default Processing): भुगतान की पुष्टि हो गई। एक नोट Pagar.me ऑर्डर ID (or_...) और भुगतान विधि दिखाता है।

Awaiting Pagar.me Payment Status (default Pending): PIX या boleto जारी हुआ (या कार्ड भुगतान विश्लेषण में है) और भुगतान की प्रतीक्षा कर रहा है। जब Pagar.me भुगतान की पुष्टि करता है, तो ऑर्डर Order Status After Payment पर चला जाता है।

Pagar.me Payment On Hold Status (default Pending): boleto केवल आंशिक रूप से चुकाया गया; या चुकाई गई राशि या मुद्रा ऑर्डर से भिन्न है; या ऑर्डर रद्द या रिफ़ंड होने के बाद भुगतान आया; या चुकाए गए ऑर्डर पर चार्जबैक खोला गया। नोट इसे समझाता है। ऑर्डर की जाँच करें और उसे पूरा करें या भुगतान का रिफ़ंड करें।

Payment Failed Status (default Failed): प्रतीक्षारत या होल्ड पर रखे गए ऑर्डर का भुगतान विफल हुआ, या उसका Pagar.me ऑर्डर रद्द हो गया या समय सीमा समाप्त हो गई (जैसे बिना चुकाया गया boleto)। यदि Pagar.me बाद में कोई भुगतान बताता है, तो ऑर्डर फिर भी Order Status After Payment पर चला जाता है।

Refunded Status (default Refunded): भुगतान एक्सटेंशन के माध्यम से पूरी तरह रिफ़ंड किया गया, या Pagar.me में रिफ़ंड या रद्द किया गया।

हर Pagar.me स्टेटस एक बार लागू होता है, इसलिए बार-बार आने वाले वेबहुक या वापसी से कोई नोट या भुगतान नहीं जुड़ता। नोट ऑर्डर के History की प्रविष्टियाँ हैं जो ग्राहक को दिखाई नहीं देतीं।

VibeFox Pagar.me Gateway टैब

Sales > Orders में Pagar.me से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Pagar.me Gateway टैब में Pagar.me order ID दिखता है (टेस्ट भुगतानों के लिए Test mode लेबल के साथ), Payment method, Status, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Pagar.me notes। यह टैब उन उपयोगकर्ताओं को दिखाया जाता है जिनकी एक्सटेंशन तक पहुँच है।

रिफ़ंड

VibeFox Pagar.me Gateway टैब में Amount दर्ज करें (जो राशि अभी तक रिफ़ंड नहीं हुई है, वह भर दी जाती है), वैकल्पिक रूप से एक Reason (optional), और Refund via Pagar.me पर क्लिक करें। Refund this amount through Pagar.me? This cannot be undone. प्रश्न की पुष्टि करें। कार्ड और PIX भुगतानों के पूर्ण और आंशिक रिफ़ंड समर्थित हैं। आपको एक्सटेंशन में बदलाव का अधिकार चाहिए (यह System > Users > User Groups में सेट होता है)। आप उतनी राशि तक रिफ़ंड कर सकते हैं जितनी Pagar.me ने वास्तव में काटी है; इसलिए राशि में अंतर होने के बाद सीमा ऑर्डर कुल राशि नहीं, बल्कि ग्राहक द्वारा चुकाई गई राशि होती है। रिफ़ंड उसी मोड की कुंजी से भेजा जाता है जिसमें भुगतान किया गया था, इसलिए उस मोड की सीक्रेट कुंजी सेट होनी चाहिए। रिफ़ंड तभी दर्ज होता है जब Pagar.me उसकी पुष्टि करे; अन्यथा टैब एक त्रुटि दिखाता है, जैसे Pagar.me refused the refund: ... या Pagar.me did not confirm the refund, और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड चार्ज ID के साथ रिफ़ंड इतिहास और नोट्स में जोड़ा जाता है। पूर्ण रिफ़ंड ग्राहक को सूचित किए बिना और उत्पादों को स्टॉक में लौटाए बिना ऑर्डर को Refunded Status पर सेट करता है, जैसे मैनुअल स्टेटस बदलने पर होता है। आंशिक रिफ़ंड स्टेटस नहीं बदलता। Pagar.me के भुगतान की रिपोर्ट करने के बाद ही रिफ़ंड उपलब्ध होते हैं।

boleto भुगतान केवल ग्राहक के बैंक खाते में ही रिफ़ंड किए जा सकते हैं। उन्हें Pagar.me डैशबोर्ड में रिफ़ंड करें, फिर OpenCart में रिफ़ंड को मैन्युअल रूप से दर्ज करें। Sales > Returns में उत्पाद वापसी Pagar.me के माध्यम से पैसा वापस नहीं भेजती।

Pagar.me डैशबोर्ड में किया गया पूर्ण रिफ़ंड या रद्दीकरण वेबहुक से पहुँचता है, ऑर्डर को Refunded Status पर सेट करता है और एक नोट जोड़ता है। चार्जबैक एक नोट जोड़ता है और चुकाए गए ऑर्डर को समीक्षा स्थिति में डालता है।

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

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

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

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

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

Pagar.me does not appear at checkout: जाँचें कि लाइसेंस सक्रिय है, Enable / Disable चालू है, वर्तमान मोड की सीक्रेट कुंजी सेट है (टेस्ट मोड में Test secret key, लाइव मोड में Live secret key), और ग्राहक BRL में चेकआउट करता है। कुंजी गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान पता चुने हुए Geo Zone में है और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।

The payment went through, but the order stays without a status or in the awaiting status: वेबहुक काम नहीं कर रहा है। Pagar.me डैशबोर्ड में जाँचें कि जिस खाते और मोड का आप उपयोग करते हैं, उसके लिए वेबहुक मौजूद है, कि उसका URL ठीक वही है जो Webhook URL में दिखाया गया है, और कि ऊपर सूचीबद्ध इवेंट चुने गए हैं। ग्राहक के स्टोर पर लौटने पर भी ऑर्डर की जाँच होती है।

The webhook answers verification failed, retry later: स्टोर API से Pagar.me ऑर्डर नहीं पढ़ पाया, उदाहरण के लिए क्योंकि उस मोड की कुंजी गायब है या API ने उत्तर नहीं दिया। Pagar.me वेबहुक को दोबारा भेजता है।

The webhook answers busy: कार्ट उसी समय किसी दूसरे अनुरोध द्वारा संसाधित हो रहा था, या ऑर्डर स्टेटस सेट नहीं हो सका। Pagar.me वेबहुक को दोबारा भेजता है। कारण देखने के लिए Debug log चालू करें।

The webhook answers unknown order: वह Pagar.me ऑर्डर इस स्टोर द्वारा नहीं बनाया गया था, उदाहरण के लिए उसी खाते पर किसी दूसरे स्टोर का ऑर्डर। कुछ नहीं बदला जाता।

The webhook answers invalid payload or invalid order id: अनुरोध Pagar.me की सूचना नहीं है। कुछ नहीं बदला जाता।

The customer sees Pagar.me payments are not available right now: सीक्रेट कुंजी गलत है या गायब है। वर्तमान मोड की कुंजी जाँचें।

The customer sees Pagar.me could not start the payment: Pagar.me ने बिलिंग विवरण अस्वीकार किए, उदाहरण के लिए कस्टम फ़ील्ड में CPF। संदेश समस्या बताता है; पूरा कारण लॉग में है।

The customer sees A valid billing email is required for Pagar.me.: ऑर्डर का ईमेल मान्य नहीं है।

The customer sees Pagar.me only supports payments in Brazilian Real (BRL).: चेकआउट किसी अन्य मुद्रा में है।

The customer sees This order already has a Pagar.me payment that the store has to review: कार्ट के किसी पिछले भुगतान के लिए आपकी समीक्षा आवश्यक है। Pagar.me डैशबोर्ड और लॉग देखें।

Order is in the review status after payment: VibeFox Pagar.me Gateway टैब के नोट पढ़ें (देखें ऑर्डर स्टेटस), फिर ऑर्डर पूरा करें या भुगतान का रिफ़ंड करें।

No refund form in the tab: टैब कारण बताता है: भुगतान की अभी तक रिपोर्ट नहीं हुई है, वह पूरी तरह रिफ़ंड हो चुका है, आपके उपयोगकर्ता समूह के पास एक्सटेंशन बदलने का अधिकार नहीं है, या भुगतान के मोड की सीक्रेट कुंजी सेट नहीं है।

Refund fails for a boleto: boleto भुगतान API के माध्यम से रिफ़ंड नहीं किए जा सकते। Pagar.me डैशबोर्ड में रिफ़ंड करें और रिफ़ंड को मैन्युअल रूप से दर्ज करें।

डेवलपर्स के लिए: Pagar.me ऑर्डर भेजने से पहले, एक्सटेंशन अनुरोध बॉडी और ऑर्डर के साथ OpenCart इवेंट wc_pgm_order_data ट्रिगर करता है। भुगतान राशि ऑर्डर कुल राशि के बराबर ही रहनी चाहिए।

अनइंस्टॉल

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

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

Pagar.me अपने-अपने स्वामी का ट्रेडमार्क है। यह एक्सटेंशन Pagar.me से संबद्ध नहीं है और न ही Pagar.me द्वारा समर्थित है।