Pular para o conteúdo
odjud
EntrarCriar conta

Créditos, cobrança e faturamento

Unidade

100 créditos = R$ 1,00 (1 crédito = 1 centavo). Valores sempre inteiros.

Ciclo de uma operação

  1. Reserva do valor máximo na criação (pré-pago). Sem saldo → 402 INSUFFICIENT_CREDITS (o saldo nunca fica negativo).
  2. Execução na fonte.
  3. Captura do valor devido ou liberação integral.

A resposta da busca informa: billing.billable, chargedCredits, currencyAmount, priceVersion, chargeMode e criterion (o motivo).

Situação Cobrança
Resultado útil (inclui parcial) sim
Resultado de cache da mesma fonte sim (cacheHit: true)
Não encontrado não
Erro, bloqueio ou indisponibilidade da fonte não
Cancelada antes da execução não
Repetição com a mesma Idempotency-Key não (mesma operação)
OAB concluída sem processos só a taxa da operação
GET /v1/processes/* não

Recarga (pré-pago)

Pelo portal (Financeiro → Comprar créditos) ou POST /v1/billing/top-ups (chave live com billing:write):

curl -X POST "$ODJUD/v1/billing/top-ups" -H "Authorization: Bearer $ODJUD_LIVE_KEY" \
  -H "Idempotency-Key: recarga-2026-10" -H "Content-Type: application/json" \
  -d '{"credits": 10000, "billingType": "PIX"}'

A resposta traz invoiceUrl (fatura hospedada do Asaas para Pix, boleto ou cartão). Os créditos só entram após a confirmação do pagamento — nunca na criação da cobrança.

Pós-pago

Mediante aprovação, com tetos diário e mensal (402 POSTPAID_DAILY_CAP/POSTPAID_MONTHLY_CAP). Fatura mensal com itens por produto, cobrança no Asaas e suspensão graduada após 5 dias de atraso.

Extrato e notas

  • GET /v1/me/transactions e o extrato CSV no portal vêm do ledger imutável (partidas dobradas).
  • NFS-e: emitida pela integração fiscal do Asaas quando habilitada. Situação atual: aguardando configuração fiscal — nenhuma nota é emitida automaticamente.

A tabela vigente para cobrança real ainda não foi ativada: os preços publicados são de referência. Veja Preços.

WhatsApp