Recarga por Pix: do pedido ao saldo, e o que confere no caminho
Saldo pré-pago + Pix
Na AIUBY, o consumo é pré-pago: primeiro entra o saldo, depois ele é gasto. A recarga é um Pix gerado na área do cliente. Este texto mostra o caminho inteiro, do clique ao saldo disponível, e o que a plataforma confere no meio para um pagamento creditar uma vez só e pelo valor certo. A referência está em Cobrança, na documentação.
#Quem recarrega e onde
- A recarga fica na tela Cobrança, no grupo Configurações do menu.
- Só o dono da organização inteira recarrega. Administradores e membros não veem o botão.
- Vale para conta pré-paga, que é a que nasce quando o dono adiciona o primeiro produto pelo catálogo.
#Passo a passo
Escolha o valor
Use um dos atalhos ou digite um valor de R$ 20 a R$ 50.000, com até duas casas decimais.
Gere o Pix
A tela mostra o QR code e o código copia e cola. O Pix vale por 30 minutos.
Pague no aplicativo do seu banco
A tela confirma sozinha quando o pagamento cai, e o valor entra no saldo. Não é preciso enviar comprovante. Se você sair da tela, o Pix pendente reaparece ao voltar.
#O que é conferido antes de o saldo entrar
O processador de pagamento avisa a plataforma quando um Pix é pago. Esse aviso, sozinho, não credita nada: ele só diz "vá olhar este pagamento". O crédito sai de três conferências.
- A plataforma consulta o pagamento no processador. O valor creditado nunca vem do corpo do aviso. Um aviso forjado, ou com o valor trocado, não muda o saldo de ninguém.
- O banco de dados confere valor, moeda e referência com o pedido de recarga que a própria organização fez. Pagamento que não bate com um pedido não vira crédito.
- Um pagamento credita uma única vez. O aviso pode chegar repetido, e chega; a segunda vez não faz nada.
Se o aviso se perder no caminho, o saldo não fica preso: um processo em segundo plano consulta os pedidos pendentes e credita os que já foram pagos.
#O que o saldo paga
- Consumo de IA. Cada chamada de modelo desconta o valor em reais. O preço por dólar de custo aparece na tela e acompanha o câmbio oficial.
- Mensalidade de produto. Se havia uma mensalidade pendente, ela é debitada sozinha em até 10 minutos depois que o saldo entra. Detalhes em Mensalidade por produto.
- Compute. Aplicações pagas debitam pelo tempo em uso; com GPU, por minuto de instância ligada.
A tela lista as últimas recargas com a situação de cada uma, o extrato mostra crédito e consumo, e cada pedido fica na auditoria.
#Situações que fogem do caminho feliz
| Situação | O que acontece |
|---|---|
| O Pix não foi pago em 30 minutos | Expira. Gere outro; o antigo não credita |
| Muitos pedidos seguidos | Cada organização gera até 5 pedidos de recarga por hora |
| O saldo acabou no meio do dia | As chamadas de IA respondem 402 insufficient_credit até a recarga; nada vira dívida |
| Você fechou a tela antes de pagar | O Pix pendente reaparece ao voltar, enquanto estiver no prazo |
| A organização foi encerrada e um Pix antigo foi pago depois | O valor entra no saldo a devolver, e a equipe é avisada |
O código 402 insufficient_credit e os outros de faturamento estão explicados em Erros da API de chat.
#Limites
Limite
Não há recarga automática, recarga por chave de API, nem boleto ou cartão para o pré-pago: a recarga é sempre um Pix gerado pelo dono na tela.
- O saldo é em reais e não tem conversão para créditos ou pacotes: o que entra é o que você pagou.
- O pay-per-use, com fatura no cartão, ainda não está disponível.
- Se a organização for encerrada, o saldo que sobrar é devolvido por Pix pela equipe AIUBY.
Para criar a conta e chegar à primeira recarga, comece por Adicione os produtos que quiser.


