📘 🙍🏻 👨🏽‍🚒 हमने रूसी परियोजना में भुगतान प्रणाली को कैसे एकीकृत किया ⚠️ 😳 ⏮️

पांच महीने पहले, हमने Yandex.Kassa के नए संस्करण के साथ काम करने के लिए एक एनपीएम मॉड्यूल प्रकाशित किया था, जो अक्टूबर 2017 में जारी किया गया था। हमारा मॉड्यूल आधिकारिक दस्तावेज में गिर गया और पहले से ही 1300 से अधिक बार डाउनलोड किया जा चुका है।

हेबेरा पर, यैंडेक्स के सहयोगियों के साथ, हमने पहले से ही मॉड्यूल बनाने के अनुभव के बारे में बात की थी , लेकिन रूसी ग्राहकों के लिए भुगतान प्रणाली के एकीकरण का सामना करने पर हमारा अनुभव जो हमें प्राप्त हुआ था, वह पीछे रह गया था।

इसलिए, आज हम आपको यह बताना चाहते हैं कि हमारे घरेलू ग्राहकों में से एक के लिए हमने विदेशी भुगतान प्रणालियों को रूसी समकक्षों से हमें परिचित कराने से रोक दिया, हमें किन कठिनाइयों का सामना करना पड़ा और वे कैसे हल हुए।

उन्होंने भुगतान प्रणालियों के साथ कैसे काम किया

पहले, हमने केवल विदेशी ग्राहकों के भुगतान प्रणाली के साथ काम किया था। हमारे पास Authorize.net, Paypal, Braintree, Stripe, Payoneer, Wirecard, और Svea के साथ एकीकरण का अनुभव था।

इन भुगतान प्रणालियों के साथ बातचीत करना और विभिन्न कार्यों को लागू करना आसान है। उदाहरण के लिए, जब हम यूरोप में एक माल ढुलाई सेवा पर काम कर रहे थे, हमने परियोजना में कई भुगतान प्रणालियों को एकीकृत किया और एक एल्गोरिथ्म लिखा - इसने मौद्रिक संचालन के एक जटिल तर्क को लागू किया। जब एक उपयोगकर्ता ने एक सेवा का आदेश दिया, तो सिस्टम ने ग्राहक के खाते से सेवा के खाते में धन हस्तांतरित किया, और एल्गोरिथ्म ने लेनदेन किया: वितरण समस्याओं के मामले में भुगतान को पुनर्गठित किया, इसे मुद्रा में परिवर्तित किया, धनवापसी की और पुनर्निर्धारण किया, सेवा का उपयोग करने के लिए प्रतिशत लिखा।

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

भुगतान प्रणाली को एकीकृत करने के लिए, एक डेवलपर की जरूरत है:

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

क्या बदल गया है

एक साल पहले, हमने घरेलू बाजार में काम करना शुरू किया। पहली परियोजनाओं में से एक Sellsay ऐप था । यह उपयोगकर्ताओं को बातचीत में कौशल विकसित करने में मदद करता है, और आपसी पेशेवर सहायता के लिए एक मंच भी है।

आवेदन में मानक कार्यों के अलावा कई विशेषताएं हैं: प्राधिकरण और पंजीकरण, निर्माण और परियोजनाओं का संपादन। सेवा के माध्यम से आप संपर्क कर सकते हैं
एक व्यापार कोच के लिए। यदि आपके पास आवश्यक ज्ञान है, तो आप एक प्रमाण पत्र प्राप्त कर सकते हैं और एक स्वतंत्र प्रशिक्षक बन सकते हैं, घटनाओं और प्रशिक्षणों में भाग ले सकते हैं
आवेदन के रचनाकारों से, पैसा बनाते हैं।

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

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

Yandex.Kassa: एपीआई के पहले संस्करण के साथ काम करना

सिस्टम का विश्लेषण करने के बाद, हम Yandex.Cash पर बस गए: सेवा ने हमें लगभग सभी कार्यक्षमता को लागू करने की अनुमति दी, एक मूल्य पर ग्राहक के लिए उपयुक्त था और ऑनलाइन कैश डेस्क को कनेक्ट करते समय 54-FZ समस्या को हल किया।

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

इसलिए, परीक्षण कुंजी प्राप्त करने के लिए, आपको ऐप्पल स्टोर या Google Play में एप्लिकेशन का लिंक प्रदान करना होगा। यदि आवेदन स्वीकार करने के लिए भुगतान स्वीकृति एक शर्त है तो हमें लिंक कहां से मिला? हम इस समस्या को हल करने में कामयाब रहे, लेकिन तब ऐसी परिस्थितियां थीं जब प्रबंधक द्वारा इसकी सक्रियता के लिए कार्यक्षमता को लागू करना और प्रकाशित करना आवश्यक था।

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

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

