एक उदाहरण के रूप में रोबोकैसा का उपयोग करते हुए मैगेंटो के लिए एक भुगतान विधि लिखना

शुभ दोपहर, खाबरोवस्क!

आज मैं Magento में भुगतान पद्धति लिखने के अनुभव को साझा करना चाहता हूं। एक उदाहरण के रूप में भुगतान का तरीका संयोग से नहीं चुना गया था, लेकिन सबसे महत्वपूर्ण में से एक के रूप में और एक ही समय में, ऑनलाइन स्टोर के उपयोगकर्ता के देश के हिस्सों पर अत्यधिक निर्भर था। और जब से मानक Magento पैकेज में मुख्य रूप से पश्चिमी उपयोगकर्ता के उद्देश्य से विधियाँ शामिल हैं, यह लेख CIS में किसी के लिए उपयोगी हो सकता है। प्रारंभ में, मैं एक प्रयोगात्मक के रूप में क्यूईवेई समर्थन लिखना चाहता था, लेकिन परीक्षण खातों को वहां बनाने की अनुमति नहीं थी, इसलिए रोबोकैसा के माध्यम से भुगतान विधि को चुना गया था।



सबसे पहले, हमें एक नया मॉड्यूल बनाने की आवश्यकता है, इसे कैसे करें और अधिक विस्तार से यहां पढ़ा जा सकता है - http://habrahabr.ru/blogs/php/80108/ । हम भुगतान विधि पर ध्यान केंद्रित करने की कोशिश करेंगे।

1. XML फाइलें बनाना

इसलिए, शुरुआत के लिए, हमें एप्लिकेशन / etc / मॉड्यूल / निर्देशिका में संबंधित xml फ़ाइल डालकर अपना अस्तित्व घोषित करना चाहिए।

Sample_Robokassa.xml:

<?xml version="1.0"?> <config> <modules> <Sample_Robokassa> <active>true</active> <codePool>local</codePool> <depends> <Mage_Sales/> <Mage_Checkout/> </depends> </Sample_Robokassa> </modules> </config> 

ये लाइनें Magento को बताएंगी कि हमारे मॉड्यूल को कहां देखना है। अगला, हमें अपने मॉड्यूल के लिए एक कॉन्फ़िगरेशन फ़ाइल बनाने और इसे पिछली फ़ाइल के अनुसार डालने की आवश्यकता है।

एप्लिकेशन / कोड / स्थानीय / नमूना / रोबोकैसा / आदि / config.xml:

 <?xml version="1.0"?> <config> <modules> <Sample_Robokassa> <version>1.0.0.0</version> </Sample_Robokassa> </modules> <global> <models> <robokassa> <class>Sample_Robokassa_Model</class><!--      --> </robokassa> </models> <blocks> <robokassa> <class>Sample_Robokassa_Block</class><!--   --> </robokassa> </blocks> <helpers> <robokassa> <class>Sample_Robokassa_Helper</class><!--  helper   --> </robokassa> </helpers> </global> <frontend> <routers> <robokassa> <use>standard</use> <args> <module>Sample_Robokassa</module> <frontName>robokassa</frontName> </args> </robokassa> </routers> </frontend> </config> 

और अंतिम XML फ़ाइल सेटिंग्स फ़ाइल है जिसे व्यवस्थापक पैनल में जोड़ा जाएगा।

 <?xml version="1.0"?> <config> <sections> <payment> <groups> <robokassa_redirect translate="label"> <label>Robokassa</label> <frontend_type>text</frontend_type> <sort_order>1</sort_order> <show_in_default>1</show_in_default> <show_in_website>1</show_in_website> <show_in_store>1</show_in_store> <fields> <active translate="label"> <label>Enabled</label> <frontend_type>select</frontend_type> <source_model>adminhtml/system_config_source_yesno</source_model> <sort_order>10</sort_order> <show_in_default>1</show_in_default> <show_in_website>1</show_in_website> <show_in_store>0</show_in_store> </active> <title translate="label"> <label>Title</label> <frontend_type>text</frontend_type> <sort_order>20</sort_order> <show_in_default>1</show_in_default> <show_in_website>1</show_in_website> <show_in_store>1</show_in_store> </title> <login translate="label"> <label>Merchant Login</label> <frontend_type>obscure</frontend_type> <backend_model>adminhtml/system_config_backend_encrypted</backend_model> <sort_order>30</sort_order> <show_in_default>1</show_in_default> <show_in_website>1</show_in_website> <show_in_store>0</show_in_store> </login> <password1 translate="label"> <label>Merchant Password #1</label> <!--       --> <frontend_type>obscure</frontend_type> <backend_model>adminhtml/system_config_backend_encrypted</backend_model> <sort_order>40</sort_order> <show_in_default>1</show_in_default> <show_in_website>1</show_in_website> <show_in_store>0</show_in_store> </password1> <password2 translate="label"> <label>Merchant Password #2</label> <!--       --> <frontend_type>obscure</frontend_type> <backend_model>adminhtml/system_config_backend_encrypted</backend_model> <sort_order>45</sort_order> <show_in_default>1</show_in_default> <show_in_website>1</show_in_website> <show_in_store>0</show_in_store> </password2> <test translate="label"> <label>Test Mode</label> <frontend_type>select</frontend_type> <source_model>adminhtml/system_config_source_yesno</source_model> <sort_order>50</sort_order> <show_in_default>1</show_in_default> <show_in_website>1</show_in_website> <show_in_store>0</show_in_store> </test> <sort_order translate="label"> <label>Sort Order</label> <frontend_type>text</frontend_type> <sort_order>60</sort_order> <show_in_default>1</show_in_default> <show_in_website>1</show_in_website> <show_in_store>0</show_in_store> </sort_order> </fields> </robokassa_redirect> </groups> </payment> </sections> </config> 

इन सभी फ़ाइलों को व्यवस्थापक पैनल में जोड़ने के बाद, सिस्टम पर कुछ इस तरह दिखाई देना चाहिए-> कॉन्फ़िगरेशन-> भुगतान के तरीके-> रोबोकैसा पथ:

2. मॉडल

भुगतान विधि मॉडल लिखते समय, आपको अमूर्त वर्ग Mage_Payment_Model_Method_Abstract के गुण अनुभाग पर विशेष ध्यान देना चाहिए, जिससे हम विरासत में प्राप्त करेंगे। इन सभी गुणों में से, हमें केवल 3 की आवश्यकता है:

 protected $_canUseForMultishipping = false;//      protected $_canUseInternal = false;//    protected $_isInitializeNeeded = true;//      

प्रारंभिक प्रक्रिया में, ऑर्डर को एक विशेष स्थिति - "लंबित_पेमेंट" के साथ चिपका दिया जाएगा, जिसका अर्थ है कि उपयोगकर्ता को भुगतान प्रणाली के पक्ष में पुनर्निर्देशित किया गया है, लेकिन भुगतान अभी तक नहीं किया गया है। इस स्थिति में, आदेश पैनल के साथ कुछ भी नहीं किया जा सकता है।

