Vendere dalla tua app: API di pagamento, webhook e SDK di Skalp
Skalp è anche un'API. Il tuo codice può creare pagamenti, leggere ordini, gestire prodotti e abbonamenti e controllare licenze, mentre il merchant of record resta Skalp. Ogni evento arriva al tuo server come webhook firmato.
Chiavi API con permessi
Crea una chiave nella dashboard e spunta solo i permessi che le servono, per esempio checkout:read e checkout:write. Le chiavi di pagamento vengono collegate a un negozio quando le crei. Skalp ne salva solo l'hash, quindi la chiave viene mostrata una volta sola.
SDK
- Node e runtime edge: il pacchetto
@skalpgg/sdk su npm. Un solo pacchetto per pagamenti, abbonamenti, webhook e controllo delle licenze, con i tipi per ogni risposta.
- Go: il modulo
skalp.gg/go.
Webhook
Skalp invia una POST firmata al tuo URL quando un ordine viene pagato, rimborsato o contestato, quando cambia un abbonamento, e per modifiche ai prodotti, richieste di assistenza e recensioni. La firma è HMAC-SHA256 nell'header Skalp-Signature. Puoi limitare un webhook ai prodotti che scegli.
Configurazioni tipiche
- Un'app desktop controlla la sua chiave di licenza all'avvio. Chiavi di licenza.
- Un sito o un launcher apre il pagamento Skalp per l'utente collegato e sblocca le funzioni quando arriva il webhook di pagamento.
- Un server di gioco recupera da solo gli acquisti e li consegna in gioco. Negozi per server.
Domande frequenti
Chi compare nell'estratto conto della carta dell'acquirente?
Skalp. Nelle vendite tramite API il venditore registrato è Skalp, quindi l'addebito porta il nome di Skalp, non quello del tuo negozio.
Posso far passare dati miei attraverso il pagamento?
Sì. I campi personalizzati del pagamento tornano nei webhook e nell'API v1.