Introdução
Bem-vindo à documentação da API WeetPay
A WeetPay é um gateway de pagamentos PIX. Pela API sua aplicação gera cobranças com QR Code dinâmico, recebe o aviso de pagamento em tempo real, envia PIX para qualquer chave e consulta transações e saldo — com poucas chamadas HTTP e valores em reais.
O que dá para fazer
Recebimentos (cash-in) viram cobranças PIX copia e cola com QR Code pronto para exibir. Quando o cliente paga, o valor entra no seu saldo e a WeetPay avisa o seu sistema no callbackUrl. Pagamentos (cash-out) saem do seu saldo para uma chave PIX, com proteção contra envio duplicado e resultado também por callback.
Por que integrar?
- Integração simples — quatro endpoints, JSON puro e valores em reais (
49.90) - Compatível — mesmos caminhos, campos e respostas da API de gateway mais usada no mercado — migre trocando a URL e as chaves
- Callbacks assinados — aviso de pagamento e de saque com HMAC-SHA256 e reenvio automático
- Saque sem duplicidade — a Idempotency-Key garante que um PIX nunca saia duas vezes
- QR Code pronto — PIX copia e cola e imagem PNG em base64 na mesma resposta
- Split — divida recebimentos com outra conta WeetPay (mediante liberação)
Módulos
Cash-in
Gere cobranças PIX (QR Code dinâmico) e receba o aviso de pagamento no seu callbackUrl.
Cash-out
Envie PIX do seu saldo para chaves CPF, CNPJ, e-mail, telefone ou aleatória.
Transações
Consulte cobranças e saques por requestNumber, idTransaction ou End-to-End.
Conta
Saldo disponível da carteira, em reais.
Callbacks e webhooks
Formato dos avisos, assinatura X-WeetPay-Signature e política de reenvio.
Painel
Gere as credenciais, libere saques pela API, cadastre webhooks e acompanhe as transações.
URLs base
| Ambiente | URL |
|---|---|
| API (produção) | https://api.weetpay.com |
| Painel | https://app.weetpay.com — credenciais em Desenvolvedores |
| Documentação | https://docs.weetpay.com |
Toda requisição leva o client ID e o client secret nos cabeçalhos vspi e vsps. Erros sempre vêm como { "response": "ERROR", "message": "…" }. Veja Autenticação e Erros.
Próximos passos
Siga o Início rápido para gerar sua primeira cobrança em minutos. Para assistentes e agentes de código, use o llms.txt (índice) ou o llms-full.txt (conteúdo completo).