वापस

VibeFox Midtrans for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

PHP: 8.0 या उसके बाद का संस्करण। मॉड्यूल पुराने PHP संस्करणों पर इंस्टॉल नहीं होगा।

मुद्रा: इंडोनेशियाई रुपिया (IDR)। Midtrans केवल IDR में भुगतान लेता है, इसलिए भुगतान विकल्प तभी दिया जाता है जब कार्ट की मुद्रा IDR हो। मुद्रा रूपांतरण नहीं होता। यदि आपके स्टोर में IDR मुद्रा नहीं है, तो उसे International > Localization में जोड़ें।

Midtrans खाता: आपको Midtrans Dashboard > Settings > Access Keys से Server Key चाहिए, sandbox डैशबोर्ड और production डैशबोर्ड दोनों से। केवल Server Key का उपयोग होता है। Snap Redirect के लिए Client Key की ज़रूरत नहीं है। भुगतान के तरीके (GoPay, QRIS, वर्चुअल अकाउंट आदि) स्वयं आपके Midtrans खाते में सक्षम किए जाते हैं।

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

इंस्टॉलेशन

1. बैक ऑफिस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox Midtrans Payment Gateway खोजकर Configure पर क्लिक करें।

3. Configure पेज के ऊपर वाले लाइसेंस ब्लॉक में License key फ़ील्ड में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें (लाइसेंस कुंजी देखें)।

4. Server Keys डालें और भुगतान सूचना URL को Midtrans डैशबोर्ड में कॉपी करें (देखें कॉन्फ़िगरेशन)।

5. Enable/Disable चालू करें और Save पर क्लिक करें। Sandbox में जाँच करें, फिर Environment को Production पर बदलें।

इंस्टॉल होने पर मॉड्यूल दो ऑर्डर स्थितियाँ बनाता है: Awaiting Midtrans payment और Midtrans payment on hold। PrestaShop सभी मुद्राओं, देशों और ग्राहक समूहों के लिए एक नया भुगतान मॉड्यूल देता है। इन्हें आप Payment > Preferences में सीमित कर सकते हैं। मॉड्यूल IDR मुद्रा के लिए अनुमत रहना चाहिए।

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox Midtrans Payment Gateway > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सहेजता है। फ़ील्ड्स के ऊपर पेज चेतावनी देता है कि यदि चुने गए वातावरण की Server Key नहीं है (तब चेकआउट पर भुगतान विकल्प छिप जाता है) या स्टोर की डिफ़ॉल्ट मुद्रा IDR नहीं है, और Sandbox चुने होने पर Sandbox mode: payments are simulated, no real money is charged. दिखाता है।

Midtrans

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

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

Description: चेकआउट पर भुगतान विकल्प के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely via Midtrans — GoPay, QRIS, ShopeePay, cards, bank transfer and more. Sandbox में SANDBOX MODE: no real money is charged. वाली पंक्ति जोड़ी जाती है।

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

Midtrans Dashboard > Settings > Access Keys से Server Key कॉपी करें। इस सेक्शन में production डैशबोर्ड और sandbox डैशबोर्ड के लिंक हैं।

Environment: नए भुगतानों के लिए कौन-सा Midtrans वातावरण इस्तेमाल होगा। बदलने पर चुने गए वातावरण की कुंजी और API इस्तेमाल होते हैं। भुगतान अपना वातावरण रिफ़ंड और सूचनाओं के लिए बनाए रखते हैं। डिफ़ॉल्ट: Sandbox।

Sandbox: परीक्षण के लिए, बिना असली पैसे के।
Production: असली भुगतान।

Production Server Key: Mid-server- से शुरू होती है। इसे गुप्त रखें।

Sandbox Server Key: SB-Mid-server- से शुरू होती है।

सहेजी गई कुंजियाँ दोबारा नहीं दिखाई जातीं। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान डालें।

Clear saved keys: किसी कुंजी पर टिक लगाकर Save पर क्लिक करें, तो वह हट जाती है। खाली फ़ील्ड सहेजे गए मान को बनाए रखता है।

भुगतान सूचना URL

