---
title: "Saldo e cobrança"
description: "Saldo pré-pago em reais, reservado no envio e cobrado só no sucesso."
source_url: "https://staging-hypio.doti.gg/docs/cobranca"
updated: "2026-11-11"
---

# Saldo e cobrança

Saldo pré-pago em reais, reservado no envio e cobrado só no sucesso.

## Unidade

O saldo é em reais, não expira e é da organização. A API devolve valores em centavos: os campos terminados em `Credits` valem R$ 0,01 por unidade.

## Reserva e cobrança

1. No `POST`, o preço fica reservado. Sem saldo, a API responde `402`.
2. No sucesso, a reserva vira cobrança.
3. Na falha, a reserva volta. Reserva sem resposta expira em 15 minutos.

## Consultar o saldo

```bash
curl https://staging-hypio.doti.gg/api/v1/balance \
  -H "Authorization: Bearer $HYPIO_API_KEY"
```

`availableCredits` é o que dá para gastar agora. `reservedCredits` é o que está preso em gerações em andamento.

## Recarga

Recarregue em [Saldo](https://staging-hypio.doti.gg/creditos) com cartão ou Pix: R$ 20, R$ 30, R$ 50, R$ 100, R$ 250, R$ 500, R$ 1.000, ou um valor livre de R$ 20 a R$ 10.000. Veja também os [preços](https://staging-hypio.doti.gg/precos).