👩🏼‍🚀 🚷 👨🏻‍⚕️ नए यांडेक्स पर स्विच करने के आठ कारण। कैशियर एपीआई ⛲️ ◼️ 👨🏽‍⚖️

अक्टूबर 2017 में, Yandex.Kassi में एक नया भुगतान प्रोटोकॉल और एपीआई का तीसरा संस्करण है। हम पहले से ही बात कर चुके हैं कि हम कैसे और क्यों इस तक पहुंचे, और अब हम उन कारणों को याद करते हैं जिन्हें अभी तक नहीं किया है।

1. कनेक्टिंग भुगतान वास्तव में तेज़ हो गया है

नए एपीआई पर, यह पहले की तुलना में 5-10 गुना अधिक तेजी से होता है, और अब औसत डेवलपर एक ही दिन में अपनी (अच्छी तरह से, या बिल्कुल नहीं) वेबसाइट या एप्लिकेशन से भुगतान कनेक्ट कर सकता है, और पांच में नहीं, जैसा कि पहले था। यह, ज़ाहिर है, काम के उस हिस्से के बारे में है जब सब कुछ सहमत हो जाता है, आवेदन स्वीकृत हो जाते हैं और पहुंच कुंजियाँ प्राप्त होती हैं। लेकिन उसके लिए भी एक दिन काफी है।

और सोशल नेटवर्क पर बेचने वालों के लिए, मेल, एसएमएस या बस एक लिंक द्वारा काम करता है जो निजी संदेशों में भेजा जा सकता है।

2. डेवलपर्स और प्रवेश की शक्ति को बचाओ

पुराने संस्करण को बनाए रखने के लिए, आपको विभिन्न छोटी-छोटी बातों का ध्यान रखना होगा - एपीआई के साथ काम करने के लिए एक स्थिर आईपी पता आवंटित करना, वर्ष में एक बार प्रमाण पत्र बदलना। और पुराने संस्करण में HTTPS SNI मोड के लिए कोई समर्थन नहीं है, जो अब कई होस्टिंग प्रदाताओं की "HTTPS के साथ होस्टिंग" सेवा में मुफ्त (या लगभग मुफ्त में) के लिए शामिल है।

रिफंड, पुष्टि, रद्दीकरण या कार्ड से भुगतान के लिए, प्रोटोकॉल MWS (मर्चेंट वेब सर्विसेज) का उपयोग किया जाता है। एमडब्ल्यूएस की मदद से, एक स्टोर रिफंड कर सकता है, स्थगित भुगतानों की पुष्टि कर सकता है और रद्द कर सकता है, साथ ही क्रेडिट कार्ड द्वारा भुगतान भी दोहरा सकता है (यदि भुगतानकर्ता इसके लिए सहमत हो गया है)। MWS के साथ काम करने के लिए एपीआई के पुराने संस्करण में, स्टोर को Yandex.Money प्रमाणन प्राधिकरण से X.509 प्रमाणपत्र प्राप्त करने की आवश्यकता है, जिसके साथ स्टोर ने Yandex.Money के लिए अनुरोध उत्पन्न किए। अब यह सब बॉक्स से बाहर आता है - आपको बस एक्सेस कीज़ मिलती हैं और आवश्यक भुगतान के तरीकों को लागू करना होता है।

सामान्य तौर पर, एकीकरण प्रक्रिया से कई अनावश्यक चीजें गायब हो गईं, जिन्हें हमें अपने दम पर निपटना पड़ा और डेवलपर्स और प्रवेशकर्ताओं के लिए इस पर समय बिताना पड़ा।

3. केवल REST और अधिक कुछ नहीं

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

तुलना के लिए, आइए रिफंड के पुराने और नए तरीकों को देखें।

