När du behöver en nyckel
Köpknappen fungerar utan någon nyckel alls — den talar med offentliga, projektomfattade slutpunkter. En nyckel är för den andra vägen: anrop du gör från din egen server, där du skapar en checkout eller läser en transaktionstatus i kod. Nycklar finns under ditt projekts API-nycklar-flik.
Skapa en nyckel
Klicka på Skapa nyckel, ge den ett namn du känner igen senare — vanligtvis där den körs, som "Produktionsserver" — och klicka på Generera nyckel. Namnet är bara en etikett för dig; det ändrar inte vad nyckeln kan göra (en nyckel är omfattad av detta projekt).
Kopiera det en gång
Nyckeln visas en gång, direkt efter att du genererat den. Den börjar med cmk_. Kopiera den nu och lagra den någonstans säkert — vi behåller bara en hash, så vi kan inte visa det för dig igen. Förlora det och du skapar helt enkelt en ny och tar bort den gamla.
Behandla nyckeln som ett lösenord. Använd den bara från serverkodutsida, skicka den i Authorization-rubriken som en innehavartoken, och placera aldrig den på en webbsida, ett offentligt arkiv eller något som skickas till en köpares webbläsare. Vem som helst med nyckeln kan agera för ditt projekt.
Använd, lista och återkalla
Sparade nycklar listas efter namn, en maskerad prefix och det datum som skapades. Du ser aldrig hela nyckeln igen — prefixet är bara nog för att skilja dem åt. Papperskorgsikonen återkallar en nyckel omedelbar: all kod som fortfarande använder den börjar få avslag, så rotera genom att skapa den nya nyckeln först, distribuera den, sedan ta bort den gamla.
För vad du kan anropa med nyckeln — att skapa en checkout från din egen kod, hantera händelser och avsöka status — se Använda API:et.