Όταν χρειάζεστε ένα κλειδί
Το κουμπί αγοράς λειτουργεί χωρίς καθόλου κλειδί — μιλάει σε δημόσια τελικά σημεία με εύρος έργου. Ένα κλειδί είναι για την άλλη διαδρομή: κλήσεις που κάνετε από τον δικό σας διακομιστή, όπου δημιουργείτε μια checkout ή διαβάζετε την κατάστασή της συναλλαγής σε κώδικα. Τα κλειδιά ζουν κάτω από την καρτέλα API Κλειδιά του έργού σας.
Δημιουργήστε ένα κλειδί
Κάντε κλικ στο Δημιουργία κλειδιού, δώστε του ένα όνομα που θα αναγνωρίσετε αργότερα — συνήθως το σημείο όπου εκτελείται, όπως "Διακομιστής παραγωγής" — και κάντε κλικ στο Δημιουργία κλειδιού. Το όνομα είναι μόνο μια ετικέτα για εσάς· δεν αλλάζει τι μπορεί να κάνει το κλειδί (ένα κλειδί περιορίζεται σε αυτό το έργο).
Αντιγράψτε το μία φορά
Το κλειδί εμφανίζεται μία φορά, αμέσως μετά τη δημιουργία του. Ξεκινάει με cmk_. Αντιγράψτε το τώρα και αποθηκεύστε το κάπου ασφαλές — διατηρούμε μόνο ένα hash, επομένως δεν μπορούμε να σας το εμφανίσουμε ξανά. Χάστε το και απλώς δημιουργήστε ένα νέο και διαγράψτε το παλιό.
Αντιμετωπίστε το κλειδί σαν ένα κωδικό πρόσβασης. Χρησιμοποιήστε το μόνο από κώδικα πλευράς διακομιστή, στείλτε το στην κεφαλίδα Authorization ως bearer token και ποτέ μην το βάλετε σε μια ιστοσελίδα, ένα δημόσιο repo ή τίποτα που σταλθεί στο πρόγραμμα περιήγησης ενός αγοραστή. Οποιοσδήποτε έχει το κλειδί μπορεί να δράσει για το έργό σας.
Χρήση, λίστα και ανάκληση
Τα αποθηκευμένα κλειδιά αναγράφονται κατά όνομα, ένα μασκαρεμένο πρόθεμα και την ημερομηνία δημιουργίας. Ποτέ δεν δείτε το πλήρες κλειδί ξανά — το πρόθεμα είναι μόνο αρκετό για να τα ξεχωρίσετε. Το εικονίδιο κάδου ανακαλεί ένα κλειδί αμέσως: οποιοσδήποτε κώδικας που εξακολουθεί να το χρησιμοποιεί ξεκινάει να απορρίπτεται, οπότε περιστρέψτε δημιουργώντας το νέο κλειδί πρώτο, αναπτύσσοντάς το, στη συνέχεια διαγράφοντας το παλιό.
Για αυτό που μπορείτε να καλέσετε με το κλειδί — δημιουργία μιας checkout από τον δικό σας κώδικα, χειρισμό γεγονότων και ψηφοφορία κατάστασης — δείτε Χρήση του API.