QIWI और उदाहरणों में नया REST प्रोटोकॉल

नमस्ते।
मैं लंबे समय से हैबर का पाठक हूं और अक्सर यहां मेरे सवालों के जवाब मिलते हैं। लेकिन ऐसा हुआ कि जवाब नहीं मिल सका। और कहीं नहीं।
और कार्य इस प्रकार था। QIWI सिस्टम के लिए एक नया (REST) ​​प्रोटोकॉल लागू करें। मुझे परीक्षण, त्रुटि, प्रबंधक और सहायक टीम के साथ संचार का उपयोग करके, सही समाधान खोजने के लिए कई दिन बिताने पड़े कहीं भी कोई उदाहरण नहीं हैं, हालांकि कार्य इतना मुश्किल नहीं है।
इस पोस्ट में, मैं उन उदाहरणों को साझा करना चाहता हूं जो मैंने बहुत याद किए। आशा है कि यह किसी की मदद करता है।
मुझे तुरंत कहना होगा कि मैं पेंट नहीं करूंगा, चबाऊंगा और विस्तार से बताऊंगा। केवल वही मूल होगा, जिसे मैं आवश्यक मानता हूं। फिर भी, हर किसी की अपनी प्राथमिकताएँ और लक्ष्य होते हैं।
सबसे पहले आपको अपना स्टोर रजिस्टर करना होगा http://ishopnew.qiwi.ru/
कनेक्शन मेथड्स सेक्शन में रजिस्टर करने के बाद, आपको न्यू प्रोटोकॉल आइटम मिलेगा। वहां आप नए प्रोटोकॉल का एपीआई विवरण डाउनलोड कर सकते हैं।

अनुरोध भेजने के लिए, मैंने cURL का उपयोग किया।
यहाँ है कि यह कैसे था:

$requestType = 'POST'; //  REST    $url = 'some url'; //     $parameters = array(); //      $loginPass = $id . ':' . $password; // ID   (    ) $headers = array( "Accept: text/json", "Content-Type: application/x-www-form-urlencoded; charset=utf-8" ); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC); curl_setopt($ch, CURLOPT_USERPWD, $loginPass); if ($requestType != 'GET') { curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $requestType); curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($parameters)); } $httpResponse = curl_exec($ch); if (!$httpResponse) { //  ,   echo curl_error($ch).'('.curl_errno($ch).')'; return false; } $httpResponseAr = json_decode($httpResponse); return $httpResponseAr->response; 

मुझे लगता है कि सब कुछ सरल और स्पष्ट है।

अब कौन से ऑपरेशन किए जा सकते हैं।

• एक उपयोगकर्ता बिलिंग
• खाता स्थिति अनुरोध
• कॉल फॉरवर्डिंग
• अवैतनिक चालान रद्द करें
• भुगतान किए गए खाते पर धनवापसी करें
• वापसी की स्थिति जांचें

प्रलेखन सब कुछ के बारे में विस्तृत है। मैं सिर्फ कुछ चीजों पर ध्यान केंद्रित करता हूं जिन्होंने मेरे विकास को बाधित किया।

मैं प्रत्येक ऑपरेशन के लिए अलग से वर्णन करूंगा।

1) उपयोगकर्ता बिलिंग

 $requestType = 'PUT'; $url = 'https://w.qiwi.com/api/v2/prv/{prv_id}/bills/{bill_id}'; // {prv_id} –   ,    ID . // {bill_id} –   ,          . $parameters = array( 'user' => 'tel:+79999999999', 'amount' => 0.1, 'ccy' => 'RUB', 'comment' => ' QIWI', 'pay_source' => 'qw', 'lifetime' => date('c', $timePlusHour), 'prv_name' => 'QIWI', ); 

मापदंडों के साथ, सब कुछ स्पष्ट है।

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

 $requestType = 'GET'; $url = 'https://w.qiwi.com/api/v2/prv/{prv_id}/bills/{bill_id}'; //   $parameters = array(); 

3) बिल का भुगतान करने के लिए अग्रेषित करना
सफल बिलिंग के बाद, आपको उपयोगकर्ता को भुगतान पृष्ठ पर पुनर्निर्देशित करना होगा। यहाँ cURL का उपयोग नहीं किया गया है, बस एक पुनर्निर्देशित किया गया है।

 $url = 'https://w.qiwi.com/order/external/main.action?shop={prv_id }&transaction={bill_id}'; $url .= '&successUrl=' . $successUrl; $url .= '&failUrl=' . $failUrl; // {prv_id}  {bill_id}     . // $successUrl  $failUrl         . 

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

 $requestType = 'PATCH'; $url = 'https://w.qiwi.com/api/v2/prv/{prv_id}/bills/{bill_id}'; //   $parameters = array( 'status' => 'rejected' ); 

5) भुगतान किए गए खाते का रिफंड
आप धनवापसी का अनुरोध कर सकते हैं।

 $requestType = 'PUT'; $url = 'https://w.qiwi.com/api/v2/prv/{prv_id}/bills/{bill_id}/refund/{refund_id}'; //  ,  {refund_id}    $parameters = array( 'amount' => $amount ); 

6) रिटर्न स्टेटस चेक करें
आपको ऊपर वर्णित अनुरोध के लिए रिटर्न की स्थिति भी जांचनी होगी।

 $requestType = 'GET'; $url = 'https://w.qiwi.com/api/v2/prv/{prv_id}/bills/{bill_id}/refund/{refund_id}'; //  ,  {refund_id}         $parameters = array(); 

प्रलेखन में सर्वर प्रतिक्रिया का विस्तार से वर्णन किया गया है।

आपको दो POST अनुरोध हैंडलर भी बनाने होंगे, जिसके बारे में मैंने पैराग्राफ 4 में लिखा था। अनुरोध कई मापदंडों को भेजेगा जिन्हें संसाधित करने की आवश्यकता होगी।

1. बिल_िद = बिल -१
2. दर्जा = अदा
3. त्रुटि = ०
4. राशि = 1.00
5. उपयोगकर्ता = tel% 3A% 2B79031811737
6. prv_name = परीक्षण
7. सिसी = आरयूबी
8. टिप्पणी = परीक्षण
9. कमांड = बिल

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

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

मुझे उम्मीद है कि इस संदेश ने मुझे उन लोगों की थोड़ी मदद की जो अपनी परियोजना में नए प्रोटोकॉल का उपयोग करने जा रहे हैं। आखिरकार, वह उन सभी देशों से भुगतान प्राप्त करने के अवसर का वादा करता है जहां QIWI है।