Node.js

npm install github:anthonymengottii/alpa-nodejs-sdk

import AlpaClient from '@alpa/alpa-js';

const alpa = new AlpaClient({ apiKey: process.env.ALPA_API_KEY });

const link = await alpa.paymentLinks.create({
  title: 'Produto Premium',
  amountCents: 9900,
  description: 'Acesso vitalício',
});

{
  id: "lnk_abc123",
  title: "Produto Premium",
  description: "Acesso vitalício",
  amount: 9900,
  currency: "BRL",
  status: "ACTIVE",
  slug: "abc123",
  createdAt: "2026-04-08T00:00:00.000Z",
  updatedAt: "2026-04-08T00:00:00.000Z"
}

const checkoutUrl = alpa.paymentLinks.getCheckoutUrl(link.slug);
// https://checkout.usealpa.com/pay/abc123

const tx = await alpa.transactions.create({
  product: 'Curso Node.js',
  paymentMethod: 'PIX',
  amountCents: 19900,
  clientName: 'João Silva',
  clientEmail: 'joao@example.com',
  clientDocument: '12345678900',
});

console.log(tx.pixCopiaECola);

const result = await alpa.coupons.validate({
  code: 'DESCONTO10',
  amountCents: 19900,
});

// result.valid, result.discountCents, result.finalAmountCents

app.post('/webhook', express.raw({ type: 'application/json' }), (req, res) => {
  const isValid = alpa.verifyWebhookSignature(
    req.body,
    req.headers['x-webhook-signature'] as string,
    process.env.ALPA_WEBHOOK_SECRET!
  );

  if (!isValid) return res.status(401).json({ error: 'Assinatura inválida' });

  const event = JSON.parse(req.body.toString());
  res.json({ received: true });
});

import { AlpaError, AlpaValidationError } from '@alpa/alpa-js';

try {
  const tx = await alpa.transactions.create({ ... });
} catch (error) {
  if (error instanceof AlpaValidationError) {
    console.error('Dados inválidos:', error.message);
  } else if (error instanceof AlpaError) {
    console.error(`Erro ${error.statusCode}:`, error.message);
  }
}