nimbuu-pay

SDK oficial do Nimbuu Pay — PIX pra apps feitos com IA.

API limpa, sandbox-first, tipada de ponta a ponta. Use no backend — nunca exponha a API key no front-end.

npm install nimbuu-pay

Uso

import { NimbuuPay } from "nimbuu-pay";

const nimbuu = new NimbuuPay(process.env.NIMBUU_API_KEY!);

const charge = await nimbuu.charges.create({
  amount: 4990, // centavos
  customer: { name: "Cliente", document: "12345678909" },
});

console.log(charge.pix.qr_code); // copia-e-cola

Por padrão o SDK aponta pra produção (https://api.nimbuu.com). A sk_test_... já roda em sandbox (PIX mock, zero dinheiro real). Pra apontar pra um facade local:

const nimbuu = new NimbuuPay(apiKey, { baseUrl: "http://localhost:4242" });

Cobranças

await nimbuu.charges.create({ amount, customer, description?, expiresIn?, metadata?, idempotencyKey? });
await nimbuu.charges.retrieve(id);
await nimbuu.charges.list();

Valores sempre em centavos (4990 = R$ 49,90), mínimo 100.

Webhooks

await nimbuu.webhooks.create({ url, events?, description? }); // o `secret` só vem na criação — guarde
await nimbuu.webhooks.list();
await nimbuu.webhooks.del(id);

Validar a assinatura do webhook (use o corpo cru da requisição, não o objeto já parseado):

import { verifyWebhook } from "nimbuu-pay";

const ok = verifyWebhook(rawBody, req.headers["nimbuu-signature"], process.env.NIMBUU_WEBHOOK_SECRET!);
if (!ok) return res.status(400).end();

Docs

Referência completa da API, MCP e exemplos: https://pay.nimbuu.com/docs

Licença

MIT