Node.js

# .env
UPAG_SECRET_KEY=sk_test_your_api_key

import { Upag } from 'upag';

const upag = new Upag(process.env.UPAG_SECRET_KEY);

// ou com opções
const upagWithOptions = new Upag({
  apiKey: process.env.UPAG_SECRET_KEY,
  timeout: 30000,
  // baseURL: 'http://localhost:3000/v1',
});

const charge = await upag.charges.create({
  type: 'pix',
  amount: 9900,
  pix: { method: 'dynamic' },
  customer: {
    name: 'Maria Silva',
    email: 'maria@example.com',
    document: { type: 'cpf', number: '12345678909' },
  },
});

console.log(charge.pix.qrCode);

const session = await upag.threeDSecure.createSession(
  { amount: 10000, installments: 1, card: cardId, customer: customerId },
  { idempotencyKey: 'order-123' },
);
// entregue session.clientSecret ao browser e receba o sessionId após authenticate

const charge = await upag.charges.create({
  type: 'card',
  amount: 10000,
  card: cardId,
  customer: customerId,
  threeDSecureSession: sessionId,
});

await upag.cards.create(card, { idempotencyKey: 'card-order-123' });

import express from 'express';

app.post('/webhooks', express.raw({ type: '*/*' }), (req, res) => {
  const ok = upag.webhooks.validateSignature(
    req.body, // Buffer cru
    req.headers['x-webhook-signature'],
    process.env.UPAG_WEBHOOK_SECRET,
  );
  if (!ok) return res.sendStatus(401);

  const { id, event, data } = JSON.parse(req.body.toString('utf8'));
  // processe o evento e deduplique pelo id
  res.sendStatus(200);
});

try {
  await upag.customers.create({
    name: 'John Doe',
    document: { type: 'cpf', number: 'invalid' },
  });
} catch (error) {
  console.error(error.statusCode, error.code, error.message);
  console.error(error.details, error.meta);
}

import { Upag, CreateChargeParams, CreateCustomerParams } from 'upag';

const params: CreateChargeParams = {
  type: 'pix',
  amount: 1000,
  pix: { method: 'dynamic' },
  customer: { name: 'Test', document: { type: 'cpf', number: '12345678909' } },
};