जब आपको एक कुंजी की आवश्यकता है
खरीद बटन कोई कुंजी के बिना काम करता है — यह सार्वजनिक, प्रोजेक्ट-स्कोप किए गए समापन बिंदु से बात करता है। एक कुंजी दूसरे पथ के लिए है: आपके स्वयं के सर्वर से कॉल जो आप करते हैं, जहाँ आप एक चेकआउट बनाते हैं या कोड में लेनदेन की स्थिति पढ़ते हैं। कुंजियाँ आपकी परियोजना के API Keys टैब के अंतर्गत रहती हैं।
एक कुंजी बनाएं
Create key पर क्लिक करें, इसे एक नाम दें जिसे आप बाद में पहचानेंगे — आमतौर पर जहाँ यह चलता है, जैसे "Production server" — और Generate key पर क्लिक करें। नाम केवल आपके लिए एक लेबल है; यह नहीं बदलता है कि कुंजी क्या कर सकती है (एक कुंजी इस परियोजना के लिए स्कोप की गई है)।
इसे एक बार कॉपी करें
कुंजी एक बार दिखाई जाती है, आपके द्वारा इसे जनरेट करने के तुरंत बाद। यह cmk_ से शुरू होता है। इसे अभी कॉपी करें और इसे कहीं सुरक्षित रखें — हम केवल एक हैश रखते हैं, इसलिए हम इसे आपको फिर से नहीं दिखा सकते। इसे खो दें और आप बस एक नई कुंजी बनाते हैं और पुरानी को हटाते हैं।
कुंजी को एक पासवर्ड की तरह व्यवहार करें। इसे केवल सर्वर-पक्ष कोड से उपयोग करें, इसे Authorization हेडर में एक वाहक टोकन के रूप में भेजें, और इसे कभी वेब पेज, सार्वजनिक रेपो, या कुछ भी न रखें जो खरीदार के ब्राउज़र में भेजा जाता है। कोई भी जिसके पास कुंजी है आपकी परियोजना के लिए कार्य कर सकता है।
उपयोग, सूची, और रद्द
सहेजी गई कुंजियाँ नाम, एक मुखौटा उपसर्ग, और बनाई गई तारीख से सूचीबद्ध हैं। आप पूर्ण कुंजी फिर से कभी नहीं देखते — उपसर्ग सिर्फ उन्हें अलग बताने के लिए काफी है। ट्रैश आइकन तुरंत एक कुंजी को रद्द करता है: कोई भी कोड अभी भी इसका उपयोग कर रहा है अस्वीकृति शुरू हो जाता है, इसलिए नई कुंजी बनाकर घुमाएं, इसे तैनात करें, फिर पुरानी को हटाएं।
जो कुछ आप कुंजी के साथ कॉल कर सकते हैं — अपने स्वयं के कोड से एक चेकआउट बनाना, घटनाओं को संभालना, और पोलिंग स्थिति — Using the API देखें।