सूचना आपके स्टोर को बताती है कि भुगतान हो गया है। Notification URL फ़ील्ड में वह URL दिखता है जिसका उपयोग करना है। फ्रेंडली URL चालू होने पर वह कुछ इस तरह दिखता है: https://your-shop/module/wcp_midtrans_payment_gateway/webhook, संभवतः /en/ जैसे भाषा कोड के साथ। URL को ठीक वैसा ही कॉपी करें जैसा सेटिंग्स में दिखता है, और उसे Midtrans Dashboard > Settings > Payment > Notification URL में चिपकाएँ, उस sandbox डैशबोर्ड और production डैशबोर्ड में जिसका आप उपयोग करते हैं। URL को ब्राउज़र में खोलने पर एक छोटी व्याख्या दिखती है, जिससे आप जाँच सकते हैं कि वह पहुँच योग्य है। Midtrans डैशबोर्ड का Test notification URL बटन भी जवाब देता है।

हर सूचना पर आपकी किसी Server Key से बना वैध हस्ताक्षर होना चाहिए, और कुंजी का वातावरण भुगतान के वातावरण से मेल खाना चाहिए। वैध हस्ताक्षर के बिना आई सूचनाएँ अस्वीकार की जाती हैं। तब स्टेटस Midtrans स्टेटस API से दोबारा पढ़ा जाता है। मॉड्यूल ये Midtrans लेन-देन स्थितियाँ संभालता है:

settlement, capture (accepted): भुगतान हो गया। राशि (पूर्ण रुपये में) और मुद्रा कार्ट से मेल खाने पर ऑर्डर भुगतान किए गए के रूप में बनता है।
capture (challenge): Midtrans की धोखाधड़ी जाँच द्वारा चिह्नित कार्ड भुगतान। जब तक आप Midtrans डैशबोर्ड में इसे स्वीकृत या अस्वीकृत नहीं करते, ऑर्डर Midtrans payment on hold में रहता है।
pending: ग्राहक ने विलंबित तरीका (वर्चुअल अकाउंट, कन्वीनियंस स्टोर) चुना और अभी भुगतान नहीं किया। ऑर्डर Awaiting Midtrans payment में बनता है।
expire, cancel: अनभुगतान लेन-देन की अवधि समाप्त हो गई या वह रद्द हो गया। प्रतीक्षारत ऑर्डर हर भुगतान तरीके के लिए Canceled हो जाता है। ऑर्डर न हो तो केवल प्रयास बंद होता है और ग्राहक कार्ट का फिर से भुगतान कर सकता है।
deny: भुगतान अस्वीकार हुआ। प्रतीक्षारत ऑर्डर Payment error हो जाता है।
failure: भुगतान विफल हुआ। प्रतीक्षारत ऑर्डर Payment error हो जाता है।
refund, partial_refund: Midtrans डैशबोर्ड में किया गया रिफ़ंड ऑर्डर में दर्ज होता है।

भुगतान सूचना URL के बिना ऑर्डर केवल तब बनता है जब ग्राहक भुगतान के बाद स्टोर पर लौटता है, और बाद में किया गया विलंबित भुगतान तब तक नहीं दिखता जब तक ग्राहक वापस न आए।

भुगतान सेटिंग्स

Midtrans केवल IDR में भुगतान लेता है, और राशियाँ पूर्ण रुपये में भेजी जाती हैं। यदि ऑर्डर की पंक्तियाँ गोल किए गए कुल योग के बराबर नहीं होतीं, तो Midtrans को Rounding adjustment पंक्ति भेजी जाती है।

Status after payment: पुष्टि किए गए भुगतान के बाद ऑर्डर की स्थिति।

Processing (default): Payment accepted, भुगतान किए गए ऑर्डरों के लिए PrestaShop की मानक स्थिति।
Completed: हर भुगतान किया हुआ ऑर्डर Delivered हो जाता है।
On hold: हर भुगतान किया हुआ ऑर्डर आपकी मैन्युअल समीक्षा के लिए Midtrans payment on hold में जाता है। भुगतान फिर भी ऑर्डर में दर्ज रहता है।

