sdk.mdx

title	SDK
description	SDKs oficiais para integração com a API pague.dev

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: ```typescript await pdev.pix.create({ amount, description, customer }); ``` Criar QR code PIX estático (sem dados do pagador): ```typescript await pdev.pix.createStaticQrCode({ amount, description }); ``` Gerenciar links de pagamento: ```typescript await pdev.charges.create({ name, amount, paymentMethods }); await pdev.charges.list({ page, limit }); await pdev.charges.get(id); ``` Gerenciar clientes: ```typescript await pdev.customers.create({ name, document }); await pdev.customers.list({ page, limit, search }); ``` Organizar pagamentos por projeto: ```typescript await pdev.projects.create({ name, color }); await pdev.projects.list({ page, limit }); ``` Criar saques via PIX: ```typescript // 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: ```typescript await pdev.transactions.get(id); ``` Consultar dados da conta, empresa e saldo: ```typescript 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: ```typescript 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

Código fonte e documentação do SDK SDK para PHP pela comunidade Aplicação React demonstrando o uso do SDK