Pular para o conteúdo principal

Node.js

Instalação

npm install @pague-dev/sdk-node

Configuração

import { Pdev } from '@pague-dev/sdk-node';

// Opção 1: Passar a API key diretamente
const pdev = new Pdev('pd_live_sua_api_key');

// Opção 2: Usar variável de ambiente PDEV_API_KEY
const pdev = new Pdev();

Recursos

Criar cobrança PIX com dados do pagador:
await pdev.pix.create({ amount, description, customer });
Criar QR code PIX estático (sem dados do pagador):
await pdev.pix.createStaticQrCode({ amount, description });
Gerenciar clientes:
await pdev.customers.create({ name, document });
await pdev.customers.list({ page, limit, search });
Organizar pagamentos por projeto:
await pdev.projects.create({ name, color });
await pdev.projects.list({ page, limit });
Criar saques via PIX:
// Com conta bancária salva
await pdev.withdrawals.create({ amount: 150.75, bankAccountId: 'uuid' });

// Com PIX avulso (inline)
await pdev.withdrawals.create({
  amount: 150.75,
  pixKey: '12345678901',
  pixKeyType: 'cpf',
  holderName: 'João da Silva',
  holderDocument: '12345678901',
});
Consultar transações:
await pdev.transactions.get(id);
Consultar dados da conta, empresa e saldo:
const { data } = await pdev.account.get();

data.account.id;                      // ID da conta
data.account.status;                  // 'approved', 'pending', ...
data.company?.cnpj;                   // CNPJ da empresa
data.balance.available.amountFormatted; // Saldo disponível em reais
data.balance.held.amountFormatted;     // Saldo bloqueado em reais
data.balance.total.amountFormatted;    // Saldo total em reais
Validar assinatura e processar notificações de eventos:
import { verifyWebhookSignature, parseWebhook } from '@pague-dev/sdk-node';

// Validar assinatura
const signature = req.headers['x-webhook-signature'];
const isValid = verifyWebhookSignature(rawBody, signature, 'seu_webhook_secret');

// Parsear payload
const event = parseWebhook(rawBody);

Repositórios

SDK Node.js

Código fonte e documentação do SDK

SDK PHP

SDK para PHP pela comunidade

Exemplo Completo

Aplicação React demonstrando o uso do SDK