Payora को Magento से कैसे जोड़ें
Magento कभी-कभी बहुत सख्त होता है। पेमेंट सेटअप भी ऐसा ही हो सकता है। अगर आप यह जानना चाहते हैं कि Payora को Magento से कैसे जोड़ें, तो पहले यह तय करें कि आप Magento 2 या Adobe Commerce पर काम कर रहे हैं, क्योंकि एडमिन स्क्रीन इतनी मिलती-जुलती होती हैं कि लोग भ्रमित हो जाते हैं, और इतनी अलग भी कि एक घंटा बर्बाद हो सकता है।
यह गाइड उन स्टोर्स के लिए है जहाँ आप Admin panel तक पहुँच सकते हैं, payment methods संपादित कर सकते हैं, और हर कदम पर डेवलपर का इंतज़ार किए बिना module settings बदल सकते हैं। अगर आपके स्टोर में permissions बहुत सीमित हैं, तो पहले अस्थायी access लें। एक भी role छूटने पर पूरा काम रुक सकता है।
1. पुष्टि करें कि Payora के लिए आपका Magento setup सही है
अगर आपका स्टोर Magento 2 या Adobe Commerce पर है और आप कोई payment module install या enable कर सकते हैं, तो यह तरीका आपके लिए सही है। पुराने Magento versions में अक्सर अलग maintenance approach चाहिए होती है, और यही बात तब भी लागू होती है जब आपका checkout बहुत अधिक customized हो। Theme override active module के बावजूद payment method को छिपा सकती है।
Payment settings बदलने से पहले इन तीन चीज़ों का owner कौन है, यह जाँच लें: codebase, payment configuration, और webhook endpoint। अगर इनमें से कोई चीज़ किसी third party के पास है, तो उनकी approval चाहिए। यह bureaucratic लग सकता है, लेकिन जब शाम 6 बजे live checkout टूट जाए, तब इसका मतलब समझ में आता है।
जो टीमें विकल्पों की तुलना कर रही हैं, उनके लिए Payora उन stores के लिए उपयुक्त है जो पूरे checkout को redesign किए बिना Magento crypto payments चाहते हैं। अगर आप अभी भी यह तय कर रहे हैं कि Payora साइट पर कैसे काम करेगा, तो क्रिप्टो भुगतान गेटवे क्या है और गाइड भी पढ़ें; इससे यह समझने में मदद मिलती है कि आपको direct checkout payment चाहिए, invoice-style payment चाहिए, या दोनों।
2. Payora को जिन Magento payment details की ज़रूरत होगी, उन्हें इकट्ठा करें
Installation से पहले, वे exact values इकट्ठा कर लें जिन्हें module मांगेगा। कम से कम API keys, merchant identifier, callback या webhook URL, और वह store-view या currency settings जिनका आप उपयोग करने वाले हैं, तैयार रखें। कोई एक field छूट गई तो आम तौर पर बार-बार test save करना और logs देखकर उलझना पड़ता है।
Values को एक बार लिख लें। फिर दोबारा जाँच लें। Endpoint URL में एक lowercase गलती payment confirmation को Magento तक पहुँचने ही नहीं देगी, और वह failure तब तक “payment pending” जैसा दिखेगा जब तक कोई logs नहीं देख लेता।
अगर payment team की naming convention है, तो उसी का उपयोग करें। अगर merchant account कई storefronts में shared है, तो हर store view को साफ़-साफ़ label करें। वरना पहली refund request एक guessing game बन जाएगी।
कई stores यहाँ currency rules भी सेट करते हैं। अगर आपका catalog USD में है, लेकिन checkout को एक store view के लिए EUR दिखाना चाहिए, तो यह पक्का करें कि Payora और Magento दोनों supported currency list पर सहमत हों। एक mismatch और checkout पर payment method बिना किसी स्पष्ट warning के गायब हो सकता है।
3. Magento में Payora payment module install या enable करें
Magento payment-gateway setup आम तौर पर settings screen से नहीं, बल्कि module files से शुरू होता है। Extension को वहाँ रखें जहाँ आपका deployment process अपेक्षा करता है, फिर अपनी टीम द्वारा इस्तेमाल किया जाने वाला standard Magento upgrade या enablement step चलाएँ। अगर आपका site Composer से managed है, तो version को बाकी store code के साथ aligned रखें।
Deployment के बाद Admin खोलें और देखें कि module payment methods के अंदर दिख रहा है या नहीं। आपको interface में proof चाहिए, सिर्फ़ हरे deployment log से काम नहीं चलेगा। अगर module code में मौजूद है लेकिन Admin में नहीं दिख रहा, तो Magento ने उसे अभी पूरी तरह register नहीं किया है।
कुछ stores में method दिखने से पहले cache clearing या configuration reindexing की भी ज़रूरत होती है। अनुमान मत लगाइए। किसी भी नए payment method के लिए आपकी team जो post-deploy checklist इस्तेमाल करती है, वही चलाएँ, फिर payment settings page refresh करके Payora नाम से खोजें।
अगर आपको developer-side fields और callback behavior के लिए reference चाहिए, तो डेवलपर दस्तावेज़, क्रिप्टो भुगतान गेटवे API page पर exact API names जाँचें। यहाँ छोटे field differences भी मायने रखते हैं।
4. Admin में Magento payment gateway setup पूरा करें
Payment configuration area खोलें और पहले core settings भरें। सही environment mode चुनें, वह display title डालें जो customers को दिखेगा, और सुनिश्चित करें कि संबंधित store view के लिए payment method enabled है। यही वह हिस्सा है जिसे ज़्यादातर teams जल्दबाज़ी में करती हैं, और असर बाद में दिखता है।
Allowed currencies सावधानी से सेट करें। अगर स्टोर 2 currencies में बेचता है, तो दोनों gateway द्वारा स्वीकार की जानी चाहिए और Magento payment gateway setup में भी allowed होनी चाहिए। अगर कोई currency unsupported है, तो उसे यहाँ disable कर दें, बजाय इसके कि ग्राहक checkout पर समस्या खुद देखें।
Order status mapping पर ध्यान देना ज़रूरी है। Paid order को unpaid order वाले status में नहीं रहना चाहिए। शुरुआती state, confirmed-payment state, और कोई manual-review state ऐसे map करें कि customer support timeline एक नज़र में पढ़ सके।
Display rules सरल हैं, लेकिन उपयोगी हैं। Payora को उन checkout pages तक सीमित रखें जहाँ इसका मतलब बनता है, और quote requests या internal admin orders से बाहर रखें, जब तक आपके पास कोई खास workflow न हो। एक merchant जिसके साथ मैंने काम किया, उसने method को हर जगह visible छोड़ दिया था, और support को एक हफ़्ते तक यह समझाने में लगा रहा कि staff orders customer orders जैसे क्यों दिख रहे थे।
5. अपने checkout flow के लिए Magento crypto payments configure करें
अब payment experience खुद महत्वपूर्ण है। Magento crypto payments में ग्राहक आम तौर पर Payora चुनता है, instructions देखता है, और फिर gateway द्वारा दिए गए payment flow के माध्यम से funds भेजता है। यह sequence छोटा रखें। लोग लंबी payment pages से जल्दी बाहर निकल जाते हैं।
तय करें कि checkout के बाद payment instructions कहाँ दिखेंगी। कुछ stores उन्हें order success page पर रखते हैं; कुछ ग्राहकों को dedicated payment page पर भेजते हैं। दोनों ही मामलों में, ग्राहक को amount, payment asset, और time window साफ़ दिखना चाहिए। अगर ये details दूसरे login के पीछे छिपी हों, तो support tickets आने तय हैं।
Invoice बनने के बाद, Payora द्वारा payment confirm होने तक Magento को order pending दिखाना चाहिए। यह waiting period सामान्य है। इसे बहुत जल्दी processing में न बदलें, वरना बाद में finance team को इसे unwind करना पड़ेगा।
अगर आपका स्टोर subscriptions या repeat buyers संभालता है, तो payment language सीधी रखें। “Pay with Payora” उस technical description से बेहतर काम करता है जिसे सिर्फ़ operations team समझती है। ग्राहक एक payment पूरा करना चाहता है, protocol पढ़ना नहीं।
6. Order, invoice, और status handling सेट करें
Payment modules की असली परीक्षा order handling में होती है। तय करें कि Payora payment confirm करने पर क्या होगा, payment expire होने पर क्या होगा, और ग्राहक बीच में cancel करे तो क्या होगा। अगर gateway सफल callback भेजता है लेकिन Magento order को pending ही रखता है, तो mapping गलत है।
Go-live से पहले invoice creation rules तय कर लें। कुछ stores confirmed payment के बाद ही invoice बनाते हैं; कुछ accounting reasons से उसे पहले बनाते हैं। कोई भी विकल्प काम कर सकता है, लेकिन नियम पहले से तय होना चाहिए, ताकि support live orders पर अनुमान न लगाए।
Failed payments के लिए अलग path होना चाहिए। अगर Payora failure रिपोर्ट करता है, तो Magento को “awaiting payment” label अनिश्चितकाल तक नहीं रखना चाहिए। Loop को failed या canceled state पर बंद करें, फिर सुनिश्चित करें कि customer duplicate orders बनाए बिना दोबारा कोशिश कर सके।
Callback और security checks संभालने के लिए क्रिप्टो भुगतान गेटवे सुरक्षा सर्वोत्तम प्रथाएँ लेख देखने लायक है। Signed webhook और verified origin उबाऊ details हैं। लेकिन ये ज़्यादातर payment fraud attempts को शुरुआत में ही रोक देती हैं।
एक और बात: refunds और reversals को payment confirmation से अलग flow में चलना चाहिए। अगर आपकी operations team refunds manually जारी करती है, तो steps की संख्या और ज़िम्मेदार व्यक्ति document करें। Audit trail के बिना किया गया refund लंबी दोपहर बन सकता है।
7. Cart से paid order तक Payora checkout test करें
कम से कम एक पूरा test cart से paid order तक चलाएँ। अगर Payora sandbox देता है, तो उसका उपयोग करें, या अगर आपकी team अनुमति दे, तो controlled live test करें। आपको checkout page, payment instructions, callback, और Admin में updated order status—सब कुछ देखना है।
कम जोखिम वाले product से शुरू करें। उसे cart में डालें, checkout से आगे बढ़ें, और देखें कि payment method ठीक उसी जगह दिख रहा है जहाँ आप उम्मीद करते हैं। अगर Payora नहीं दिखता, तो समस्या आम तौर पर configuration flag, currency mismatch, या store-view setting होती है।
फिर admin side देखें। Successful test से status change होना चाहिए, और अक्सर invoice या payment record भी बनना चाहिए। अगर storefront “paid” कह रहा है लेकिन Magento अभी भी “pending” दिखा रहा है, तो दोबारा कोशिश करने से पहले callback log देखें।
एक expiry scenario भी test करें। Payment window खत्म होने दें और पुष्टि करें कि order हमेशा आधा-सा अधूरा न रहे। Dead orders जल्दी जमा हो जाते हैं, और support teams को उन्हें एक-एक करके साफ़ करना पसंद नहीं होता।
अगर आपकी team एक से अधिक platform support करती है, तो checkout logic आपको परिचित लग सकता है। WordPress पर क्रिप्टो भुगतान स्वीकार करें में workflow similar confirmation checks उपयोग करता है, हालाँकि Magento की admin handling अलग ही होती है।
8. आम Magento connection समस्याओं को ठीक करें
आम रुकावटें glamorous नहीं होतीं। गलत callback URL। Module का सक्रिय न होना। Currency mismatch। गलत store view में payment method disabled होना। इनमें से हर एक अलग symptom देता है, और gateway को broken मानना बंद करते ही हर समस्या हल हो सकती है।
अगर callbacks कभी पहुँच ही नहीं रहे, तो endpoint को सीधे test करें और पक्का करें कि आपका server उस Payora environment से आने वाले inbound requests स्वीकार करता है जिसे आपने configure किया है। Firewall rule सब कुछ रोक सकता है, जबकि Magento admin बिल्कुल healthy दिखता रहता है। यही सबसे खराब तरह की “healthy” स्थिति है।
अगर payment method Admin में दिख रहा है लेकिन checkout पर नहीं, तो visibility rules और quote conditions जाँचें। कुछ stores payment methods को cart total, shipping country, या customer group के आधार पर छिपाते हैं। एक hidden filter ही Payora को गायब करने के लिए काफी है।
अगर payment status syncing धीमा है, तो order state mapping फिर से जाँचें और उसे gateway response से compare करें। Code ठीक हो सकता है, लेकिन store ऐसे status value का इंतज़ार कर रहा हो जिसे Payora कभी भेजता ही नहीं। यह mismatch Magento payment gateway setup projects में आम है, जहाँ पहली configuration किसी दूसरे store से copy की गई थी और साफ़ नहीं की गई थी।
API field names, endpoint behavior, और किसी भी store-specific request format के लिए troubleshooting करते समय डेवलपर दस्तावेज़, क्रिप्टो भुगतान गेटवे API page खुला रखें। एक missing parameter पूरे flow को रोक सकता है।
यहाँ एक practical checklist है जिसे आप 10 मिनट में चला सकते हैं:
- पुष्टि करें कि Payora module सही Magento store view में enabled है।
- Verify करें कि webhook या callback URL live environment से मेल खाता है।
- जाँचें कि allowed currencies में checkout currency शामिल है।
- पुष्टि करें कि order status map वास्तविक Payora response values से मेल खाता है।
- एक test order दें और storefront तथा Admin दोनों के updates देखें।
अगर स्टोर में कई administrators हैं, तो payment settings बदलने की अनुमति सीमित करें। एक ही gateway को एक ही दिन दो लोगों द्वारा edit करना “temporary” fixes को permanent errors में बदल देता है। एक owner रखें, या कम से कम एक approver।
Magento सख्त है, लेकिन इससे मदद भी मिलती है। एक बार module install हो जाए, settings complete हो जाएँ, और callbacks verify हो जाएँ, तो Payora checkout flow में predictably काम करता है—और ज़्यादातर merchants payment method से यही चाहते हैं।
Comments