आपको क्या चाहिए
| फ़ील्ड | यह क्या करता है |
|---|---|
| Client ID | API कॉल पर आपके PayPal ऐप की पहचान करता है। secret के साथ जोड़ा गया। |
| Client secret | API प्रमाणीकरण का गुप्त आधा। Client ID के साथ, यह ऑर्डर बनाता है। गुप्त। |
| Webhook ID | उस वेबहुक की पहचान करता है जिसे PayPal साइन करता है, ताकि हम हर डिलीवरी सत्यापित कर सकें। |
| Success URL / Cancel URL | जहां खरीदार भुगतान करने या पीछे हटने के बाद पहुंचता है। |
हम हर फ़ील्ड क्यों मांगते हैं
Client ID
API कॉल पर आपके PayPal ऐप की पहचान करता है। यह केवल तभी काम करता है जब Client secret के साथ जोड़ा जाए।
Client secret
API प्रमाणीकरण का निजी आधा। Client ID के साथ, यह हमें ऑर्डर बनाने देता है, ताकि भुगतान आपके खाते के ज़रिए चले।
Webhook ID
हम कैसे पुष्टि करते हैं कि कोई वेबहुक सचमुच PayPal से है: PayPal हर वेबहुक को एक ID से पहचानता है, और हम इसका उपयोग सीधे PayPal से पूछने के लिए करते हैं कि कोई दिया गया संदेश प्रामाणिक है या नहीं। यह किसी को "paid" इवेंट नकली बनाने से रोकता है।
Success and Cancel URL
सादी सेटिंग: जहां खरीदार भुगतान करने या पीछे हटने के बाद पहुंचता है। गुप्त नहीं।
सेट करें
- PayPal Developer डैशबोर्ड खोलें
developer.paypal.com पर साइन इन करें। PayPal आपको नकली business और buyer खातों के साथ एक मुफ़्त Sandbox देता है, ताकि आप बिना असली पैसा हिलाए टेस्ट कर सकें। यह गाइड Sandbox के साथ चलती है; Live flow बिल्कुल एक जैसा है, बस Sandbox / Live टॉगल (ऊपरी बाएं) पलटें और PayPal for Business खाते का उपयोग करें। डैशबोर्ड से, Apps & Credentials खोलें।
PayPal Developer → Apps & Credentials - एक app बनाएं
API Credentials पेज पर, पुष्टि करें कि Sandbox टॉगल चुना गया है, फिर Create App क्लिक करें (ऊपरी दाएं)।
PayPal → Apps & Credentials → Create App - इसका नाम रखें और Merchant चुनें
एक App Name दर्ज करें (उदाहरण के लिए "Coin Moebius"), Type को Merchant पर छोड़ दें, अपना sandbox business खाता चुनें, और Create App क्लिक करें।
PayPal → Create App - अपना Client ID और Client secret कॉपी करें
PayPal आपका नया app खोलता है। Client ID कॉपी करें और Secret key reveal करके कॉपी करें। (आप API Credentials सूची पर Default Application पंक्ति से भी दोनों कॉपी कर सकते हैं।) उन्हें अलग रख लें।
1. PayPal → API Credentials → your app in the list 2. PayPal → your app → Client ID and Secret Client secret गुप्त है, इसे पासवर्ड की तरह संभालें। sandbox app और live app की अपनी-अपनी जोड़ियां होती हैं, इसलिए उन्हें न मिलाएं।
- एक webhook जोड़ें
app पेज नीचे Sandbox Webhooks section तक स्क्रॉल करें और Add Webhook क्लिक करें। Webhook URL फ़ील्ड में, अपने प्रोजेक्ट का PayPal webhook पता (नीचे) पेस्ट करें। फिर वे events चुनें जो Coin Moebius सुनता है, और Save करें।
- एक बार के भुगतान: CHECKOUT.ORDER.APPROVED, PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.DENIED, PAYMENT.CAPTURE.DECLINED, PAYMENT.CAPTURE.REFUNDED, PAYMENT.CAPTURE.REVERSED, CUSTOMER.DISPUTE.CREATED।
- Subscriptions (केवल तभी जब आप उन्हें बेचते हैं): BILLING.SUBSCRIPTION.ACTIVATED, BILLING.SUBSCRIPTION.UPDATED, BILLING.SUBSCRIPTION.CANCELLED, BILLING.SUBSCRIPTION.PAYMENT.FAILED, PAYMENT.SALE.COMPLETED। अगर आप recurring basis पर billing नहीं कर रहे, तो इन्हें छोड़ दें।
- जल्दी में हैं? All Events चुनना (शीर्ष पर wildcard) भी काम करता है, हम जो उपयोग नहीं करते उसे अनदेखा करते हैं।
https://api.coinmoebius.com/webhook/paypal/<your project id>PayPal → your app → Add webhook आपकी project ID Coin Moebius डैशबोर्ड में project name के नीचे है; इसे ऊपर के पते में डालें। कनेक्टेड provider card (अंतिम चरण) संदर्भ के लिए वही URL दिखाता है।
- Webhook ID कॉपी करें
आपका webhook अब Sandbox Webhooks सूची में दिखाई देता है। इसके बगल में दिखाई देने वाली Webhook ID कॉपी करें। यही Coin Moebius PayPal से पूछने के लिए उपयोग करता है कि हर webhook प्रामाणिक है या नहीं। sandbox में और live में एक अलग webhook पंजीकृत करें।
PayPal → your app → Sandbox Webhooks → Webhook ID - Coin Moebius में वापस: Add provider → PayPal
अपने प्रोजेक्ट में, Providers टैब खोलें, Add provider क्लिक करें, Connect a service चुनें, और PayPal चुनें। अपना Success URL और Cancel URL सेट करें। sandbox credentials के साथ टेस्ट कर रहे हैं? Test (optional) टैब उपयोग करें और वहां अपना Client ID, Client secret, और Webhook ID पेस्ट करें, फिर Save क्लिक करें। सीधे live जाना चाहते हैं? Live टैब उपयोग करें। Test समूह सब-या-कुछ-नहीं है: तीनों फ़ील्ड, या कोई नहीं।
Coin Moebius → Add provider → PayPal - आप कनेक्ट हो गए
PayPal अब आपके Providers टैब पर कनेक्ट होने की तारीख के साथ दिखाई देता है (sandbox credentials उपयोग करने पर TEST टैग के साथ)। Card वही webhook URL दिखाता है जो आपने PayPal में पेस्ट किया, साथ ही Edit और Disconnect।
Coin Moebius → Providers → PayPal (connected) - sandbox buyer से टेस्ट करें
एक टेस्ट checkout के ज़रिए भुगतान करने के लिए, आपको अपना sandbox buyer login चाहिए। PayPal में, Testing Tools → Sandbox Accounts खोलें ताकि आपके नकली Business और Personal खाते दिखें।
PayPal → Testing Tools → Sandbox Accounts - buyer login विवरण प्राप्त करें
Personal (buyer) खाता खोलें और इसकी Login Info देखें: sandbox URL, email, और password। जब कोई टेस्ट checkout भुगतान के लिए पूछे तो sandbox.paypal.com पर उन्हीं से साइन इन करें। कोई असली पैसा नहीं हिलता।
PayPal → Sandbox account → Login Info
कनेक्ट करने के बाद
लाइव होने से पहले एक टेस्ट भुगतान चलाएं:
- एक उत्पाद बनाएं और इसकी Environment को Testing पर सेट करें। यह उत्पाद को आपके sandbox क्रेडेंशियल पर चलाता है, ताकि आप बिना पैसा हिलाए एक पूरा ऑर्डर दे सकें। (अगर आपने sandbox सेट छोड़ दिया, तो एक Testing उत्पाद live पर वापस आ जाता है, इसलिए पहले इसे जोड़ें।)
- अपने प्रोजेक्ट पर इंगित किसी पेज पर बाय बटन रखें (एक स्थानीय HTML फ़ाइल काम करती है)।
- अपने sandbox खरीदार खाते से भुगतान करके चेकआउट पूरा करें।
- Transactions टैब खोलें। एक नई पंक्ति दिखती है, Testing टैग के साथ। जब इसकी स्थिति succeeded तक पहुंचती है, तो आपके क्रेडेंशियल और वेबहुक दोनों शुरू से अंत तक काम कर रहे हैं।
जब आप असली भुगतान के लिए तैयार हों तो उत्पाद की Environment को Live पर बदलें।
समस्या निवारण
Verify से शुरू करें। डैशबोर्ड में, अपने client क्रेडेंशियल जांचने के लिए Verify (या sandbox के लिए Verify test credentials) क्लिक करें।
Verify विफल हो जाता है।
Client ID और Client secret फिर से कॉपी करें। sandbox ऐप और live ऐप की अलग जोड़ियां होती हैं, इसलिए उन्हें न मिलाएं।
भुगतान पूरा होता है पर ऑर्डर pending रहता है।
Webhook ID उसी ऐप और परिवेश से आनी चाहिए जिससे आपके client क्रेडेंशियल हैं। live क्रेडेंशियल को live webhook id चाहिए। पुष्टि करें कि वेबहुक URL मेल खाता है।
इसे शुरू से अंत तक पुष्ट करें।
PayPal Developer Dashboard → Webhooks Simulator: अपने वेबहुक URL पर एक नमूना इवेंट भेजें, फिर ऑर्डर अपडेट होते देखें।
जानना अच्छा है
secret घुमाना. कभी भी एक नया client secret बनाएं, फिर इसे पेस्ट करें। संपादन पर गुप्त फ़ील्ड खाली रहते हैं।
सवाल? Join our Discord