पहले, एक डिजिटल हस्ताक्षर के साथ PKCS # 7 प्रारूप का क्रिप्टोग्राफ़िक पैकेज बनाने के लिए, XML 1.0 मानक के अनुसार एक ऑपरेशन को निष्पादित करने के लिए एक ऑर्डर दस्तावेज़ बनाना आवश्यक था, लेकिन प्रमाणन, डेटा संपीड़न और एन्क्रिप्शन की श्रृंखला के बिना। उसके बाद, क्रिप्टोग्राफिक पैकेज के शरीर के साथ या एप्लिकेशन / pkcs-mime माइम प्रकार के माध्यम से अनुलग्नक में HTTP / 1.1 पर एक POST अनुरोध उत्पन्न हुआ था। फिर यह एक छोटा व्यवसाय है - आठ इनपुट मापदंडों को पारित करने के लिए और, सिद्धांत रूप में, सब कुछ तैयार है।

कुल HTTP अनुरोध:

POST /webservice/mws/api/returnPayment HTTP/1.1 Content-Type: application/pkcs7-mime Content-Length: 906 ——-BEGIN PKCS7——- MIAGCSqGSIb3DQEHAqCAMIACAQExCzAJBgUrDgMCGgUAMIAGCSqGSIb3DQEHAaCA JIAEgbE8P3htbCB2ZXJzaW9uPSIxLjAiIGVuY29kaW5nPSJVVEYtOCI/Pg0KPG1h a2VEZXBvc2l0aW9uUmVzcG9uc2UgY2xpZW50T3JkZXJJZD0iMTI5MTExNjIzNDUy OCIgc3RhdHVzPSIwIi6789Jvcj0iMCIgcHJvY2Vzc2VkRFQ9IjIwMTAtMTEtMzBU MTE6MjM6NTQuNjI0WiIgYmFsYW5jZT0iNTQxNDYuNzMiIC8+DQoAAAAAAAAxggF8 MIIBeAIBATB3MGoxCzAJBgNVBAYTAlJVMQ8wDQYDVQQIEwZSdXNzaWExFjAUBgNV BAcTDVN0LlBldGVyc2J1cmcxITAfBgNVBAoTGEludGVybmV0IFdpZGdpdHMgUHR5 IEx0ZDEPMA0GA1UEAxMGc2VydmVyAgkAy2xbdQckXjIwCQYFKw4DAhoFAKBdMBgG CSqGSIb3DQEJAzELBgkqhkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTEwMTEzMDEx MjM1NVowIwYJKoZIhvcNAQkEMRYEFEYNh8glwqIXGR/n6oYrApa8DaO5MA0GCSqG SIb3DQEBAQUABIGAHlgGsYK30RXWBvuQao0V73KIPQE1A6BCg7Y6Iag/xlmZ3rBB kFpszF/O2fB+t84pCHfV15ErZQEkAqIotkEYEgA3hAddEW5+RWUzp+3npHpW5OY7 h3niP5Pj+r0P8EDgHe2j0Zb3dzj2mbwOshZD+FP1IcR8AmiTV3u35C6KAEsAAAAA AAA= ——-END PKCS7——-

और वापसी के लिए अनुरोध स्वयं:

 <returnPaymentRequest clientOrderId="46890" requestDT="2011-07-02T20:38:00.000Z" invoiceId="2000000433" shopId="6689" amount="10.00" currency="643" cause="   " />

एपीआई के नए संस्करण में, पायथन में वापसी इस तरह दिखाई देती है:

 refund = Refund.create({   "amount": {       "value": "2.00",       "currency": "RUB"   },   "payment_id": "21741269-000d-50be-b000-0486ffbf45b0" })

एक स्पष्ट JSON वापस आ जाएगी, जिसे न्यूनतम समय में किसी भी चीज़ के साथ पार्स किया जा सकता है:

 {   "id": "216742f7-0016-50be-b000-078a43a63ae4",   "status": "succeeded",   "amount": {     "value": "2.00",     "currency": "RUB"   },   "created_at": "2017-10-04T19:27:51.407Z",   "payment_id": "21746789-000f-50be-b000-0486ffbf45b0" }

सौंदर्य।

4. विभिन्न भाषाओं और प्रौद्योगिकियों के लिए समर्थन

नए API में मोबाइल डिवाइस , PHP, Python और Node.js. के लिए SDK भी है। आपके बैकएंड लोग जो कुछ भी करते हैं (ठीक है, बहुत ही विदेशी मामलों को छोड़कर), कैशियर के माध्यम से भुगतान जल्दी से जुड़े हुए हैं। यदि कोई व्यक्ति कई महीनों से सक्रिय रूप से पायथन में लिख रहा है, तो वह एकीकरण का सामना करेगा।

