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

# Créditos e cobrança

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

## Crédito

1 crédito = R$ 0,01. O saldo de recarga não expira e é da organização.

## 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://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 [Créditos](https://hypio.doti.gg/creditos) com cartão ou Pix: R$ 30, R$ 50, R$ 100, R$ 250, R$ 500, R$ 1.000, ou um valor livre de R$ 30 a R$ 10.000. Veja também os [preços](https://hypio.doti.gg/precos).