Pular para o conteúdo
SkinPlata
Kits para desenvolvedores

O SDK Node.js da SkinPlata

ESM ou CommonJS, tipado e sem dependências. Feito para os backends Node em que roda a maioria dos sites de skins.

Node.js 18+Tipos TypeScriptSem dependências skinplata-node-sdk.zip · 14 KB Grátis
Como funciona

O que seus clientes veem

Escolhem "Pagar com skins"

Bem ao lado dos seus outros métodos de pagamento, pelo preço que já estão vendo.

Escolhem as skins e aceitam uma troca

Itens de CS2, Dota 2 e Rust, com preço ao vivo, até cobrir o total.

O pedido é concluído sozinho

Um webhook assinado avisa o Node.js SDK e os USD caem no seu saldo da SkinPlata.

Guia de instalação

No ar em poucos minutos

  1. Criar um projetoNo painel da SkinPlata abra Projetos e adicione seu site. Copie a chave do projeto, os segredos live e de teste e o segredo de assinatura do webhook. Você pode testar enquanto o projeto está em análise.
  2. Adicione o SDKInstale com npm, ou descompacte skinplata-node-sdk.zip no seu projeto e importe.
  3. Crie um pagamentoCrie o client com a chave e o segredo do projeto, crie um pagamento para o pedido e envie o cliente para o pay_url dele.
  4. Processe o webhookNo seu endpoint de webhook verifique o header SkinPlata-Signature com o segredo de assinatura do webhook, leia o pagamento de novo e entregue o pedido uma única vez.
  5. Defina a URL do webhookNo painel da SkinPlata abra seu projeto e informe o endereço desse endpoint como URL do webhook.
  6. Teste e entre em produçãoRode o fluxo com o segredo de teste e depois troque pelo segredo live.
Perguntas frequentes

Perguntas sobre Node.js SDK

O Node.js SDK é grátis?

Sim, o SDK é grátis e o código é aberto para leitura. Na SkinPlata: Taxa de 0% em pagamentos, compras e saques, sem taxa de setup nem mensalidade.

Quando um pagamento é marcado como pago?

Quando a troca é definitiva. A integração confere a assinatura de cada webhook e consulta o pagamento de novo na SkinPlata antes de mudar qualquer coisa, então ninguém consegue falsificar um pagamento pelo navegador.

E a proteção de troca do Steam?

O Steam pode reter itens trocados por até 7 dias. Até lá o pagamento fica em espera e nada é entregue. Quando a retenção termina, ele é concluído sozinho, ou você libera antes no seu painel se confiar no cliente.

Posso testar antes de entrar em produção?

Sim. Seu projeto tem um segredo de teste que funciona enquanto ele ainda está em análise. Os pagamentos de teste usam itens e preços reais, mas nada se move: você simula cada resultado no checkout.