पिछले साल, हमने iOS और Android पर मोबाइल एप्लिकेशन के लिए एक लाइब्रेरी जारी की। इसकी मदद से, भुगतान फ़ॉर्म एप्लिकेशन में एम्बेड किए जाते हैं और इसके हिस्से की तरह दिखते हैं (और ना ही कोई WebView)। उपयोगकर्ता Google पे, ऐप्पल पे या सेर्बैंक ऑनलाइन के माध्यम से एक यैंडेक्स.मनी वॉलेट से क्रेडिट कार्ड से ऑर्डर के लिए भुगतान कर सकेंगे।

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

5. शमनवाद के बिना नियमित भुगतान

स्थापना और कॉन्फ़िगरेशन के तुरंत बाद, धन के पूर्व-प्राधिकरण के साथ कार्ड भुगतान से कमाई होगी - वे डिफ़ॉल्ट रूप से एपीआई में निर्मित होते हैं।
आवर्तक भुगतान (कार्ड के साथ और बटुए से दोनों) हैं: आपको उन्हें सुरक्षा सेवा के साथ समन्वयित करने की आवश्यकता है, लेकिन पुराने प्रोटोकॉल में भी ऐसा था। यदि आवर्ती भुगतान अनिवार्य 3D- सिक्योर वाले कार्ड का उपयोग करता है, तो नया API सबसे पहले इसके लिंक को लौटाएगा।
सामान्य तौर पर, सब कुछ सरल हो गया है - यहां भी, आपको MWS के साथ लंबे अनुष्ठान करने की आवश्यकता नहीं है, प्रमाण पत्र प्राप्त करना और अन्य सभी क्रिप्टोकरेंसी हैं।

6. भुगतान की स्थिति में परिवर्तन की स्वचालित सूचनाएं

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

"भुगतान के बाद व्यापारी द्वारा पुष्टि की प्रतीक्षा",
"भुगतान"
"भुगतान के दौरान रद्द या त्रुटि हुई",
"भुगतान लौट आया।"

पुराने प्रोटोकॉल पर, हमें एक जटिल MWS- विधि सूची लिखनी थी, जिसने सूची और आदेशों के गुण दिखाए। 12 पैरामीटर, CSV प्रारूप में प्रतिक्रिया प्राप्त करने के लिए अनुरोध भेजने और एक पेचीदा अवसर के जटिल तर्क:

 status=0;error=0;processedDT=2011-08-02T14:46:58.096+03:00;orderCount=2 shopId;shopName;articleId;articleName;invoiceId;orderNumber;paymentSystemOrderNumber;customerNumber;createdDatetime;paid;orderSumAmount; orderSumCurrencyPaycash;orderSumBankPaycash;paidSumAmount;paidSumCurrencyPaycash;paidSumBankPaycash;receivedSumAmount;receivedSumCurrencyPaycash; receivedSumBankPaycash;shopSumAmount;shopSumCurrencyPaycash;shopSumBankPaycash;paymentDatetime;paymentAuthorizationTime;payerCode;payerAddress;payeeCode; paymentSystemDatetime;avisoReceivedDatetime;avisoStatus;paymentType;agentId;uniLabel;environment 1;" ";2;"-";2000024717776;"2011.08.02 09:07:32";483512879684006008;97881;2011-08-02T08:07:59.148+03:00;true;10.15;643;1003;10.15;643; 1003;10.15;643;1003;10.15;643;1003;2011-08-02T08:07:59.684+03:00;483512879684006008;41003476047679;192.168.1.127;41003131475668;2011-08-02T08:07:59.684+03:00; 2011-08-02T08:07:59.660+03:00;1000;AC;200002;1cd12967-0001-5000-8000-000000034fd8;Live 1;" ";2;"-";2000024717780;2000024717780;483512937773006008;770367;2011-08-02T08:08:57.175+03:00;true;10.00;643;1003;10.00;643; 1003;10.00;643;1003;10.00;643;1003;2011-08-02T08:08:57.773+03:00;483512937773006008;41003494819180;192.168.1.127;41003131475668;2011-08-02T08:08:57.773+03:00; 2011-08-02T08:08:57.730+03:00;1000;AC;200002;1cd129a4-0001-5000-8000-000000034fe1;Live

