Vender desde tu propia aplicación: la API de pago, los webhooks y los SDK de Skalp
Skalp también es una API. Tu código puede crear pagos, leer pedidos, gestionar productos y suscripciones y comprobar licencias, mientras Skalp sigue siendo el comerciante registrado. Cada evento llega a tu servidor como un webhook firmado.
Claves API con permisos
Crea una clave en el panel y marca solo los permisos que necesita, por ejemplo checkout:read y checkout:write. Las claves de pago se vinculan a una tienda al crearlas. Skalp solo guarda un hash, así que la clave se muestra una vez.
SDK
- Node y entornos edge: el paquete
@skalpgg/sdk en npm. Un solo paquete para pagos, suscripciones, webhooks y comprobación de licencias, con tipos para cada respuesta.
- Go: el módulo
skalp.gg/go.
Webhooks
Skalp envía un POST firmado a tu URL cuando un pedido se paga, se reembolsa o se disputa, cuando cambia una suscripción, y con los cambios de productos, las consultas de clientes y las reseñas. La firma es HMAC-SHA256 en la cabecera Skalp-Signature. Puedes limitar un webhook a los productos que elijas.
Usos habituales
- Una aplicación de escritorio comprueba su clave de licencia al arrancar. Claves de licencia.
- Una web o un launcher abre el pago de Skalp para el usuario que ha iniciado sesión y desbloquea funciones con el webhook de pago.
- Un servidor de juego recoge las compras por sí mismo y las entrega en el juego. Tiendas de servidor.
Preguntas frecuentes
¿Quién aparece en el extracto de la tarjeta del comprador?
Skalp. En las ventas por API, Skalp es el vendedor, así que el cargo lleva el nombre de Skalp y no el de tu tienda.
¿Puedo pasar mis propios datos por el pago?
Sí. Los campos personalizados del pago vuelven en los webhooks y en la API v1.