Payment page expiry (minutes): ग्राहक कितनी देर तक भुगतान कर सकता है (Snap पेज, वर्चुअल अकाउंट आदि)। खाली छोड़ें या Midtrans के डिफ़ॉल्ट के लिए 0 रखें। जो मान पूरे मिनट न हो, उसे सहेजते समय त्रुटि के साथ अस्वीकार किया जाता है।

Order ID prefix: Midtrans को भेजे जाने वाले नंबर के आगे जोड़ा जाता है, ताकि कई स्टोर एक ही Midtrans खाता साझा कर सकें। नंबर कार्ट ID और टाइम स्टैम्प से बनता है, जैसे WC-123-1700000000। केवल अक्षर, अंक और - _ . ~ चलते हैं, अधिकतम 20 वर्ण; बाकी वर्ण सहेजते समय हटा दिए जाते हैं। अन्य स्टोरों की सूचनाएँ अनदेखी की जाती हैं। डिफ़ॉल्ट: WC-।

उन्नत

Debug log: API कॉल और सूचनाएँ मॉड्यूल फ़ोल्डर में logs/midtrans_p_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खुल सकती। त्रुटियाँ हमेशा दर्ज होती हैं। कुंजियाँ और ग्राहक का डेटा कभी दर्ज नहीं होता। डिफ़ॉल्ट: बंद।

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

Delete data on uninstall: चालू होने पर मॉड्यूल हटाने से मॉड्यूल की सेटिंग्स और लॉग हट जाते हैं। ऑर्डर, उनके Midtrans भुगतान संदर्भ और रिफ़ंड, तथा मॉड्यूल की ऑर्डर स्थितियाँ हमेशा रहती हैं, ताकि पुराने ऑर्डर दोबारा इंस्टॉल करने के बाद भी रिफ़ंड हो सकें। डिफ़ॉल्ट: बंद।

चेकआउट

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

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। वापसी का लिंक अपने-आप किसी ऑर्डर को भुगतान किया हुआ नहीं बनाता: ऑर्डर तभी भुगतान किया हुआ माना जाता है जब Midtrans उसकी पुष्टि कर दे, या तो हस्ताक्षरित सूचना से, या ग्राहक के लौटने पर Midtrans स्टेटस API से पूछताछ द्वारा। फिर ऑर्डर बनता है और ग्राहक को उपयोग किए गए भुगतान तरीके के साथ मानक ऑर्डर पुष्टि पेज दिखता है। विलंबित भुगतान के लिए पेज दिखाता है: We are waiting for Midtrans to confirm your payment. If you chose a bank transfer, virtual account or convenience store, please complete the payment using the instructions from Midtrans. You will receive an e-mail once the payment is confirmed. बिना भुगतान के बंद ऑर्डर के लिए: Your Midtrans payment was not completed. Please contact us about this order. यदि ग्राहक के लौटने पर Midtrans तक पहुँच न हो, तो Payment confirmation पेज दिखाता है: We are confirming your payment with Midtrans. The order will be updated automatically — please do not pay again. साथ में Check again बटन।

यदि ग्राहक बिना भुगतान किए Snap पेज से चला गया, तो वह The Midtrans payment was not completed. You can try again below. संदेश के साथ चेकआउट पर लौट आता है। यदि भुगतान अस्वीकार हो गया या उसकी अवधि समाप्त हो गई, तो संदेश है: Your Midtrans payment was declined or has expired. Please try again or choose another payment method. कार्ट सुरक्षित रहता है। जब ग्राहक फिर से भुगतान करता है, तो उसी राशि का कोई अप्रयुक्त या लंबित Snap फिर से उपयोग होता है। यदि राशि बदल गई है, तो लंबित लेन-देन पहले Midtrans पर समाप्त किया जाता है। यदि इस बीच पिछला Snap भुगतान हो चुका है, तो ऑर्डर बन जाता है और नया लेन-देन नहीं बनता। यदि ऑर्डर पहले से है और बिना भुगतान के बंद हुआ है, तो संदेश है: Your Midtrans payment was declined or has expired. Please place a new order or contact us.

