Перейти к содержимому
SkinPlata
Инструменты для разработчиков

Node.js SDK от SkinPlata

ESM или CommonJS, типизация, без зависимостей. Для Node-бэкендов, на которых работает большинство скин-сайтов.

Node.js 18+Типы TypeScriptБез зависимостей skinplata-node-sdk.zip · 14 KB Бесплатно
Как это работает

Что видят ваши клиенты

Клиент выбирает «Оплатить скинами»

Рядом с другими способами оплаты, по той же цене, которую клиент уже видит.

Выбирает скины и принимает один трейд

Предметы CS2, Dota 2 и Rust по актуальным ценам — пока не наберётся вся сумма.

Заказ завершается сам

Node.js SDK получает подписанный вебхук, а USD поступают на ваш баланс SkinPlata.

Инструкция по настройке

Запуск за несколько минут

  1. Создать проектВ личном кабинете SkinPlata откройте «Проекты» и добавьте сайт. Скопируйте ключ проекта, боевой и тестовый секреты и секрет подписи вебхуков. Тестировать можно, пока проект на проверке.
  2. Подключите SDKУстановите через npm или распакуйте skinplata-node-sdk.zip в проект и импортируйте.
  3. Создайте платёжСоздайте клиент с ключом и секретом проекта, создайте платёж для заказа и отправьте клиента на его pay_url.
  4. Обработка вебхукаНа своём эндпоинте вебхука проверьте заголовок SkinPlata-Signature секретом подписи вебхуков, перечитайте платёж и выполните заказ один раз.
  5. Укажите URL вебхукаВ личном кабинете SkinPlata откройте проект и укажите адрес этого эндпоинта в поле «URL вебхука».
  6. Протестируйте и запускайтеПройдите весь сценарий с тестовым секретом, затем замените его боевым.
FAQ

Вопросы о Node.js SDK

Node.js SDK бесплатный?

Да, SDK бесплатный, а его код открыт для чтения. Тарифы SkinPlata: 0% комиссии на платежи, покупки и выплаты, без платы за подключение и абонентской платы.

Когда платёж отмечается оплаченным?

Когда трейд окончательный. Интеграция проверяет подпись каждого вебхука и перечитывает платёж в SkinPlata, прежде чем что-либо менять, поэтому подделать оплату из браузера невозможно.

А как же защита трейда Steam?

Steam может удерживать переданные предметы до 7 дней. До тех пор платёж ждёт на холде и ничего не выдаётся. Когда холд закончится, платёж завершится сам — или подтвердите его досрочно в личном кабинете, если доверяете клиенту.

Можно ли протестировать до запуска?

Да. У проекта есть тестовый секрет, который работает, пока проект ещё на проверке. Тестовые платежи используют реальные предметы и цены, но ничего не передаётся: любой исход можно смоделировать прямо на странице оплаты.