लॉन्च से पहले अंतिम सप्ताह नरक में बदल गया। परियोजना को समय पर शुरू करने के लिए, हमें टीम को मजबूत करना था और समय के साथ काम करना था, और यैंडेक्स। इस बीच, हमें घबराहट होने का मौका नहीं छोड़ा।

स्ट्रिप के साथ Yandex.Kassa की तुलना

डेवलपर समुदाय में, स्ट्राइप एकीकरण और भुगतान प्रणाली के साथ काम करने में आसानी में अग्रणी है। वे प्रोग्रामर की देखभाल करने और भुगतान प्रणाली को यथासंभव सुविधाजनक और लचीला बनाने वाले पहले व्यक्ति हैं। इसने डेवलपर्स को न केवल राहत की सांस लेने की अनुमति दी, बल्कि एकीकरण प्रक्रिया की लागत को कम करने और कम करने के लिए।

आप Yandex.Kassa और स्ट्राइप के बीच बहुत कुछ पा सकते हैं। उदाहरण के लिए, दोनों सिस्टम REST- जैसे सिद्धांतों पर बनाए गए हैं, HTTP प्रतिक्रिया कोड का उपयोग करते हैं, CORS का समर्थन करते हैं (और JSON में प्रतिक्रियाएं आती हैं), दोनों ही सुविधा का समर्थन करते हैं। एक "सैंडबॉक्स" है - वास्तविक स्टोर की एक पूरी प्रतिलिपि, और मोड के बीच संक्रमण केवल कुंजी का प्रतिस्थापन है: एपीआई या यूआरएल को बदलने की कोई आवश्यकता नहीं है।

लेकिन एक ही समय में, वे बहुत अलग हैं, और यह दिखाने के लिए कि इन प्रणालियों के अलग-अलग दृष्टिकोण कैसे हैं, हम ठोस उदाहरणों का उपयोग करके कुछ चरणों के कार्यान्वयन पर विचार करेंगे।

चूँकि इस प्रोजेक्ट पर सर्वर भाग Node.js पर लागू किया गया था, इसलिए मैं इसके लिए उदाहरण दूंगा।

हम परियोजना से जुड़ते हैं ।

धारी:

var stripe = require('stripe')('sk_test_...');

Yandeks.Kassa:

  ,    ;

कार्ड विवरण का अनुरोध करें

धारी:

क्लाइंट लाइब्रेरी को उसी तरह से कनेक्ट करें और कार्ड दर्ज करने के लिए फॉर्म के प्रदर्शन के साथ एक टोकन का अनुरोध करें।

 var stripe = Stripe('pk_test_6pRNASCoBOKtIshFeQd4XMUh'); var elements = stripe.elements(); // Create an instance of the card Element var card = elements.create('card', { style: style }); // Add an instance of the card Element into the `card-element` <div> card.mount('#card-element'); // On form submit stripe.createToken(card).then(function(result) { // Send the token to your server stripeTokenHandler(result.token); } );