हमारे मॉडल का मुख्य कार्य रोबोकैश डेस्क के लिए सही अनुरोध संकलित करना होगा, और इसके उत्तर को सत्यापित करना होगा। ऐसा करने के लिए, हम दो तरीकों को लागू करते हैं जिन्हें हम नियंत्रकों से कहेंगे:

 public function getRedirectFormFields() { $result = array(); $session = Mage::getSingleton('checkout/session'); $order = Mage::getModel('sales/order')->loadByIncrementId($session->getLastRealOrderId()); if (!$order->getId()) { return $result; } $result['MrchLogin'] = $this->getConfigData('login'); $result['OutSum'] = $order->getBaseGrandTotal(); $result['InvId'] = $order->getIncrementId(); $result['Desc'] = 'Shopping in' . Mage::getStoreConfig(Mage_Core_Model_Store::XML_PATH_STORE_STORE_NAME); $result['IncCurrLabel'] = 'AlfaBankR';//    $result['SignatureValue'] = md5( $result['MrchLogin'] . ':' . $result['OutSum'] . ':' . $result['InvId'] . ':' . $this->getConfigData('password1') ); return $result; } public function validateRequest($request) { if (!isset($request['OutSum']) || !isset($request['InvId']) || !isset($request['SignatureValue'])) { return false; } $crc = md5($request['OutSum'] . ':' . $request['InvId'] . ':' . $this->getConfigData('password2')); return strtoupper($request['SignatureValue']) == strtoupper($crc); } 

यहां मैंने अंतरिक्ष को बचाने के लिए PHPDoc को काट दिया। पहली विधि में, हम एक सरणी के रूप में कैश डेस्क पर स्थानांतरित करने के लिए आवश्यक फ़ील्ड का एक सेट लौटाते हैं, दूसरे में - हस्ताक्षर को पुनर्जीवित किया जाता है और ट्रांसकोड मूल्य के साथ तुलना की जाती है ताकि हमलावरों को रोबोकैश डेस्क से प्रतिक्रिया देने से रोका जा सके। वैसे, कैश डेस्क में 2 पासवर्ड का उपयोग किया जाता है: एक संचार मैजेंटो के दौरान कुंजी बनाने के लिए-> रोबोकैसा, दूसरा - इसके विपरीत। साथ ही, मानक getConfigData विधि के माध्यम से बूट पर पासवर्ड को डिक्रिप्ट करने के लिए सिस्टम के लिए, यह उल्लेख करना आवश्यक है कि इन क्षेत्रों को config.xml फ़ाइल में एन्क्रिप्ट किया गया है।

इसके अलावा, एक महत्वपूर्ण विधि getOrderPlaceRedirectUrl है, जो उपयोगकर्ता को उस पृष्ठ पर ऑर्डर करने के बाद पुनर्निर्देशित करेगा जिसकी हमें आवश्यकता है। इस पृष्ठ पर हम अपने मॉडल से डेटा के साथ एक फॉर्म निकालेंगे और इसे जावास्क्रिप्ट पेज के साथ रॉबोकैश पेज पर भेज देंगे। उसके बाद, उपयोगकर्ता को भुगतान का लंबे समय से प्रतीक्षित रूप दिखाई देगा।

इस चरण में, भुगतान पृष्ठ पर तरीकों की सूची में हमारी भुगतान विधि दिखाई देनी चाहिए।

3. नियंत्रकों

हमारे पास एक नियंत्रक होगा और 3 मुख्य कार्यों पर ध्यान केंद्रित करेगा:

1. खरीद की पुष्टि करने के बाद ऑर्डर पर वांछित स्थिति डालें:

 $request = Mage::app()->getRequest()->getPost(); $paymentMethod = Mage::getModel('robokassa/redirect'); if (!$paymentMethod->validateRequest($request)) { return; } $order = Mage::getModel('sales/order')->loadByIncrementId($request['InvId']); /*          */ $order->setState(Mage_Sales_Model_Order::STATE_PROCESSING); $order->setStatus('processing'); $order->setIsNotified(false); $order->save(); echo 'OK' . $request['InvId']; // ,      

2. एक सफल उपयोगकर्ता रिटर्न प्रसंस्करण:

 $session = Mage::getSingleton('checkout/session'); $session->setQuoteId($session->getRobokassaQuoteId()); /*   ,    */ Mage::getSingleton('checkout/session')->getQuote()->setIsActive(false)->save(); $this->_redirect('checkout/onepage/success', array('_secure'=>true)); 

3. एक त्रुटि के साथ प्रसंस्करण लौटें:

 $session = Mage::getSingleton('checkout/session'); $session->setQuoteId($session->getRobokassaQuoteId()); if ($session->getLastRealOrderId()) { $order = Mage::getModel('sales/order')->loadByIncrementId($session->getLastRealOrderId()); if ($order->getId()) { $order->cancel()->save();// ,   "pending_payment"  } } $quote = Mage::getModel('sales/quote')->load($session->getRobokassaQuoteId()); if ($quote->getId()) { $quote->setActive(true);//    $quote->save(); } /*    */ $session->addError(Mage::helper('robokassa')->__('Payment failed. Pleas try again later.')); $this->_redirect('checkout/cart'); 

यह मूल रूप से सभी है, यह मॉड्यूल आपको ऑर्डर देने और कैश डेस्क के माध्यम से पैसे निकालने की अनुमति देगा। इसमें एक्सएमएल एपीआई रोबोकैश के लिए समर्थन को लागू करना भी संभव है, इससे मुद्राओं के साथ अधिक लचीला काम हो सकेगा। आप भुगतान विधियों की अन्य मानक विशेषताओं को भी लागू कर सकते हैं जैसे: डिबगिंग, इसे रखते समय ऑर्डर की स्थिति चुनना और बहुत कुछ।

लेख ने अधिकांश स्रोत कोड प्रकाशित किए। केवल दृश्य स्तर और कोड के बहुत महत्वपूर्ण खंड गायब नहीं हैं, जो कि बाकी स्रोत कोड के साथ, अंतर फ़ाइल में पाया जा सकता है। विस्‍तृत फाइल को लिनक्स पर पैच कमांड या विंडोज पर TortoiseSVN प्रोग्राम का उपयोग करके Magento की मौजूदा कॉपी पर इंस्‍टॉल किया जा सकता है।