PayPal API से मिलें

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


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

पेपल कई भुगतान विधियों की पेशकश करता है जो किसी व्यक्ति को पीपी से अपरिचित भ्रमित नहीं कर सकते हैं:

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

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

आवर्ती भुगतान
यह विधि आपको उपयोगकर्ता के खाते से धन वापस लेने की अनुमति देगा (उदाहरण के लिए, इसका उपयोग सदस्यता के लिए मासिक भुगतान में किया जाता है)।

थोक भुगतान
बल्क भुगतान आपको कई खातों के बीच प्राप्त धन को साझा करने की अनुमति देगा।

अनुकूली भुगतान
यह विकल्प मूल रूप से पिछले एक के रूप में एक ही कार्य करता है, लेकिन कुछ मतभेदों के साथ (मुझे पहले से ही उल्लेख किया गया है कि पेपल एपीआई भ्रमित और तामझाम से भरा हुआ है)।

इस सूची को पूर्ण नहीं कहा जा सकता है, लेकिन यह धन प्राप्त करने के सबसे लोकप्रिय तरीकों को सूचीबद्ध करता है (और अधिक - प्रलेखन में आपका स्वागत है)।


PayPal HTTP के माध्यम से डेटा ट्रांसमिट करने के लिए दो प्रारूपों का समर्थन करता है: NVP और SOAP। NVP नाम-मूल्य जोड़ी के लिए एक संक्षिप्त नाम है, इस बीच SOAP का अर्थ है सिंपल ऑब्जेक्ट एक्सेस प्रोटोकॉल। मैं केवल एनवीपी के बारे में बात करूंगा, क्योंकि यह सोप की तुलना में बहुत अधिक लचीला है।

भाग 1 में सूचीबद्ध सभी विधियों के अपने पैरामीटर हैं, लेकिन उन सभी में कई समान बुनियादी पैरामीटर हैं जो एपीआई खाते की पहचान करने और इसे अधिकृत करने के लिए प्रेषित हैं:

• USER
  आपके PayPal API खाते का नाम;
  
• PWD
  आपके पेपाल एपीआई खाते का पासवर्ड;
  
• VERSION
  एनवीपी एपीआई की संस्करण संख्या, उदाहरण के लिए 74.0 (लेखन के समय नवीनतम संस्करण);
  
• SIGNATURE
  इलेक्ट्रॉनिक सिग्नेचर पेपाल एपीआई। पैरामीटर का उपयोग केवल तभी किया जाना चाहिए जब आप प्राधिकरण के लिए एक प्रमाण पत्र का उपयोग कर रहे हों;
  

आवश्यक मापदंडों में से अंतिम METHOD , जो घोषणा करता है कि हम धन का उपयोग करने की किस विधि का उपयोग करेंगे।

