WebMoney API के साथ काम करें

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

आपके विनम्र सेवक ने मॉड्यूल बिज़नेस :: WebMoney लिखा, जो एक मुफ्त लाइसेंस के तहत वितरित किया जाता है और सिस्टम के आधिकारिक पर्ल-इंटरफ़ेस की स्थिति प्राप्त करता है।

कनेक्टिंग बिजनेस :: वेबमनी - सब कुछ, हमेशा की तरह, आश्चर्य के बिना

सबसे पहले, CPAN से मॉड्यूल स्थापित करें:

 # perl -MCPAN -e 'इंस्टॉल करें बिजनेस :: वेबमनी'

मॉड्यूल को स्थापित करने के बाद, एपीआई का उपयोग करने वाली स्क्रिप्ट में निम्नलिखित पंक्ति जोड़ें:

 व्यवसाय का उपयोग करें :: WebMoney;

मॉड्यूल को काम करने के लिए, आपको एक गुप्त कुंजी और प्रमाण पत्र की आवश्यकता होती है, जिसे वेबमनी कीपर लाइट में पंजीकरण के बाद ब्राउज़र से PKCS12 फ़ाइल (-p12) के रूप में निर्यात किया जाता है। वेबमनी कीपर क्लासिक की कुंजी उपयुक्त नहीं हैं - मॉड्यूल उनके साथ काम करने का समर्थन नहीं करता है (हालांकि एक वर्कअराउंड है - अंतिम पैराग्राफ देखें)। P12 फ़ाइल का पथ और इसका पासवर्ड, निर्माण पैरामीटर के रूप में निर्दिष्ट हैं:

 मेरे $ wm = व्यवसाय :: WebMoney-> नया (
         p12_file => '/path/to/your/certificate.p12',
         p12_pass => 'certificate_password',
 );

पहला चेक है कि हमारे पास कितना पैसा बचा है

सबसे पहले, आइए देखें कि हमारे पास कौन-कौन से वॉलेट हैं और उनमें कितना पैसा है:

 मेरा $ रेस = $ wm-> get_balance (
         reqn => ++ $ reqn,
         wmid => '123456789012',
 ) या मर $ wm-> असत्य;

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

Wmid पैरामीटर आपकी Webmoney ID है। यदि आपके मुख्य WMID की अन्य WMID तक पहुंच है, तो आप उनमें से किसी के वॉलेट को देख सकते हैं। Get_balance मेथड वॉलेट की एक सूची के लिए एक लिंक देता है, जिसमें से प्रत्येक के लिए उसका नाम (pursename फ़ील्ड), मुद्रा (desc फ़ील्ड) और शेष धन (राशि फ़ील्ड) प्राप्त होता है।

एक ऑनलाइन स्टोर के लिए - हम एक चालान जारी करेंगे, भुगतान सत्यापित करेंगे, पैसे वापस करेंगे

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

सबसे पहले, हम एक चालान जारी करेंगे (व्यापारी का उपयोग करते समय, यह स्वचालित रूप से किया जाता है, और इस चरण को छोड़ दिया जाना चाहिए):

 मेरा $ रेस = $ wm-> चालान (
         reqn => ++ $ reqn,
         आदेश => $ आदेश,
         customerwmid => $ contragent_wmid,
         storepurse => $ my_purse,
         राशि => 1,000,000,
         desc => 'एक लाख भुगतान करो, और तुम खुश रहोगे'
 ) या मर $ wm-> असत्य;

आदेश हमारे अपने डेटाबेस में खाता संख्या है। customerwmid चालान किए गए ग्राहक का WMID है। storepurse वह वॉलेट है जिसके लिए हम पैसे का इंतजार कर रहे हैं। राशि - राशि, उतर - विवरण।

अब हम समय-समय पर $ datestart - $ datefinish के लिए हमारे द्वारा जारी किए गए चालानों की एक सूची का अनुरोध करेंगे, और उनके लिए भुगतान को नियंत्रित करेंगे:

 मेरा $ रेस = $ wm-> get_out_invoices (
         reqn => ++ $ reqn,
         पर्स => $ my_purse,
         डेटास्टार्ट => $ डेटास्टार्ट,
         datefinish => $ datefinish,
 ) या मर $ रे-> असतत;

हैश सरणी का संदर्भ दिया गया है, हम प्रत्येक के राज्य क्षेत्र की जांच करते हैं। यदि 0 है, तो बिल का भुगतान अभी तक नहीं किया गया है। यदि 2, तो बिल का भुगतान किया जाता है - आप एक सेवा प्रदान कर सकते हैं यदि हमने पहले से ऐसा नहीं किया है। 1 - बिल को संरक्षण के साथ भुगतान किया गया था, 3 - भुगतान करने से इनकार कर दिया। Wmtranid फ़ील्ड वह लेनदेन आईडी है जिसका बिल भुगतान किया गया था। वह अभी भी हमारे लिए उपयोगी है।

यदि हम एक अप्रमाणित सेवा के लिए पैसा वापस करना चाहते हैं, तो यह money_back विधि को कॉल करने के लिए पर्याप्त है:

 मेरा $ रेस = $ wm-> money_back (
         reqn => ++ $ reqn,
         inwmtranid => $ wmtranid,
         राशि => $ राशि,
 ) या मर $ wm-> असत्य;

हम लेन-देन की आईडी को inwmtranid फ़ील्ड में स्थानांतरित करते हैं, जिसमें हमें पैसे का भुगतान किया गया था, और राशि में, भुगतान राशि। खरीदार को पैसा लौटा दिया जाएगा, और (ध्यान!) 0.8% कमीशन के बिना।

और अंत में, हम खरीद के लिए धन्यवाद देंगे (ज़ाहिर है, यह सिर्फ संभावनाओं का एक प्रदर्शन है। ग्राहकों को स्पैम की आवश्यकता नहीं है:

 मेरा $ Res = $ wm-> संदेश (
         reqn => ++ $ reqn,
         रिसीवरwmid => $ contragent_wmid,
         संदेश संदेश => 'संदेश विषय',
         संदेश पाठ => 'संदेश पाठ',
 ) या मर $ wm-> असत्य;

एपीआई एक्सेस कनेक्ट करें

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

मुख्य सुरक्षा

ज्यादातर मामलों में, आप युद्ध सर्वर पर मुख्य वॉलेट कुंजी को बिछाने के बिना कर सकते हैं। इसे वेबमनी पावर ऑफ अटॉर्नी मैकेनिज्म के जरिए हासिल किया जा सकता है। आप एक अलग WMID बना सकते हैं, बिलिंग और भुगतान नियंत्रण को मुख्य WMID की ओर से सौंप सकते हैं, और यहां तक ​​कि अगर कुंजी से समझौता किया जाता है, तो आपका पैसा सुरक्षित रहेगा।