नए संस्करण में तो। प्रश्न:

 curl https://payment.yandex.net/api/v3/payments/{payment_id} \ -u < >:< > : { "id": "22312f66-000f-5100-8000-18db351245c7", "status": "waiting_for_capture", "paid": true, "amount": {   "value": "2.00",   "currency": "RUB" }, "created_at": "2018-07-18T10:51:18.139Z", "description": " №72", "expires_at": "2018-07-25T10:52:00.233Z", "metadata": {}, "payment_method": {   "type": "bank_card",   "id": "22ebbf66-000f-5000-8000-18db351245c7",   "saved": false,   "card": {     "first6": "555555",     "last4": "4444",     "card_type": "MasterCard"   },   "title": "Bank card *4444" }, "test": false }

7. यह तुरंत स्पष्ट है कि त्रुटि किस बिंदु पर हुई

यदि भुगतान विफल हो गया, तो "कुछ गलत हो गया" के बजाय, नया एपीआई यह स्पष्ट करेगा कि ऐसा क्यों हुआ - उदाहरण के लिए, कार्ड पैसे से भाग गया या उपयोगकर्ता Sberbank Online के माध्यम से भुगतान करना चाहता था, लेकिन यह जुड़ा नहीं था।
कभी-कभी अल्पकालिक "कुछ गलत हो गया" हो सकता है - हम, निश्चित रूप से, उनके साथ लड़ते हैं (मुख्य संपादक नताशा मेरे लिए इशारा करते हैं और अपना अंगूठा दिखाते हैं), लेकिन कभी-कभी विभिन्न बैंकों या अप्रत्याशित सॉफ़्टवेयर व्यवहार के बीच त्रुटि मैपिंग में अंतर की भविष्यवाणी करने के लिए असंभव। यहां तक कि हमारे लिए।
सामान्य तौर पर, यदि भुगतान रद्द हो जाता है, तो एपीआई की प्रतिक्रिया तुरंत स्पष्ट हो जाएगी, जिसके कारण:

 { "id": "22379b7b-000f-5000-9030-1a603a795739", "status": "canceled", "paid": false, "amount": {   "value": "2.00",   "currency": "RUB" }, "created_at": "2018-05-23T15:24:43.812Z", "metadata": {}, "payment_method": {   "type": "bank_card",   "id": "22977a7b-000f-5000-9000-1a603a795129",   "saved": false }, "recipient": {   "account_id": "100001",   "gateway_id": "1000001" }, "test": false, "cancellation_details": {   "party": "payment_network",   "reason": "payment_method_restricted" } }

8. आपके शुरू करने से पहले हर चीज की जाँच की जा सकती है

परीक्षण कुंजी प्राप्त करने और यह देखने के लिए कि सब कुछ कैसे काम करता है, आपको अपने Yandex.Cash खाते में पंजीकरण करने की आवश्यकता है - इसके लिए आपको Yandex और कंपनी TIN पर उपयोगकर्ता नाम की आवश्यकता होगी। प्रश्नावली में, स्व-पंजीकरण चुनें - एक मिनट में एक परीक्षण सर्किट बनाया जाएगा और आप जांच सकते हैं कि भुगतान कैसे होता है।

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

एकीकरण और रखरखाव के सभी चरणों के लिए, हमारे पास रूसी और अंग्रेजी में चरण-दर-चरण मार्गदर्शिका है, साथ ही साथ एक अधिक विस्तृत एपीआई संदर्भ भी है ।

सामान्य तौर पर, नए एपीआई पर स्विच करें, यदि पहले से नहीं है, या यैंडेक्स से कनेक्ट करें। चेकआउट करें - वहां आपकी यात्रा के लिए सब कुछ तैयार है।

नए यांडेक्स पर स्विच करने के आठ कारण। कैशियर एपीआई