SDK JavaScript

import { RivooPay, WebhookEvent } from '@rivoo/sdk';

const rivoopay = new RivooPay({
  apiKey: 'cpk_sandbox_sua_chave_aqui',
});

const charge = await rivoopay.charges.createPaymentLink({
  total: 5000, // R$ 50,00 (em centavos)
  customer: {
    taxId: '12345678900',
    name: 'João Silva',
    email: 'joao@email.com',
    phone: '11999999999',
  },
  successUrl: 'https://meusite.com/sucesso',
  failedUrl: 'https://meusite.com/falha',
  items: [
    { productId: 'prod_abc123', quantity: 2 },
  ],
});

console.log(charge.data?.url); // URL da página de pagamento

const pix = await rivoopay.charges.createPixCharge({
  amount: 1500, // R$ 15,00
  customer: {
    taxId: '12345678900',
    name: 'Maria Santos',
    email: 'maria@email.com',
    phone: '11988888888',
  },
  expiresIn: 900, // 15 minutos em segundos
});

console.log(pix.data?.brCode);       // PIX copia-e-cola
console.log(pix.data?.brCodeBase64); // QR Code em base64

const charge = await rivoopay.charges.getById('charge_id_aqui');

console.log(charge.data?.status);        // OPEN | COMPLETED | EXPIRED
console.log(charge.data?.paymentStatus); // PENDING | PROCESSING | PAID | EXPIRED

const pixPayment = await rivoopay.charges.generatePixForCharge('charge_id', {
  customer: {
    taxId: '12345678900',
    name: 'João Silva',
    email: 'joao@email.com',
    phone: '11999999999',
  },
});

await rivoopay.charges.simulatePayment('charge_id');

const charge = await rivoopay.charges.createPixCharge(
  {
    amount: 5000,
    customer: {
      taxId: '12345678900',
      name: 'João Silva',
      email: 'joao@email.com',
      phone: '11999999999',
    },
  },
  { idempotencyKey: 'f47ac10b-58cc-4372-a567-0e02b2c3d479' },
);

import { DefaultStatus } from '@rivoo/sdk';

// Listar todos
const customers = await rivoopay.customers.list();

// Buscar por ID
const customer = await rivoopay.customers.getById('cust_abc123');

// Criar cliente
const newCustomer = await rivoopay.customers.create({
  name: 'João Silva',
  taxId: '12345678900',
  email: 'joao@email.com',
  phone: '11999999999',
  status: DefaultStatus.ACTIVE,
  postalCode: '01001000',
  address: 'Praça da Sé',
  number: '1',
  district: 'Sé',
});

// Atualizar cliente
await rivoopay.customers.update({
  id: 'cust_abc123',
  phone: '11977777777',
  status: DefaultStatus.INACTIVE,
});

import { DefaultStatus } from '@rivoo/sdk';

// Listar produtos
const products = await rivoopay.products.list({ status: DefaultStatus.ACTIVE });

// Buscar por ID
const product = await rivoopay.products.getById('prod_abc123');

// Buscar por SKU
const productBySku = await rivoopay.products.getBySku('PLAN-MONTHLY');

// Criar produto
const newProduct = await rivoopay.products.create({
  name: 'Plano Mensal',
  description: 'Assinatura mensal do serviço',
  price: 4990, // R$ 49,90 (em centavos)
  sku: 'PLAN-MONTHLY',
});

// Atualizar produto
await rivoopay.products.update({
  id: 'prod_abc123',
  price: 5990,
});

import { WebhookEvent } from '@rivoo/sdk';

// Listar webhooks
const webhooks = await rivoopay.webhooks.list();

// Criar webhook
const webhook = await rivoopay.webhooks.create({
  name: 'Meu Webhook',
  url: 'https://meusite.com/webhooks/rivoopay',
  events: [WebhookEvent.CHARGE_PAID, WebhookEvent.CHARGE_EXPIRED],
});

// Atualizar webhook
await rivoopay.webhooks.update({
  id: 'wh_abc123',
  events: [WebhookEvent.CHARGE_PAID],
});

// Deletar webhook
await rivoopay.webhooks.delete('wh_abc123');

// Listar eventos disponíveis
const events = await rivoopay.webhooks.listEvents();

// Estatísticas da fila
const stats = await rivoopay.webhooks.getQueueStats();

// Consultar saldo
const balance = await rivoopay.account.getBalance();

// Criar saque (transferência PIX)
const withdraw = await rivoopay.account.withdraw({
  value: 10000, // R$ 100,00
});

// Listar histórico de saques
const withdrawals = await rivoopay.account.listWithdrawals();

const rivoopay = new RivooPay({
  // Autenticação (obrigatório)
  apiKey: 'cpk_sandbox_sua_chave_aqui',

  // URL customizada (padrão: https://api.rivopay.com)
  baseUrl: 'https://minha-api.com',

  // Ambiente sandbox
  sandbox: true,

  // Timeout em ms (padrão: 30000)
  timeout: 15000,

  // Retentativas automáticas em 429/5xx (padrão: 2)
  maxRetries: 3,

  // Headers extras
  headers: {
    'X-Custom-Header': 'valor',
  },

  // fetch customizado (Node.js < 18)
  fetch: customFetchImplementation,
});

import {
  RivooPay,
  RivooPayApiError,
  RivooPayRateLimitError,
  RivooPayIdempotencyError,
  RivooPayTimeoutError,
  RivooPayNetworkError,
} from '@rivoo/sdk';

try {
  await rivoopay.charges.createPixCharge({ /* ... */ });
} catch (error) {
  if (error instanceof RivooPayRateLimitError) {
    console.log(`Rate limited. Tente novamente em ${error.retryAfter}s`);
  } else if (error instanceof RivooPayIdempotencyError) {
    console.log('Conflito de chave de idempotência');
  } else if (error instanceof RivooPayTimeoutError) {
    console.log('Timeout na requisição');
  } else if (error instanceof RivooPayNetworkError) {
    console.log('Erro de rede:', error.message);
  } else if (error instanceof RivooPayApiError) {
    console.log(`Erro da API ${error.statusCode}: ${error.message}`);
    console.log('Corpo da resposta:', error.body);
  }
}

import type {
  Customer,
  CreateCustomerInput,
  ChargeDetail,
  CreatePixChargeInput,
  Product,
  Webhook,
  RivooPayResponse,
} from '@rivoo/sdk';

import {
  DefaultStatus,    // ACTIVE | INACTIVE
  ChargeStatus,     // OPEN | COMPLETED | EXPIRED
  PaymentStatus,    // PENDING | PROCESSING | PAID | EXPIRED
  WebhookEvent,     // CHARGE_PAID | CHARGE_EXPIRED | ...
  WithdrawStatus,   // Status de saques
} from '@rivoo/sdk';

import { Module, Injectable } from '@nestjs/common';
import { RivooPay } from '@rivoo/sdk';

@Module({
  providers: [
    {
      provide: RivooPay,
      useFactory: () =>
        new RivooPay({ apiKey: process.env.RIVOOPAY_API_KEY }),
    },
  ],
  exports: [RivooPay],
})
export class RivooPayModule {}

// No service:
@Injectable()
export class PaymentService {
  constructor(private readonly rivoopay: RivooPay) {}

  async createCharge(amount: number) {
    return this.rivoopay.charges.createPixCharge({
      amount,
      customer: { /* ... */ },
    });
  }
}