Продажи из собственного приложения: API оплаты, вебхуки и SDK Skalp
Skalp это ещё и API. Ваш код может создавать оплаты, читать заказы, управлять товарами и подписками и проверять лицензии, а merchant of record при этом остаётся Skalp. Каждое событие приходит на Ваш сервер подписанным вебхуком.
API-ключи с правами
Создайте ключ в панели и отметьте только нужные ему права, например checkout:read и checkout:write. Ключи оплаты при создании привязываются к одному магазину. Skalp хранит только хеш, поэтому ключ показывается один раз.
SDK
- Node и edge-среды: пакет
@skalpgg/sdk в npm. Один пакет для оплаты, подписок, вебхуков и проверки лицензий, с типами для каждого ответа.
- Go: модуль
skalp.gg/go.
Вебхуки
Skalp отправляет подписанный POST на Ваш URL, когда заказ оплачен, возвращён или оспорен, когда меняется подписка, а также при изменениях товаров, обращениях в поддержку и отзывах. Подпись HMAC-SHA256 передаётся в заголовке Skalp-Signature. Вебхук можно ограничить выбранными товарами.
Типичные схемы
- Десктопное приложение проверяет лицензионный ключ при запуске. Лицензионные ключи.
- Сайт или лаунчер открывает оплату Skalp для вошедшего пользователя и открывает функции по вебхуку об оплате.
- Игровой сервер сам забирает покупки и выдаёт их в игре. Магазины серверов.
Частые вопросы
Кто указан в выписке по карте покупателя?
Skalp. При продажах через API официальным продавцом выступает Skalp, поэтому в списании стоит имя Skalp, а не Вашего магазина.
Можно ли передать через оплату свои данные?
Да. Пользовательские поля оплаты возвращаются в вебхуках и в API v1.