यदि Midtrans भुगतान शुरू नहीं कर सकता, तो ग्राहक एक छोटे संदेश के साथ चेकआउट पर रहता है: Could not connect to Midtrans. Please try again in a moment., Midtrans payments are temporarily unavailable. Please choose another payment method or contact us. (उदाहरण के लिए गलत Server Key होने पर) या Midtrans से मिला कारण। तकनीकी कारण लॉग में लिखा जाता है। IDR के अलावा किसी मुद्रा के कार्ट पर Midtrans only supports payments in IDR (Indonesian Rupiah). Please choose another payment method. दिखता है।

सूचना तब भी काम करती है जब स्टोर मेंटेनेंस मोड में हो, और वह आपके स्टोर के देश-प्रतिबंध से अवरुद्ध नहीं होती।

मॉड्यूल केवल Snap Redirect उपयोग करता है। इसमें Snap पॉप-अप नहीं है, आपकी साइट पर कार्ड फ़ॉर्म नहीं है, सेव किए गए कार्ड या वन-क्लिक भुगतान नहीं हैं, किस्त या प्रोमो सेटिंग नहीं हैं (भुगतान तरीके Midtrans डैशबोर्ड में कॉन्फ़िगर करें) और सब्सक्रिप्शन नहीं हैं। कार्ड भुगतान तुरंत कैप्चर होते हैं, authorize और capture अलग-अलग नहीं होते।

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

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

No order yet: ग्राहक को Midtrans पर भेजा गया और उसने भुगतान नहीं किया, या Midtrans ने अभी भुगतान की पुष्टि नहीं की है। केवल कार्ट मौजूद है।

Awaiting Midtrans payment: ग्राहक ने विलंबित तरीका (वर्चुअल अकाउंट, कन्वीनियंस स्टोर) चुना या अधूरा कार्ड भुगतान शुरू किया। Midtrans भुगतान की सूचना देता है तो ऑर्डर भुगतान किया हुआ बन जाता है।

Payment accepted, Delivered या Midtrans payment on hold: भुगतान की पुष्टि हो गई। स्थिति Status after payment का अनुसरण करती है। भुगतान Midtrans लेन-देन ID के साथ दर्ज होता है, और एक नोट भुगतान तरीका व Midtrans ऑर्डर ID दिखाता है।

Midtrans payment on hold: यह तब भी लगता है जब कार्ड भुगतान धोखाधड़ी समीक्षा (challenge, अभी कोई भुगतान दर्ज नहीं) में हो, जब भुगतान की गई राशि या मुद्रा ऑर्डर से मेल न खाए (ऑर्डर भुगतान किया हुआ नहीं माना जाता), या जब रद्द हो चुके ऑर्डर पर भुगतान आए (ऑर्डर अपने-आप दोबारा नहीं खुलता)। नोट इसका कारण बताता है। ऑर्डर देखें, फिर उसे पूरा करें या भुगतान रिफ़ंड करें।

Canceled: अनभुगतान लेन-देन की अवधि समाप्त हो गई या वह रद्द हो गया। जब आप स्वयं कोई अनभुगतान Midtrans ऑर्डर रद्द करते हैं, तो उसका लंबित Midtrans लेन-देन, जैसे जारी किया गया वर्चुअल अकाउंट, समाप्त कर दिया जाता है ताकि उसे अब भुगतान न किया जा सके।

Payment error: भुगतान विफल हुआ, या समीक्षा में रखा गया कार्ड भुगतान अस्वीकार हुआ।

Refunded: भुगतान पूरी तरह रिफ़ंड हो गया।

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

Midtrans भुगतान ब्लॉक

ऑर्डर पेज पर Midtrans payment ब्लॉक दिखता है, जिसमें Midtrans ऑर्डर ID, लेन-देन ID (भुगतान के वातावरण के Midtrans डैशबोर्ड में लेन-देन से जुड़ा), भुगतान तरीका, स्थिति, भुगतान की गई और रिफ़ंड की गई राशि, sandbox भुगतानों के लिए Sandbox बैज, रिफ़ंड इतिहास और ऑर्डर के Midtrans notes शामिल हैं।

रिफ़ंड

