Aus Ihrer eigenen App verkaufen: Checkout-API, Webhooks und SDKs von Skalp
Skalp ist auch eine API. Ihr Code kann Checkouts erstellen, Bestellungen lesen, Produkte und Abos verwalten und Lizenzen prüfen, während Skalp der Merchant of Record bleibt. Jedes Ereignis erreicht Ihren Server als signierter Webhook.
API-Schlüssel mit Scopes
Erstellen Sie einen Schlüssel im Dashboard und wählen Sie nur die Scopes aus, die er braucht, etwa checkout:read und checkout:write. Checkout-Schlüssel werden beim Erstellen an einen Shop gebunden. Skalp speichert nur einen Hash, der Schlüssel wird also einmal angezeigt.
SDKs
- Node und Edge-Runtimes: das Paket
@skalpgg/sdk auf npm. Ein Paket für Checkout, Abos, Webhooks und Lizenzprüfung, mit Typen für jede Antwort.
- Go: das Modul
skalp.gg/go.
Webhooks
Skalp schickt einen signierten POST an Ihre URL, wenn eine Bestellung bezahlt, erstattet oder angefochten wird, wenn sich ein Abo ändert, sowie bei Produktänderungen, Kundenanfragen und Bewertungen. Die Signatur ist HMAC-SHA256 im Header Skalp-Signature. Sie können einen Webhook auf ausgewählte Produkte beschränken.
Typische Setups
- Eine Desktop-App prüft beim Start ihren Lizenzschlüssel. Lizenzschlüssel.
- Eine Website oder ein Launcher öffnet den Skalp-Checkout für den angemeldeten Nutzer und schaltet Funktionen beim Bezahlt-Webhook frei.
- Ein Gameserver holt Käufe selbst ab und liefert sie im Spiel aus. Server-Shops.
Häufige Fragen
Wer steht auf der Kartenabrechnung des Käufers?
Skalp. Bei Verkäufen über die API ist Skalp der Verkäufer, die Belastung trägt also den Namen Skalp und nicht den Ihres Shops.
Kann ich eigene Daten durch den Checkout reichen?
Ja. Benutzerdefinierte Checkout-Felder kommen in Webhooks und in API v1 zurück.