Sprzedaż z własnej aplikacji: checkout API, webhooki i SDK Skalpa

Skalp to też API. Twój kod może tworzyć checkouty, czytać zamówienia, zarządzać produktami i subskrypcjami oraz sprawdzać licencje, a sprzedawcą dalej jest Skalp. Każde zdarzenie trafia na twój serwer jako podpisany webhook.

Klucze API z zakresami

Utwórz klucz w panelu i zaznacz tylko te zakresy, których potrzebuje, np. checkout:read i checkout:write. Klucze do checkoutu są przy tworzeniu przypisywane do jednego sklepu. Skalp przechowuje tylko hash, więc klucz widzisz raz.

SDK

Node i środowiska edge: pakiet @skalpgg/sdk na npm. Jeden pakiet do checkoutu, subskrypcji, webhooków i sprawdzania licencji, z typami dla każdej odpowiedzi.
Go: moduł skalp.gg/go.

Webhooki

Skalp wysyła podpisany POST na twój URL, gdy zamówienie zostanie opłacone, zwrócone albo objęte sporem, gdy zmieni się subskrypcja, a także przy zmianach produktów, zapytaniach klientów i opiniach. Podpis to HMAC-SHA256 w nagłówku Skalp-Signature. Webhook możesz ograniczyć do wybranych produktów.

Typowe zastosowania

Aplikacja desktopowa sprawdza klucz licencji przy starcie. Klucze licencji.
Strona albo launcher otwiera checkout Skalpa dla zalogowanego użytkownika i odblokowuje funkcje po webhooku o płatności.
Serwer gry sam odbiera zakupy i wydaje je w grze. Sklepy serwerów.

Najczęstsze pytania

Kto widnieje na wyciągu karty kupującego?

Skalp. Przy sprzedaży przez API sprzedawcą jest Skalp, więc obciążenie ma nazwę Skalp, a nie twojego sklepu.

Czy mogę przekazać własne dane przez checkout?

Tak. Pola niestandardowe w checkoucie wracają w webhookach i API v1.