Vendendo pelo seu próprio app: a API de checkout, os webhooks e os SDKs da Skalp
A Skalp também é uma API. O seu código pode criar checkouts, ler pedidos, gerenciar produtos e assinaturas e verificar licenças, enquanto a Skalp continua sendo a vendedora oficial. Todo evento chega ao seu servidor como um webhook assinado.
Crie uma chave no painel e marque só os escopos de que ela precisa, por exemplo checkout:read e checkout:write. As chaves de checkout são vinculadas a uma loja na criação. A Skalp guarda só um hash, então a chave aparece uma única vez.
SDKs
- Node e ambientes edge: o pacote
@skalpgg/sdk no npm. Um pacote só para checkout, assinaturas, webhooks e verificação de licença, com tipos para cada resposta.
- Go: o módulo
skalp.gg/go.
Webhooks
A Skalp envia um POST assinado para a sua URL quando um pedido é pago, estornado ou disputado, quando uma assinatura muda, e também em mudanças de produto, dúvidas de clientes e avaliações. A assinatura é HMAC-SHA256 no cabeçalho Skalp-Signature. Você pode limitar um webhook aos produtos que escolher.
Usos comuns
- Um app desktop verifica a chave de licença ao iniciar. Chaves de licença.
- Um site ou launcher abre o checkout da Skalp para o usuário logado e libera recursos no webhook de pagamento.
- Um servidor de jogo busca as compras sozinho e as entrega dentro do jogo. Lojas de servidor.
Perguntas frequentes
Quem aparece na fatura do cartão do comprador?
A Skalp. Nas vendas pela API, a Skalp é a vendedora, então a cobrança sai com o nome da Skalp e não o da sua loja.
Posso passar os meus próprios dados pelo checkout?
Sim. Os campos personalizados do checkout voltam nos webhooks e na API v1.