# HubPix API

> API para receber (PIX In e QR estático), pagar (PIX Out) e sacar em USDT (BSC/BEP20), com webhooks assinados gerenciáveis pela própria API. Documentação completa: https://hubpixtech.com/docs.

Base URL: https://hubpixtech.com/v1 · Autenticação: header X-API-Key (saques também X-Secret-Key) · Valores sempre string decimal em reais ("100.00").
Atualizado em 2026-10-03T00:11:01.000Z.

## Documentação

- [Documentação completa em Markdown](https://hubpixtech.com/llms-full.txt): tudo em um arquivo, ideal para colocar no contexto do modelo
- [Especificação OpenAPI 3.1](https://hubpixtech.com/openapi.json): schemas, parâmetros e erros de todos os endpoints
- [Documentação em HTML](https://hubpixtech.com/docs)

## Seções

- [Autenticação](https://hubpixtech.com/docs#autenticacao)
- [Whitelist de IP](https://hubpixtech.com/docs#whitelist-de-ip)
- [Idempotência](https://hubpixtech.com/docs#idempotencia)
- [Erros](https://hubpixtech.com/docs#erros)
- [Limites de requisição](https://hubpixtech.com/docs#limites-de-requisicao)
- [Conta e saldo](https://hubpixtech.com/docs#conta-e-saldo)
- [PIX In (cobranças)](https://hubpixtech.com/docs#pix-in-cobrancas)
- [QR estático](https://hubpixtech.com/docs#qr-estatico)
- [PIX Out (saques)](https://hubpixtech.com/docs#pix-out-saques)
- [Saque em USDT](https://hubpixtech.com/docs#saque-em-usdt)
- [Extrato](https://hubpixtech.com/docs#extrato)
- [Webhooks](https://hubpixtech.com/docs#webhooks)
- [Chaves e whitelist pela API](https://hubpixtech.com/docs#chaves-e-whitelist-pela-api)
- [Integração com IA e automação](https://hubpixtech.com/docs#integracao-com-ia-e-automacao)
- [Boas práticas](https://hubpixtech.com/docs#boas-praticas)

## Endpoints

- `GET /v1/balance` — Saldo disponível e reservado
- `GET /v1/account` — Dados da conta, taxas, limites e recursos habilitados
- `POST /v1/pix/charges` — Cria cobrança PIX (QR copia e cola)
- `GET /v1/pix/charges` — Lista cobranças (ou busca por externalRef)
- `GET /v1/pix/charges/{id}` — Consulta cobrança
- `POST /v1/pix/static-qrs` — Cria QR estático reutilizável (não expira; cada pagamento vira um PIX_IN)
- `GET /v1/pix/static-qrs` — Lista QRs estáticos (ou busca um pela reference)
- `GET /v1/pix/static-qrs/{id}` — Consulta o QR (copia e cola atual); query opcional gera código pontual do mesmo QR
- `GET /v1/pix/static-qrs/{id}/payments` — Pagamentos recebidos neste QR (transações PIX_IN)
- `POST /v1/pix/withdrawals` — Envia PIX (saque) — uma única tentativa (exige X-Secret-Key + IP na whitelist de saque)
- `GET /v1/pix/withdrawals` — Lista saques PIX
- `GET /v1/pix/withdrawals/{id}` — Consulta saque PIX
- `GET /v1/usdt/quote` — Cotação de saque em USDT (BSC/BEP20)
- `POST /v1/usdt/withdrawals` — Saque em USDT na BSC (BEP20) (exige X-Secret-Key + IP na whitelist de saque)
- `GET /v1/usdt/withdrawals` — Lista saques USDT
- `GET /v1/usdt/withdrawals/{id}` — Consulta saque USDT
- `GET /v1/transactions` — Extrato (todas as transações)
- `GET /v1/transactions/{id}` — Consulta qualquer transação
- `GET /v1/webhooks/events` — Eventos disponíveis
- `GET /v1/webhooks` — Lista URLs de webhook
- `POST /v1/webhooks` — Cadastra URL (o secret volta só nesta resposta)
- `GET /v1/webhooks/{id}` — getWebhook
- `PATCH /v1/webhooks/{id}` — Altera url, events, description ou active
- `DELETE /v1/webhooks/{id}` — deleteWebhook
- `POST /v1/webhooks/{id}/rotate-secret` — rotateWebhookSecret
- `POST /v1/webhooks/{id}/test` — Envia webhook.test agora
- `GET /v1/webhooks/{id}/deliveries` — listWebhookDeliveries
- `POST /v1/webhooks/{id}/deliveries/{deliveryId}/redeliver` — redeliverWebhook
- `GET /v1/api-keys` — Lista as chaves da conta (criação só pelo painel, com 2FA)
- `DELETE /v1/api-keys/{id}` — Revoga uma chave (exige X-Secret-Key de um IP da whitelist de saque) (exige X-Secret-Key + IP na whitelist de saque)
- `GET /v1/ip-allowlist` — getIpAllowlist
- `PUT /v1/ip-allowlist` — Substitui as whitelists (exige X-Secret-Key de um IP já autorizado para saque) (exige X-Secret-Key + IP na whitelist de saque)