Vendre depuis votre propre application : l'API de paiement, les webhooks et les SDK de Skalp
Skalp est aussi une API. Votre code peut créer des paiements, lire les commandes, gérer produits et abonnements et vérifier des licences, pendant que Skalp reste le marchand officiel. Chaque événement arrive sur votre serveur sous forme de webhook signé.
Des clés API avec portées
Créez une clé dans le tableau de bord et ne cochez que les portées dont elle a besoin, par exemple checkout:read et checkout:write. Les clés de paiement sont liées à une boutique dès leur création. Skalp n'en stocke qu'un hachage, la clé ne s'affiche donc qu'une fois.
SDK
- Node et environnements edge : le paquet
@skalpgg/sdk sur npm. Un seul paquet pour le paiement, les abonnements, les webhooks et la vérification de licence, typé pour chaque réponse.
- Go : le module
skalp.gg/go.
Webhooks
Skalp envoie un POST signé vers votre URL quand une commande est payée, remboursée ou contestée, quand un abonnement change, ainsi que lors des modifications de produits, des demandes clients et des avis. La signature est un HMAC-SHA256 dans l'en-tête Skalp-Signature. Vous pouvez limiter un webhook aux produits de votre choix.
Usages courants
- Une application de bureau vérifie sa clé de licence au démarrage. Clés de licence.
- Un site ou un launcher ouvre le paiement Skalp pour l'utilisateur connecté et débloque des fonctions au webhook de paiement.
- Un serveur de jeu récupère lui-même les achats et les livre en jeu. Boutiques de serveur.
Questions fréquentes
Quel nom apparaît sur le relevé de carte de l'acheteur ?
Skalp. Pour les ventes via l'API, Skalp est le vendeur : le débit porte le nom de Skalp, pas celui de votre boutique.
Puis-je faire passer mes propres données par le paiement ?
Oui. Les champs personnalisés du paiement reviennent dans les webhooks et l'API v1.