HTTPS प्रोटोकॉल का उपयोग करके अनुरोध प्रेषित किए जाते हैं। उदाहरण के लिए, हम अपने सरल अनुरोध को बनाने के लिए cURL का उपयोग करेंगे, और फिर हम पूरी प्रक्रिया को एक अलग वर्ग में रखेंगे:

 class Paypal { /** *     * @var array */ protected $_errors = array(); /** *  API *    ,        * @var array */ protected $_credentials = array( 'USER' => 'seller_1297608781_biz_api1.lionite.com', 'PWD' => '1297608792', 'SIGNATURE' => 'A3g66.FS3NAf4mkHn3BDQdpo6JD.ACcPc4wMrInvUEqO3Uapovity47p', ); /** * ,     *   - https://api-3t.paypal.com/nvp *  - https://api-3t.sandbox.paypal.com/nvp * @var string */ protected $_endPoint = 'https://api-3t.sandbox.paypal.com/nvp'; /** *  API * @var string */ protected $_version = '74.0'; /** *   * * @param string $method      * @param array $params   * @return array / boolean Response array / boolean false on failure */ public function request($method,$params = array()) { $this -> _errors = array(); if( empty($method) ) { // ,     $this -> _errors = array('    '); return false; } //    $requestParams = array( 'METHOD' => $method, 'VERSION' => $this -> _version ) + $this -> _credentials; //    NVP $request = http_build_query($requestParams + $params); //  cURL $curlOptions = array ( CURLOPT_URL => $this -> _endPoint, CURLOPT_VERBOSE => 1, CURLOPT_SSL_VERIFYPEER => true, CURLOPT_SSL_VERIFYHOST => 2, CURLOPT_CAINFO => dirname(__FILE__) . '/cacert.pem', //   CURLOPT_RETURNTRANSFER => 1, CURLOPT_POST => 1, CURLOPT_POSTFIELDS => $request ); $ch = curl_init(); curl_setopt_array($ch,$curlOptions); //   , $response     API $response = curl_exec($ch); // ,      cURL if (curl_errno($ch)) { $this -> _errors = curl_error($ch); curl_close($ch); return false; } else { curl_close($ch); $responseArray = array(); parse_str($response,$responseArray); //  ,   NVP   return $responseArray; } } } 

कृपया ध्यान दें कि मैंने SSL सत्यापन के लिए CA प्रमाणपत्र का उपयोग किया है। प्रमाणपत्र फ़ाइल को cURL वेबसाइट पर पाया जा सकता है। जहाँ आपने इसे डाउनलोड किया है, उस स्थान के अनुसार प्रमाणपत्र का मार्ग बदलना याद रखें।

अनुरोध की प्रतिक्रिया एनवीपी प्रारूप में होगी, और मैंने इसे एक सरणी में तोड़ दिया। ACK पैरामीटर अनुरोध को संसाधित करने के परिणाम को इंगित करता है: अनुरोध सफल होने पर, Success या Success मामले में अनुरोध विफल होने पर Error या Warning ।

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


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

संपूर्ण भुगतान निम्न एल्गोरिथम के अनुसार होता है:

1. हम ट्रांसफर विवरण भेजते हुए, पेपाल से एक्सेस टोकन का अनुरोध करते हैं;
2. यदि टोकन प्राप्त होता है, तो हम प्राप्त टोकन का उपयोग करके उपयोगकर्ता को PayPal वेबसाइट पर पुनर्निर्देशित करते हैं;
3. उपयोगकर्ता पेपाल प्लेटफॉर्म पर भुगतान करता है या रद्द करता है, और फिर हमारी वेबसाइट पर वापस भेज दिया जाता है;
4. हम भुगतान को पूरा करते हैं, या तो जब उपयोगकर्ता वापस भेज दिया जाता है, या त्वरित भुगतान अधिसूचना (IPN) के माध्यम से।

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

अनुरोध में निम्नलिखित पैरामीटर निर्दिष्ट किए जाने चाहिए:

• METHOD
  यहां आपको यह निर्दिष्ट करने की आवश्यकता है कि हम किस भुगतान विधि को चुनते हैं (उदाहरण के लिए SetExpressCheckout );
  
• RETURNURL
  सफल भुगतान के बाद उपयोगकर्ता को इसका पता पुनः निर्देशित किया जाएगा;
  
• CANCELURL
  यदि भुगतान के दौरान कोई त्रुटि हुई है तो इसका पता उपयोगकर्ता को पुनर्निर्देशित किया जाएगा;
  
• PAYMENTREQUEST_0_AMT
  हस्तांतरण के लिए कुल राशि। आपको दो दशमलव संख्या निर्दिष्ट करने की आवश्यकता है, एक अवधि ( . ) द्वारा अलग किया गया है। वैकल्पिक रूप से, आप हजारों को अलग करने के लिए अल्पविराम ( , ) का उपयोग कर सकते हैं;
  
• PAYMENTREQUEST_0_ITEMAMT
  कुल लागत, आयोग, शुल्क, शिपिंग लागत और अन्य ext सहित नहीं। खर्च। यदि कोई भी उपलब्ध नहीं है, तो इस पैरामीटर का मान PAYMENTREQUEST_0_AMT के मान से मेल खाना चाहिए।
  

हम अतिरिक्त पैरामीटर भी पारित कर सकते हैं जो भुगतान के बारे में जानकारी के सेट का विस्तार करेंगे, कुछ मापदंडों में डिफ़ॉल्ट मान हैं:

• PAYMENTREQUEST_0_CURRENCYCODE
  यह पैरामीटर उस मुद्रा को निर्धारित करता है जिसमें सभी ऑपरेशन किए जाएंगे। आपको तीन अंकों का कोड निर्दिष्ट करना होगा। डिफ़ॉल्ट मूल्य USD ;
  
• PAYMENTREQUEST_0_SHIPPINGAMT
  आदेश की शिपिंग लागत;
  
• PAYMENTREQUEST_0_TAXAMT
  सभी आयोगों की पूरी राशि (यदि आवश्यक हो तो आदेश में कई पद हैं और प्रत्येक आयोग का अपना आयोग है);
  
• PAYMENTREQUEST_0_DESC
  अनुवाद का विवरण।
  

यदि उपयोगकर्ता एक साथ कई उत्पादों के लिए भुगतान करता है, तो सुविधा के लिए आप उत्पादों की एक सूची बना सकते हैं:

• L_PAYMENTREQUEST_0_NAMEm
  उत्पाद का नाम;
  
• L_PAYMENTREQUEST_0_DESCm
  उत्पाद विवरण;
  
• L_PAYMENTREQUEST_0_AMTm
  इकाई लागत;
  
• L_PAYMENTREQUEST_0_QTYm
  माल की मात्रा।
  

चर m एक विशिष्ट उत्पाद की पहचान करता है (उसी उत्पाद पर लागू मापदंडों के लिए समान चर सूचकांक का उपयोग करें)।

कई और वैकल्पिक पैरामीटर हैं जो आप आसानी से प्रलेखन में पा सकते हैं।

हम SetExpressCheckout अनुरोध को उत्पन्न करने के लिए उस फ़ंक्शन का उपयोग करते हैं जो हमने पहले भाग 2 में लिखा था:

 //    $requestParams = array( 'RETURNURL' => 'http://www.yourdomain.com/payment/success', 'CANCELURL' => 'http://www.yourdomain.com/payment/cancelled' ); $orderParams = array( 'PAYMENTREQUEST_0_AMT' => '500', 'PAYMENTREQUEST_0_SHIPPINGAMT' => '4', 'PAYMENTREQUEST_0_CURRENCYCODE' => 'GBP', 'PAYMENTREQUEST_0_ITEMAMT' => '496' ); $item = array( 'L_PAYMENTREQUEST_0_NAME0' => 'iPhone', 'L_PAYMENTREQUEST_0_DESC0' => 'White iPhone, 16GB', 'L_PAYMENTREQUEST_0_AMT0' => '496', 'L_PAYMENTREQUEST_0_QTY0' => '1' ); $paypal = new Paypal(); $response = $paypal -> request('SetExpressCheckout',$requestParams + $orderParams + $item); 

यदि अनुरोध सफल रहा, तो हमें पेपाल की प्रतिक्रिया में TOKEN पैरामीटर में टोकन प्राप्त होगा।

 if(is_array($response) && $response['ACK'] == 'Success') { //     $token = $response['TOKEN']; header( 'Location: https://www.paypal.com/webscr?cmd=_express-checkout&token=' . urlencode($token) ); } 

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


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

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

GetExpressCheckoutDetails फ़ंक्शन को केवल एक टोकन की आवश्यकता होती है, और DoExpressCheckoutPayment को कई अतिरिक्त पैरामीटर की आवश्यकता होती है:

• PAYMENTREQUEST_0_PAYMENTACTION
  यह पैरामीटर हमारे द्वारा आवश्यक कार्रवाई को निर्धारित करता है। यदि हम SetExpressCheckout फ़ंक्शन में किसी अन्य क्रिया को निर्दिष्ट नहीं करते हैं, तो मूल्य को Sale संकेत देना चाहिए (संभावित मानों में Authorization और Capture );
  
• PAYERID
  यह पैरामीटर पेपल खाते के लिए विशिष्ट पहचानकर्ता को निर्दिष्ट करता है। यह टोकन की तरह, उपयोगकर्ता द्वारा पुनर्निर्देशित किए जाने पर ( PayerID पैरामीटर में) URL पर वापस आ जाएगा।
  

 if( isset($_GET['token']) && !empty($_GET['token']) ) { //   //   ,    . //        ,  ,    $paypal = new Paypal(); $checkoutDetails = $paypal -> request('GetExpressCheckoutDetails', array('TOKEN' => $_GET['token'])); //   $requestParams = array( 'PAYMENTREQUEST_0_PAYMENTACTION' => 'Sale', 'PAYERID' => $_GET['PayerID'] ); $response = $paypal -> request('DoExpressCheckoutPayment',$requestParams); if( is_array($response) && $response['ACK'] == 'Success') { //    //    ID ,      $transactionId = $response['PAYMENTINFO_0_TRANSACTIONID']; } } 

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

यह पद्धति एक्सप्रेस भुगतान की तुलना में थोड़ी सरल है, क्योंकि सभी उपयोगकर्ता सहभागिता आपकी वेबसाइट पर होती है, और हमें API: DoDirectPayment केवल एक ही अनुरोध करना होगा।

लेकिन आपको इस तथ्य पर ध्यान देना चाहिए कि आपको कुछ और अनुरोध करने होंगे यदि आप एक निश्चित अवधि (उदाहरण के लिए, जब आप डिलीवरी सेवा के लिए माल पहुंचाने के लिए इंतजार कर रहे हैं) के बाद उपयोगकर्ता के खाते से पैसा लिखना चाहते हैं। इसके लिए, हम Authorization और Capture के तरीकों का उपयोग करेंगे, जिसके बारे में मैं आपको नहीं बताऊंगा, लेकिन फिर भी उनके अस्तित्व के बारे में जानना आवश्यक है।


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

प्रत्यक्ष भुगतान के मुख्य पैरामीटर:

• METHOD
  जाहिर है, DoDirectPayment को इस पैरामीटर में निर्दिष्ट किया जाना चाहिए;
  
• IPADDRESS
  इस पैरामीटर में, आपको खरीदार का आईपी पता निर्दिष्ट करना होगा। PHP का उपयोग करते हुए, हम इसे $_SERVER['REMOTE_ADDR'] का उपयोग करके आसानी से प्राप्त कर सकते हैं, हालाँकि, हमें थोड़ा और काम करना होगा यदि आपके सर्वर पर PHP एक मध्यस्थ के माध्यम से बाहरी दुनिया के साथ संचार करता है (उदाहरण के लिए, यदि nginx का उपयोग करें);
  
• PAYMENTACTION
  यह पैरामीटर वांछित कार्रवाई निर्धारित करता है। जैसा कि पहले कई बार कहा गया था, हमें इसमें Sale निर्दिष्ट करने की आवश्यकता है।
  

बैंक कार्ड विवरण:

• CREDITCARDTYPE
  बैंक कार्ड का प्रकार (जैसे वीज़ा, मास्टर कार्ड और अन्य);
  
• ACCT
  बैंक कार्ड नंबर (क्या आपको ये अद्भुत संक्षिप्त विवरण भी पसंद हैं?);
  
• EXPDATE
  MMYYYY प्रारूप में कार्ड की समाप्ति तिथि (दो अंक एक महीने, चार अंक एक वर्ष);
  
• CVV2
  तीन से चार अंकों के कोड को सुरक्षा कोड के रूप में भी जाना जाता है। यह कार्ड के पीछे इंगित किया गया है।
  

खरीदार विवरण:

• FIRSTNAME, LASTNAME
  अलग-अलग क्षेत्रों में खरीदार का नाम और उपनाम। वैकल्पिक रूप से, आप उपयोगकर्ता के ईमेल को EMAIL पैरामीटर में भी स्थानांतरित कर सकते हैं;
  
• CITY, STATE, COUNTRYCODE, ZIP
  शहर, राज्य, दो अंकों वाला देश कोड , ज़िप कोड, इन सभी क्षेत्रों की आवश्यकता है;
  
• STREET, STREET2
  पते के लिए दो लाइनें। केवल पहले की आवश्यकता है।
  

पते का सत्यापन सत्यापन प्रणाली (AVS) द्वारा किया जाएगा। यदि गलत पते के कारण लेन-देन अस्वीकार कर दिया गया था, तो एक विशिष्ट त्रुटि आपको वापस कर दी जाएगी।

भुगतान विवरण निर्दिष्ट करने के लिए पैरामीटर एक्सप्रेस भुगतान के लिए समान हैं, लेकिन नामों में कुछ अंतरों के साथ (आपको AMT , ITEMAMT , CURRENCYCODE , SHIPPINGAMT , TAXAMT और DESC का उपयोग करने की आवश्यकता है)। विवरण के लिए दस्तावेज देखें।

उसी तरह, आपको उत्पाद जानकारी दर्ज करने के लिए निम्न मापदंडों का उपयोग करना चाहिए: L_NAMEm , L_DESCm , L_AMTm और L_QTYm । चर एम का उपयोग प्रत्येक व्यक्तिगत उत्पाद के लिए मापदंडों को परिसीमित करने के लिए किया जाता है (क्रम में क्रमांकित वस्तुओं के लिए 0, 1 और आगे के साथ बदलें)। अधिक संपूर्ण सूची के लिए दस्तावेज़ देखें।


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

 $requestParams = array( 'IPADDRESS' => $_SERVER['REMOTE_ADDR'], 'PAYMENTACTION' => 'Sale' ); $creditCardDetails = array( 'CREDITCARDTYPE' => 'Visa', 'ACCT' => '4929802607281663', 'EXPDATE' => '062012', 'CVV2' => '984' ); $payerDetails = array( 'FIRSTNAME' => 'John', 'LASTNAME' => 'Doe', 'COUNTRYCODE' => 'US', 'STATE' => 'NY', 'CITY' => 'New York', 'STREET' => '14 Argyle Rd.', 'ZIP' => '10010' ); $orderParams = array( 'AMT' => '500', 'ITEMAMT' => '496', 'SHIPPINGAMT' => '4', 'CURRENCYCODE' => 'GBP' ); $item = array( 'L_NAME0' => 'iPhone', 'L_DESC0' => 'White iPhone, 16GB', 'L_AMT0' => '496', 'L_QTY0' => '1' ); $paypal = new Paypal(); $response = $paypal -> request('DoDirectPayment', $requestParams + $creditCardDetails + $payerDetails + $orderParams + $item ); if( is_array($response) && $response['ACK'] == 'Success') { $transactionId = $response['TRANSACTIONID']; } 

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

$response चर, जिसमें paypalApiRequest() फ़ंक्शन से प्रतिक्रिया शामिल है, में ACK पैरामीटर में एक मान हो सकता है जो Success अनुरूप नहीं है, अर्थात्:

• Success
  ऑपरेशन सफल रहा;
  
• SuccessWithWarning
  ऑपरेशन सफल रहा, लेकिन सही नहीं। एपीआई ने यह समझाते हुए एक संदेश लौटाया कि क्या तय करना है;
  
• Failure
  ऑपरेशन सफल नहीं था, प्रतिक्रिया में विफलता की व्याख्या करने वाले त्रुटि कोड हैं;
  
• FailureWithWarning
  ऑपरेशन सफल नहीं था, प्रतिक्रिया में त्रुटि कोड और संदेश शामिल हैं जिन्हें आपको देखना चाहिए।
  

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

पेपाल द्वारा दी गई त्रुटियां प्रतिक्रिया में चार मापदंडों में संलग्न हैं:

• L_ERRORCODE0
  एक डिजिटल त्रुटि कोड जिसे पेपाल त्रुटि कोड सूची का उपयोग करके डिक्रिप्ट किया जा सकता है;
  
• L_SHORTMESSAGE0
  समस्या को समझाने वाला एक लघु संदेश;
  
• L_LONGMESSAGE0
  समस्या की व्याख्या करने वाला एक विस्तृत संदेश;
  
• L_SEVERITYCODE0
  कठिनाई कोड। मुझे नहीं पता कि इसकी आवश्यकता क्यों है, इसके बारे में प्रलेखन चुप है, ठीक है, ठीक है, चलो इसके बारे में भूल जाते हैं।
  

पैरामीटर्स के अंत में वेरिएबल 0 एरर की सीरियल नंबर है, जो हुई (यदि कई एरर हैं, तो वेरिएबल में 1, 2, और इसी तरह) होंगे।

यहाँ सबसे आम त्रुटियों की एक छोटी सूची है:

• 10002
  एपीआई प्राधिकरण डेटा ने सत्यापन पारित नहीं किया;
  
• 81***
  आवश्यक मापदंडों में से एक गायब है;
  
• 104**
  एक पैरामीटर में एक अमान्य मान पारित किया गया था।
  

कुछ पेपाल त्रुटियों में आपके विवरण में निजी जानकारी शामिल हो सकती है जिसे आप उपयोगकर्ताओं को दिखाना नहीं चाहते हैं। इस कारण से, उपयोगकर्ताओं को सलाह दी जाती है कि वे त्रुटि प्रदर्शन बंद कर दें, भले ही यह उपयोगी हो।

ज्यादातर मामलों में, मैं आपको निम्नलिखित करने की सलाह दूंगा:

1. त्रुटियों की एक सफेद सूची बनाएं जो उपयोगकर्ताओं को दिखाई जा सकती हैं (उदाहरण के लिए, क्रेडिट कार्ड पर गलत डेटा);
2. सुनिश्चित करें कि त्रुटियों को वापस करते समय, उन्होंने सफेद सूची के खिलाफ जांच की;
3. यदि इस सूची में कोई त्रुटि नहीं है, तो उपयोगकर्ता को कुछ सामान्य त्रुटि प्रदर्शित करने की आवश्यकता है, उदाहरण के लिए, "आपके भुगतान को संसाधित करते समय एक त्रुटि हुई। कुछ मिनट प्रतीक्षा करें या इस समस्या को हल करने के लिए हमसे संपर्क करें। ”

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

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

मूल लेख: पेपल एपीआई , एरन गैल्परिन के साथ शुरुआत, 5 सितंबर, 2011।

मैं वास्तव में आशा करता हूं कि यह अनुवाद वास्तव में व्यापकता के लिए उपयोगी होगा। दूसरे शब्दों में, मैं अभी भी 24 सितंबर की छुट्टी के लिए उम्मीद नहीं खोता हूं। रुको और देखो।


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