सर्वर पर

 stripe.charges.create({ amount: 2000, currency: "usd", source: "token from previous step", // obtained with Stripe.js description: "Charge for william.brown@example.com" }, function(err, charge) { // asynchronously called });

Yandeks.Kassa:

   :    ,   .   : <a href="https://money.yandex.ru/eshop.xml?shopId=12345&scid=1234566&sum=3000&customerNumber=73">https://money.yandex.ru/eshop.xml?shopId=12345&scid=1234566&sum=3000&customerNumber=73</a>

सही मायने में, साइट पर भुगतान फ़ॉर्म होना चाहिए। जब उपयोगकर्ता "पे" पर क्लिक करता है, तो यह फ़ॉर्म उपरोक्त पते पर भेजा जाता है और POST विधि का उपयोग करके मापदंडों को पास करता है। लेकिन हमारे पास एक मोबाइल एप्लिकेशन है, इसलिए मुझे WebView में उद्घाटन के साथ सर्वर साइड पर फॉर्म को छोड़ना होगा और एक लिंक तैयार करना होगा।

यह लिंक क्लाइंट को कार्ड विवरण दर्ज करने और भुगतान की पुष्टि करने के लिए दिया गया है। लेकिन यहां हमें एक और आश्चर्य का सामना करना पड़ा: 2017 के अंत में, Yandex.Kassa उत्तरदायी डिजाइन का समर्थन नहीं करता है। सेटिंग्स के साथ विभिन्न जोड़तोड़ के परिणाम नहीं मिले।

डिजाइन मोबाइल एप्लिकेशन के लिए अनुकूल नहीं है

यह पता चला कि भुगतान पृष्ठ की उपस्थिति को अनुकूली मोड में बदलने के लिए, आपको अपने व्यक्तिगत खाते में एक अनुरोध छोड़ने की आवश्यकता है। हमें फिर से तकनीकी सहायता से संपर्क करना पड़ा।

2017 में मोबाइल फोन के लिए हुर्रे, अनुकूलित डिजाइन!

लेकिन केवल क्रेडिट कार्ड से भुगतान के लिए

भुगतान के तथ्य की जाँच करें

धारी:

भुगतान प्रक्रिया के दौरान भुगतान की जाँच की जाती है और त्रुटि के मामले में, एपीआई फ़ंक्शन एक अपवाद को लौटाएगा।

Yandeks.Kassa:

उपयोगकर्ता Yandex.Cash के पक्ष में भुगतान करते हैं, लेकिन उपयोगकर्ता के आवेदन को भुगतान के तथ्य के बारे में अभी तक पता नहीं है। इसलिए, Yandex.Kassa सर्वर को सूचित करना चाहिए कि भुगतान किया गया है। ऐसा करने के लिए, डेवलपर्स को एक WebHook बनाना होगा और Yandex.Cash को कॉन्फ़िगर करना होगा, ताकि वह भुगतान के तथ्य को बताने के लिए WebHook के पतों का उपयोग कर सके।

भुगतान की सर्वर अधिसूचना 2 चरणों में होती है:

भुगतान की संभावना की जाँच करना। हमारा सर्वर सब कुछ चेक करता है, निधियों की कटौती की अनुमति देता है या इनकार करता है, उदाहरण के लिए, सामान की शेष राशि, या कीमतों की शुद्धता की जांच करता है।
भुगतान का पूरा होना। Yandex.Kassa हमारे सर्वर को सूचित करता है कि पैसा डेबिट हो गया है और भुगतान सफल रहा है। इस बिंदु पर, डेटाबेस में भुगतान के तथ्य को ठीक करना आवश्यक है।

लेकिन यहाँ आश्चर्य हमें इंतजार कर रहा है:

पता बदलने के लिए, आपको प्रबंधक को एक अनुरोध भेजने और फिर से प्रतीक्षा करने की आवश्यकता है।
Yandex.Kassa से डेटा की वैधता की जांच के लिए एक विशेष एल्गोरिथ्म को लागू करना आवश्यक है।
सर्वर को कस्टम-जनरेट XML को वापस करना होगा। हम सही उत्तर उत्पन्न करने के लिए एक तैयार मॉड्यूल खोजने में सक्षम थे ।

भुगतान रद्द करें

धारी:

 stripe.refunds.create({ charge: "ch_1BTuEo2eZvKYlo2CSGqKz76n" }, function(err, refund) { // asynchronously called });

Yandeks.Kassa:

     X.509    MWS.     .,        ..

जैसा कि आप अनुमान लगा सकते हैं, समन्वय और कनेक्शन में कुछ समय लगा। यह सुचारू रूप से समय सीमा की सीमाओं से परे चला गया।

कार्ड बचाओ

धारी:

 stripe.customers.create({ email: "paying.user@example.com", source: "src_18eYalAHEMiOZZp1l9ZTjSU0", }, function(err, customer) { // asynchronously called });

Yandeks.Kassa:

हम कार्ड की बचत को रद्द करने और हटाने की क्षमता को लागू करने के नियमों का वर्णन करते हैं। फिर हम Yandex.Kassa सुरक्षा सेवा की समीक्षा के लिए आवेदन भेजते हैं और उत्तर की प्रतीक्षा करते हैं।

यदि उत्तर हां है, तो सफल भुगतान के बाद कार्ड को बचाना और MWS प्रोटोकॉल का उपयोग करके बार-बार भुगतान करना संभव हो जाता है।

प्रलेखन से उदाहरण अनुरोध:

 POST https://server:port/webservice/mws/api/repeatCardPayment DATA: clientOrderId=123456789&invoiceId=2000000123&amount=10.00&cvv=643

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

नतीजा क्या हुआ

यहां तक कि इस तथ्य को ध्यान में रखते हुए कि हमें बहुत सारे अतिरिक्त काम करना था और समर्थन के साथ संवाद करना था, हम न केवल लगभग हर चीज को समय पर पूरा करने में कामयाब रहे, बल्कि अतिरिक्त काम भी किया। रिलीज से एक हफ्ते पहले, Yandex.Kassi API का एक नया संस्करण जारी किया गया था और हमने एक एनपीएम मॉड्यूल बनाया और कोड को फिर से लिखा।

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

हमने रूसी परियोजना में भुगतान प्रणाली को कैसे एकीकृत किया

उन्होंने भुगतान प्रणालियों के साथ कैसे काम किया

क्या बदल गया है

Yandex.Kassa: एपीआई के पहले संस्करण के साथ काम करना

स्ट्रिप के साथ Yandex.Kassa की तुलना

नतीजा क्या हुआ

More articles: