Skip to content
SkinPlata
EN
Sign in Sign up
Developer kits

The SkinPlata Node.js SDK

ESM or CommonJS, typed, no dependencies. Built for the Node backends most skin sites run on.

Download for Node.js SDK Setup guide
Node.js 18+TypeScript typesNo dependencies skinplata-node-sdk.zip · 14 KB Free
How it works

What your customers see

They choose Pay with skins

Right next to your other payment methods, at the price they already see.

They pick skins and accept one trade

CS2, Dota 2 and Rust items, priced live, until the total is covered.

The order completes on its own

A signed webhook tells Node.js SDK, and USD lands on your SkinPlata balance.

Setup guide

Live in a few minutes

  1. Create a projectIn your SkinPlata dashboard open Projects and add your site. Copy the project key, the live and test secrets and the webhook signing secret. You can test while the project is in review.
  2. Add the SDKInstall it with npm, or unzip skinplata-node-sdk.zip into your project and import it.
  3. Create a paymentCreate the client with your project key and secret, create a payment for the order and send the customer to its pay_url.
  4. Handle the webhookOn your webhook endpoint verify the SkinPlata-Signature header with your webhook signing secret, read the payment again and fulfil the order once.
  5. Set the webhook URLIn the SkinPlata dashboard open your project and enter the address of that endpoint as the Webhook URL.
  6. Test, then go liveRun the flow with your test secret, then swap in the live secret.
FAQ

Node.js SDK questions

Is the Node.js SDK free?

Yes, the SDK is free and open to read. 0% fees on payments, purchases and payouts. No setup or monthly fee.

When is a payment marked as paid?

When the trade is final. The integration checks the signature of every webhook and reads the payment again from SkinPlata before it changes anything, so nobody can fake a payment from the browser.

What about Steam trade protection?

Steam can hold traded items for up to 7 days. Until then the payment waits on hold and nothing is delivered. When the hold ends it completes on its own, or you release it early in your dashboard if you trust the customer.

Can I test before going live?

Yes. Your project has a test secret that works while it is still in review. Test payments use real items and prices, but nothing moves: you play every outcome from the checkout.

More integrations

Also works with

All plugins & integrations