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);
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