Midtrans payment ब्लॉक में राशि डालें (जो राशि अभी रिफ़ंड नहीं हुई है, वह अपने-आप भर जाती है), चाहें तो कारण लिखें, और Refund via Midtrans पर क्लिक करें। Refund this amount through Midtrans? This cannot be undone. प्रश्न की पुष्टि करें। पूर्ण और आंशिक रिफ़ंड पूर्ण रुपये में समर्थित हैं; दशमलव वाली राशि अस्वीकार होती है। आपके पास ऑर्डर संपादित करने का अधिकार होना चाहिए। ऑर्डर बाद में संपादित हुआ हो तब भी आप उतनी राशि तक रिफ़ंड कर सकते हैं जितनी Midtrans ने वास्तव में वसूली थी। रिफ़ंड उसी वातावरण में भेजा जाता है जिसमें भुगतान हुआ था, इसलिए उस वातावरण की Server Key सेट होनी चाहिए। Midtrans केवल कुछ भुगतान तरीकों और लेन-देन स्थितियों के लिए API रिफ़ंड की अनुमति देता है (उदाहरण के लिए निपटाए गए कार्ड भुगतान, GoPay, QRIS या ShopeePay भुगतान)। यदि Midtrans रिफ़ंड स्वीकार नहीं करता, तो ब्लॉक त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता; तब Midtrans डैशबोर्ड में रिफ़ंड करें। सफल रिफ़ंड रिफ़ंड इतिहास और नोट्स में जुड़ जाता है। पूर्ण रिफ़ंड ऑर्डर को Refunded पर सेट करता है। आंशिक रिफ़ंड स्थिति नहीं बदलता। रिफ़ंड तभी उपलब्ध होते हैं जब Midtrans भुगतान निपटने की सूचना दे चुका हो।

मॉड्यूल क्रेडिट स्लिप नहीं बनाता। ऑर्डर पेज के मानक PrestaShop रिफ़ंड बटन Midtrans के माध्यम से पैसा वापस नहीं भेजते।

Midtrans डैशबोर्ड में किए गए रिफ़ंड सूचना के ज़रिए आते हैं और कारण Refunded in the Midtrans dashboard के साथ अपने-आप रिफ़ंड इतिहास में जुड़ जाते हैं। जब वहाँ पूरा भुगतान रिफ़ंड हो जाता है, तो ऑर्डर Refunded हो जाता है।

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

मॉड्यूल vibefox.net से ली गई VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox Midtrans Payment Gateway लाइसेंस ब्लॉक, Modules > Module Manager > VibeFox Midtrans Payment Gateway > Configure पेज पर पहला ब्लॉक है और सेटिंग्स के ऊपर दिखता है। कुंजी License key फ़ील्ड में डालें और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके दिखाता है, साथ में स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन) और ये बटन: स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी डालने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: presta-payment-midtrans की पंक्ति और आपके vibefox.net खाते को खोलने वाला लिंक Manage licenses and domains in your account है। कुंजी केवल वे कर्मचारी बदल सकते हैं जिनके पास इस मॉड्यूल के लिए Configure अनुमति है। ब्लॉक के पाठ बैक ऑफ़िस की भाषा का पालन करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो सकती, तो मॉड्यूल अंतिम ज्ञात स्थिति पर काम करता रहता है।

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

सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को Midtrans नहीं दिखता। फिर भी यदि भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। PrestaShop स्टोरफ़्रंट को पता नहीं होता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए भुगतान विधि आपके लिए भी छिपी रहती है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, पर चेकआउट पर उसे परख नहीं सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं उनकी पुष्टि होती रहती है, और रिफ़ंड काम करते हैं।

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

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

Midtrans does not appear at checkout: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और चुने गए Environment के लिए Server Key है। जाँचें कि कार्ट की मुद्रा IDR है। Payment > Preferences में जाँचें कि मॉड्यूल IDR, ग्राहक के देश और ग्राहक के समूह के लिए अनुमत है। कुंजी न होने या स्टोर मुद्रा IDR न होने पर सेटिंग्स पेज चेतावनी दिखाता है।

The payment went through, but no order was created: सूचना काम नहीं कर रही। जाँचें कि जिस वातावरण (sandbox या production) का आप उपयोग करते हैं, उसके Midtrans डैशबोर्ड में भुगतान सूचना URL सेट है, वह Notification URL में दिखाए गए URL से हूबहू मेल खाता है, और वह पहुँच योग्य है: उसे ब्राउज़र में खोलें, एक छोटी व्याख्या दिखनी चाहिए। सूचनाएँ देखने के लिए Debug log चालू करें। भुगतान के बाद ग्राहक स्टोर पर लौटता है तब भी ऑर्डर बनता है।

