Skip to content

Módulo Pix

O Módulo Pix concentra todas as funcionalidades relacionadas ao sistema de pagamentos instantâneos do Banco Central. Com ele você gera cobranças Pix, realiza transferências, consulta recebimentos e configura um QR Code fixo para sua conta.


Funcionalidades do Módulo

FuncionalidadeRotaDescrição
Receber Pix/receber-pixGera QR Code para recebimento pontual
Transferir Pix/transferir-pixRealiza transferência para chave Pix externa
QR Code Fixo/qrcode-fixoQR Code permanente com valor aberto
Últimos Recebimentos/ultimos-depositosHistórico de Pix recebidos
Listagem de Pix/pixs-geradosTodos os QR Codes gerados

Receber Pix

Acesso: Menu → Pix → Receber Pix (/receber-pix)

Gera um QR Code dinâmico para recebimento de um valor específico:

Como usar:

  1. Informe o valor a receber (ex: R$ 99,90).
  2. Adicione uma descrição (opcional — ex: "Mensalidade Janeiro").
  3. Defina o prazo de expiração do QR Code (ex: 30 minutos, 1 hora, 24 horas).
  4. Clique em Gerar QR Code.
  5. Compartilhe o QR Code ou o código Copia e Cola com o pagador.

Após o pagamento:

  • Você receberá uma notificação em tempo real no portal.
  • O valor entra em Saldo Disponível imediatamente (D+0).
  • A transação aparece em Últimos Recebimentos.

Mínimo por transação: O valor mínimo de cobrança Pix é definido pelas configurações da sua conta. Consulte seu painel de configurações.


Transferir Pix

Acesso: Menu → Pix → Transferir Pix (/transferir-pix)

Realiza transferências do saldo disponível para qualquer chave Pix externa:

Como usar:

  1. Informe a chave Pix de destino:
    • CPF: 000.000.000-00
    • CNPJ: 00.000.000/0001-00
    • E-mail: exemplo@email.com
    • Telefone: +5511999999999
    • Chave aleatória (EVP): xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
  2. Clique em Verificar Chave — os dados do beneficiário são exibidos.
  3. Confirme que o beneficiário está correto.
  4. Informe o valor a transferir.
  5. Clique em Confirmar Transferência.

Regras de Transferência

  • O saldo precisa estar disponível (não futuro).
  • Transferências são processadas instantaneamente.
  • O comprovante fica disponível no extrato e pode ser baixado.
  • Existe um limite diário de transferências configurado pela sua conta — consulte Configurações.

QR Code Fixo

Acesso: Menu → QR Code Fixo (/qrcode-fixo)

O QR Code fixo é um código permanente e reutilizável associado à sua conta:

  • O valor não é definido — o pagador insere o valor que deseja enviar.
  • Ideal para caixas físicos, mesas, balcões e uso recorrente.
  • O QR Code não expira automaticamente.

Como baixar o QR Code:

  1. Acesse /qrcode-fixo.
  2. Visualize o QR Code gerado para sua conta.
  3. Clique em Download para salvar a imagem.
  4. Clique em Imprimir para gerar uma versão para impressão (/qrcode-fixo/download).

Últimos Recebimentos

Acesso: Menu → Pix → Últimos Depósitos (/ultimos-depositos)

Lista os últimos Pix recebidos com:

  • Data e hora do recebimento
  • Nome/CPF do pagador
  • Valor recebido
  • Status (Pago, Pendente)
  • Descrição informada pelo pagador

Listagem de Pix Gerados

Acesso: Menu → Pix → Pix Gerados (/pixs-gerados)

Exibe todos os QR Codes criados com:

  • Data de criação e expiração
  • Valor e status (Pago, Pendente, Expirado)
  • Opção de reenviar ou copiar o código Copia e Cola

Status de Transações Pix

StatusDescrição
PendenteQR Code gerado, aguardando pagamento
PagoPix recebido com sucesso
ExpiradoQR Code venceu sem pagamento
DevolvidoPix recebido e devolvido ao pagador

Regras de Negócio Pix

  • QR Codes dinâmicos têm prazo de expiração definido no momento da criação.
  • Cada QR Code dinâmico é de uso único — após o pagamento, não pode ser utilizado novamente.
  • O QR Code fixo é reutilizável e não tem expiração automática.
  • Transferências Pix para contas externas requerem Saldo Disponível suficiente.
  • Em caso de erro na chave Pix de destino, a transferência é rejeitada automaticamente pelo sistema bancário.
  • O prazo de devolução automática (DEVOL) é de 10 segundos em caso de falha no processamento.

FastGivr API Documentation