Verkopen vanuit je eigen app: de checkout-API, webhooks en SDK's van Skalp
Skalp is ook een API. Je code kan checkouts aanmaken, bestellingen lezen, producten en abonnementen beheren en licenties controleren, terwijl Skalp de merchant of record blijft. Elk event komt als ondertekende webhook op je server binnen.
API-sleutels met scopes
Maak een sleutel aan in het dashboard en vink alleen de scopes aan die hij nodig heeft, bijvoorbeeld checkout:read en checkout:write. Checkout-sleutels worden bij het aanmaken aan één winkel gekoppeld. Skalp bewaart alleen een hash, dus de sleutel wordt één keer getoond.
SDK's
- Node en edge-runtimes: het pakket
@skalpgg/sdk op npm. Eén pakket voor checkout, abonnementen, webhooks en licentiecontroles, met types voor elk antwoord.
- Go: de module
skalp.gg/go.
Webhooks
Skalp stuurt een ondertekende POST naar je URL als een bestelling betaald, terugbetaald of betwist wordt, als een abonnement verandert, en bij productwijzigingen, supportvragen en feedback. De handtekening is HMAC-SHA256 in de header Skalp-Signature. Je kunt een webhook beperken tot de producten die je kiest.
Veelvoorkomende opzetten
- Een desktop-app controleert bij het opstarten zijn licentiesleutel. Licentiesleutels.
- Een website of launcher opent de Skalp-checkout voor de ingelogde gebruiker en ontgrendelt functies bij de betaalde webhook.
- Een gameserver haalt aankopen zelf op en levert ze in de game. Serverwinkels.
Vragen die mensen stellen
Wie staat er op het kaartafschrift van de koper?
Skalp. Bij verkopen via de API is Skalp de verkoper van record, dus de afschrijving draagt de naam van Skalp, niet die van je winkel.
Kan ik eigen gegevens door de checkout meesturen?
Ja. Eigen checkoutvelden komen terug in webhooks en API v1.