Notification answers Invalid signature: सूचना आपकी Sandbox या Production Server Key से हस्ताक्षरित नहीं थी। जाँचें कि सेटिंग्स की कुंजियाँ उसी Midtrans खाते की हैं जिस डैशबोर्ड से सूचनाएँ भेजी जा रही हैं।

Notification answers Server key not configured: कोई Server Key सेट नहीं है। सेटिंग्स में डालें; Midtrans सूचना दोबारा भेजेगा।

Notification answers Order not found — ignored: यह Midtrans ऑर्डर ID इस स्टोर द्वारा जारी नहीं हुआ, उदाहरण के लिए उसी Midtrans खाते के किसी दूसरे स्टोर ने जारी किया। हर स्टोर को अलग Order ID prefix दें।

Notification answers Environment mismatch — ignored: सूचना उस वातावरण से भिन्न वातावरण की कुंजी से हस्ताक्षरित थी जिसमें भुगतान हुआ था।

Notification answers Verification failed, please retry: Midtrans स्टेटस API तक पहुँच नहीं हो सकी। Midtrans सूचना दोबारा भेजेगा।

Notification answers Busy, please retry: उसी समय कार्ट किसी दूसरे अनुरोध से अपडेट हो रहा था, या ऑर्डर नहीं बन सका (उदाहरण के लिए मॉड्यूल बंद है)। Midtrans सूचना दोबारा भेजेगा। कारण के लिए लॉग देखें।

The order is Midtrans payment on hold: ब्लॉक में Midtrans notes पढ़ें। कार्ड भुगतान धोखाधड़ी समीक्षा में है, भुगतान की गई राशि या मुद्रा ऑर्डर से मेल नहीं खाती, या ऑर्डर रद्द होने के बाद भुगतान आया।

The customer sees an error when choosing Midtrans: मॉड्यूल पेज पर Log फ़ील्ड देखें; त्रुटियाँ हमेशा दर्ज होती हैं। गलत Server Key पर संदेश दिखता है कि Midtrans भुगतान अस्थायी रूप से उपलब्ध नहीं हैं।

Refund fails: भुगतान तरीका या लेन-देन स्थिति API रिफ़ंड की अनुमति नहीं देती; Midtrans डैशबोर्ड में रिफ़ंड करें, और रिफ़ंड अपने-आप ऑर्डर में दर्ज हो जाएगा। यदि संदेश कहता है कि जिस वातावरण में ऑर्डर का भुगतान हुआ, उसके लिए कोई Server Key कॉन्फ़िगर नहीं है, तो वह कुंजी डालें और फिर से प्रयास करें।

डेवलपर actionWcpMidtransSnapPayload हुक से Midtrans को भेजे जाने वाले डेटा में बदलाव कर सकते हैं; ऑर्डर ID और राशि नहीं बदली जा सकतीं।

अनइंस्टॉल

Modules > Module Manager पर जाएँ, VibeFox Midtrans Payment Gateway के बगल का मेनू खोलें और Uninstall चुनें। इस मॉड्यूल की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं। यदि Delete data on uninstall चालू है, तो मॉड्यूल की सेटिंग्स और लॉग हटा दिए जाते हैं। यदि बंद है, तो बाद में दोबारा इंस्टॉल करने के लिए सारी सेटिंग्स रखी जाती हैं। ऑर्डरों के Midtrans भुगतान संदर्भ और रिफ़ंड, तथा Awaiting Midtrans payment और Midtrans payment on hold ऑर्डर स्थितियाँ हमेशा रखी जाती हैं, ताकि पहले भुगतान किए गए ऑर्डर दोबारा इंस्टॉल करने के बाद भी रिफ़ंड हो सकें। मौजूदा ऑर्डर अपने भुगतान नोट और लेन-देन ID रखते हैं।

Midtrans उसके संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल Midtrans से संबद्ध नहीं है और न ही Midtrans द्वारा समर्थित है।