Começar

Início rápido

Do install à primeira cobrança em poucos minutos.

Este guia leva você do zero à primeira transação cobrada pelo Infi.

Instalação

Instale o SDK no seu projeto:

npm install @infi/sdk

Configuração

Crie o cliente com a sua chave de API:

import { Infi } from "@infi/sdk";
 
export const infi = new Infi({
  apiKey: process.env.INFI_API_KEY!,
});

Chave de API

Guarde a INFI_API_KEY apenas no servidor. Nunca exponha a chave no cliente.

Crie um customer

Todo uso e receita são atrelados a um customer:

const customer = await infi.customers.create({
  email: "cliente@empresa.com",
});

Registre uso

Chame recordUsage no runtime, no caminho não-crítico, para não travar sua API:

await infi.usage.record({
  customerId: customer.id,
  event: "api_call",
  quantity: 1,
});

Feche a fatura

No fim do ciclo, o Infi fecha a fatura e cobra em Pix, boleto ou cartão. Você acompanha tudo pelo painel, uso e receita por cliente, em tempo real.

Pronto. A partir daqui, escolha o modelo de cobrança (assinatura, créditos ou pay-as-you-go) e o Infi executa a regra.