This page is not yet available in English. Read it in Portuguese

Skip to content

Recarga por Pix: do pedido ao saldo, e o que confere no caminho

Equipe AIUBYRevisado em 16 nov 2026

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

  1. Escolha o valor

    Use um dos atalhos ou digite um valor de R$ 20 a R$ 50.000, com até duas casas decimais.

  2. Gere o Pix

    A tela mostra o QR code e o código copia e cola. O Pix vale por 30 minutos.

  3. 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çãoO que acontece
O Pix não foi pago em 30 minutosExpira. Gere outro; o antigo não credita
Muitos pedidos seguidosCada organização gera até 5 pedidos de recarga por hora
O saldo acabou no meio do diaAs chamadas de IA respondem 402 insufficient_credit até a recarga; nada vira dívida
Você fechou a tela antes de pagarO Pix pendente reaparece ao voltar, enquanto estiver no prazo
A organização foi encerrada e um Pix antigo foi pago depoisO 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.