Introduction
Welcome to the WeetPay API documentation
WeetPay is a PIX payment gateway. Through the API your application creates dynamic QR Code charges, gets real-time payment notices, sends PIX to any key and looks up transactions and balance — with a handful of HTTP calls and amounts in BRL reais.
What you can do
Incoming payments (cash-in) become PIX "copia e cola" charges with a ready-to-display QR Code. When the customer pays, the amount is credited to your balance and WeetPay notifies your system at callbackUrl. Outgoing payments (cash-out) leave your balance to a PIX key, protected against duplicate sending, with the result also delivered by callback.
Why integrate?
- Simple integration — four endpoints, plain JSON and amounts in reais (
49.90) - Compatible — same paths, fields and responses as the most widely used gateway API — migrate by swapping the URL and keys
- Signed callbacks — payment and payout notices with HMAC-SHA256 and automatic retries
- No duplicate payouts — Idempotency-Key guarantees a PIX is never sent twice
- Ready QR Code — PIX code and base64 PNG image in the same response
- Split — share incoming payments with another WeetPay account (upon approval)
Modules
Cash-in
Create PIX charges (dynamic QR Code) and receive the payment notice at your callbackUrl.
Cash-out
Send PIX from your balance to CPF, CNPJ, e-mail, phone or random keys.
Transactions
Look up charges and payouts by requestNumber, idTransaction or End-to-End.
Account
Available wallet balance, in reais.
Callbacks and webhooks
Notice formats, X-WeetPay-Signature and retry policy.
Dashboard
Generate credentials, enable API payouts, register webhooks and track transactions.
Base URLs
| Environment | URL |
|---|---|
| API (production) | https://api.weetpay.com |
| Dashboard | https://app.weetpay.com — credentials under Developers |
| Documentation | https://docs.weetpay.com |
Every request carries the client ID and client secret in the vspi and vsps headers. Errors always look like { "response": "ERROR", "message": "…" }. See Authentication and Errors.
Next steps
Follow the Quickstart to create your first charge in minutes. For assistants and coding agents, use llms.txt (index) or llms-full.txt (full content).