Loja própria pela API e pelo SDK
Use o checkout do Plasma numa loja feita sob medida ou com IA, com API Keys, envio de produtos, link de checkout e webhooks de pedido.
Para quem é
Para a loja que não roda em Shopify, WooCommerce ou Nuvemshop: um site próprio, uma loja montada com ferramentas de IA (Lovable, Bolt, v0, Cursor) ou qualquer sistema que você mesmo programa. A loja continua sendo sua; o Plasma cuida do checkout, do pagamento e do pós-venda.
Você integra de dois jeitos, com o mesmo resultado:
- SDK para Node.js e TypeScript, com tipos prontos.
- API REST direta, de qualquer linguagem.
Passo a passo
Escolha a integração personalizada
No painel, abra Aplicativos e escolha Checkout Customizado. Dê um nome à integração, como Minha loja.
Gere as API Keys
Abra API Keys no menu lateral e crie um par de chaves: a pública (pk_) e a secreta (sk_). Existem chaves de teste e de produção, e a loja pode ter uma de cada ativa.
A chave secreta aparece uma vez só. Guarde num lugar seguro e nunca coloque no código que roda no navegador.
Mande os produtos para o Plasma
Cadastre no painel, em Produtos, ou envie pela API em POST /api/sdk/products. Os valores vão sempre em centavos inteiros: R$ 79,90 é 7990.
Crie o checkout a partir do carrinho
Quando o comprador fechar o carrinho, crie a sessão em POST /api/sdk/checkout/create-link e mande o comprador para o checkoutUrl da resposta.
Use sempre o checkoutUrl que a API devolve, sem montar o endereço por conta própria. É o Plasma que decide se o checkout abre no seu domínio próprio ou no domínio de reserva, conforme o certificado dele esteja pronto ou não.
Receba os webhooks de pedido
Cadastre a URL do seu sistema para receber os eventos, como o pedido pago. Para validar a assinatura, registre o endpoint pela API (POST /api/sdk/webhooks/endpoints), que devolve o segredo uma vez.
Cada entrega chega com o cabeçalho X-PLASMA-Signature no formato sha256=<hex>, com o prefixo. Compare com esse formato, senão toda entrega parece inválida.
Integração com IA
Se a loja é feita com um assistente de código, o guia de integração com IA traz prompts prontos para colar, na ordem certa: sondar a API, montar catálogo e carrinho, e receber o webhook.
Integração com IA
Prompts prontos e o roteiro completo para o seu assistente de código.
Documentação da API
Autenticação, produtos, pedidos, checkout e webhooks, com exemplos.
Problemas comuns
A API responde 401 com chaves certas. Não misture ambientes: chave pública de teste (pk_test_) com secreta de produção (sk_live_) é recusada.
A API recusa as API Keys da loja. As chaves só valem para loja com a integração Checkout Customizado. Loja conectada à Shopify, ao WooCommerce ou à Nuvemshop usa a sincronização da plataforma.
O preço chegou errado. Valor com casas decimais em vez de centavos inteiros é recusado. Converta para centavos antes de enviar.