Faturamento
R$ 1.720,00
Saldo
R$ 4.262,19
Pagas
36
Ticket
R$ 47,77
| Cliente | Meio | Status | Valor |
|---|---|---|---|
| Loja Norte | PIX | confirmada | R$ 1.290,00 |
| Loja A → Loja B | P2P | confirmada | R$ 350,00 |
| Campanha Escola | PIX | confirmada | R$ 80,00 |
| Pedido #4412 | PIX | pendente | R$ 210,00 |
| Link #8821 | PIX | confirmada | R$ 89,90 |
| Loja Sul → Centro | P2P | confirmada | R$ 1.000,00 |
Loja Norte · PIX · líquido R$ 1.251,30
Loja A → Loja B · P2P · líquido R$ 350,00
Campanha Escola · PIX · líquido R$ 77,60
Pedido #4412 · PIX · líquido —
Link #8821 · PIX · líquido R$ 87,20
Loja Sul → Centro · P2P · líquido R$ 1.000,00
P2P entre contas do gateway. Clique numa linha.
| Cliente | Meio | Status | Valor |
|---|---|---|---|
| Loja Norte | PIX | confirmada | R$ 1.290,00 |
| Loja A → Loja B | P2P | confirmada | R$ 350,00 |
| Campanha Escola | PIX | confirmada | R$ 80,00 |
| Pedido #4412 | PIX | pendente | R$ 210,00 |
| Link #8821 | PIX | confirmada | R$ 89,90 |
| Loja Sul → Centro | P2P | confirmada | R$ 1.000,00 |
Loja Norte · PIX · líquido R$ 1.251,30
Loja A → Loja B · P2P · líquido R$ 350,00
Campanha Escola · PIX · líquido R$ 77,60
Pedido #4412 · PIX · líquido —
Link #8821 · PIX · líquido R$ 87,20
Loja Sul → Centro · P2P · líquido R$ 1.000,00
Campanha Escola
R$ 18.440,00 · 128 apoios
74% da meta · clique num apoio
Ana Souza · PIX confirmado · R$ 120,00
Bruno Lima · PIX confirmado · R$ 80,00
Carla Dias · PIX confirmado · R$ 50,00
Como usar a API?
Média · Aberto
Gerente
Olá tudo bem?
Taxa da conta
Baixa · Aberto
Gerente
A taxa de PIX mudou neste mês?
Rotas PIX
POST/pix/charge
Gera QR Code. Expira em 1 hora.
POST /api/pix/charge
Authorization: Bearer {{token}}
Content-Type: application/json
{
"amount": 250.00,
"comment": "Pedido #4412"
}import requests
r = requests.post(
"/api/pix/charge",
headers={"Authorization": "Bearer {{token}}"},
json={"amount": 250.00, "comment": "Pedido #4412"},
)
print(r.json())const r = await fetch("/api/pix/charge", {
method: "POST",
headers: { Authorization: "Bearer {{token}}" },
body: JSON.stringify({ amount: 250.00, comment: "Pedido #4412" }),
});
console.log(await r.json());cobrar · Bearer {{token}}
GET/pix/check/:pixKey
Confere se a chave existe antes do saque.
GET /api/pix/check/loja.norte@pix
Authorization: Bearer {{token}}import requests
r = requests.get(
"/api/pix/check/loja.norte@pix",
headers={"Authorization": "Bearer {{token}}"},
)
print(r.json())const r = await fetch("/api/pix/check/loja.norte@pix", {
headers: { Authorization: "Bearer {{token}}" },
});
console.log(await r.json());consultar · Bearer {{token}}
POST/pix/send
Saque para chave. Na tela, o PIN confirma.
POST /api/pix/send
Authorization: Bearer {{token}}
Content-Type: application/json
{
"pixKey": "loja.norte@pix",
"amount": 80.00
}import requests
r = requests.post(
"/api/pix/send",
headers={"Authorization": "Bearer {{token}}"},
json={"pixKey": "loja.norte@pix", "amount": 80.00},
)
print(r.json())const r = await fetch("/api/pix/send", {
method: "POST",
headers: { Authorization: "Bearer {{token}}" },
body: JSON.stringify({ pixKey: "loja.norte@pix", amount: 80.00 }),
});
console.log(await r.json());enviar · Bearer {{token}}
Gateway completo
O que o gateway faz
Não é um banco completo e não é só um botão de PIX. É o meio-termo de um gateway: receber, pagar, mover entre contas, arrecadar e gerir o lojista no mesmo sistema.
01
A HK Pay é o gateway. O lojista recebe, envia, emite cobrança pública e acompanha cada transação na área administrativa. Taxa, webhook e chave de API entram na operação — sem montar um banco do zero.
02
Pessoa para pessoa aqui não é um PIX para o banco: é movimento entre contas HK Pay. Origem, destino, valor e status ficam no histórico. Serve para carteira interna, liquidação entre lojistas e split sem ir ao PSP a cada real.
03
Publique a arrecadação, receba de dezenas de pessoas no PIX e veja o total entrar na conta de quem organiza. Cada apoio traz nome, documento e comprovante — para quem doa e para quem administra.
04
KYC, taxas, chave de API, webhook e relatórios de entrada e saída ficam no mesmo sistema. O lojista opera o dia a dia na área administrativa: saldo, PIX, produtos e o canal com o gerente.
Do cadastro ao PIX
01
PF ou PJ, conforme o cadastro da plataforma. Dados, endereço e documentos entram no mesmo fluxo.
02
A conta fica em /analise até o KYC passar. Nada de saldo, PIX ou chave de API antes disso.
03
Com a conta ativa, o lojista entra em /area-administrativa: saldo, cobrança, saque, produtos e integração.
04
PIX entra e sai, P2P e campanha usam o mesmo extrato. Webhook avisa o sistema do lojista a cada status.
01 · Gateway
Entrada, saída e link de cobrança usam a mesma conta, o mesmo saldo e o mesmo relatório. A área administrativa mostra o que a API também vê: status, valor, taxa e identificador da transação.
Cria a cobrança, devolve QR Code e espera a confirmação. O valor cai no saldo da conta depois da taxa combinada.
Saque para uma chave. A área administrativa pede PIN. Limite por transação e trava de conta valem no servidor, não só na tela.
Uma URL pública com valor e descrição. Quem recebe o link paga no PIX sem login. A transação aparece no mesmo relatório de entradas.
Percentual e valor fixo seguem a tabela do lojista ou a taxa personalizada da conta.
02 · P2P
O P2P da HK Pay é movimento interno: sai de uma conta, entra em outra, as duas veem o extrato. Não substitui o PIX de saída para banco. Serve quando o produto precisa de carteira, comissão ou acerto entre lojistas sem liquidar fora a cada transação.
03 · Crowdfunding
A campanha é uma frente do gateway, não um produto separado. Quem apoia paga no PIX. Quem organiza vê o total no saldo e a lista de contribuições. Serve para vaquinha, pré-venda coletiva e causa com prestação de contas.
Texto, meta e botão de pagamento. O pagador não precisa de conta HK Pay.
Cada apoio é uma entrada. O organizador saca depois pelas regras da conta.
A transação carrega o pagador. Dá para exportar e conferir quem contribuiu.
Crowdfunding não inventa tabela paralela: usa a taxa de PIX de entrada do lojista.
04 · Gerenciamento
Esta página é a vitrine. Depois do login e da análise, o lojista entra na área administrativa: saldo, cobrança, saque, produtos e integração.
Integração
Quem já tem produto não precisa viver só na tela. A chave autentica as rotas de PIX. O webhook avisa o backend do lojista. Erro de implementação, timeout ou URL errada fica na ponta de quem opera a chave.
Token e secret autenticam criar cobrança, consultar chave PIX e disparar saída. O secret aparece na criação; depois o sistema guarda só o hash.
O lojista cadastra a URL e os eventos. Cada mudança de status da transação tenta entregar de novo se a ponta falhar.
Endpoints, exemplos e o formato das respostas ficam na área administrativa, na página Documentação, junto da chave.
Para quem é
Checkout, assinatura, pedido ou recarga. A API cria a cobrança; o webhook confirma; o saldo aparece para saque.
P2P move valor entre contas do gateway. Split e liquidação não dependem de um PIX bancário a cada ponta.
Crowdfunding com página, vários pagadores e um organizador. Prestação de contas sai do extrato, não de planilha.
KYC, taxa e canal com o gerente não ficam no WhatsApp. A conta entra em análise, libera na área administrativa e o extrato concentra a conferência.
Taxas e limites
Não tem planilha à parte nem desconto combinado no chat. Entrada, saída e P2P leem a tabela da conta. Se a taxa da ficha mudar, a próxima transação já usa o valor novo.
Percentual e valor fixo de entrada e saída valem para quem não tem taxa personalizada na ficha.
A taxa personalizada da conta, quando existir, vale na cobrança e no saque. A próxima transação já usa o valor da ficha.
Teto por transação e trava da conta valem na API e na área administrativa. O servidor recusa o que passar disso.
O PIX de produção passa pelo adquirente configurado na operação. Sem isso, não há cobrança de verdade.
KYC e trava
O cadastro público não libera a operação. Análise, PIN e inativação existem para o gateway não girar conta crua. Enquanto a análise não termina, a conta fica em /analise.
O cadastro pede dados e arquivos. A conta fica em análise até a aprovação.
Saque pede PIN. Redefinição vai por e-mail. Sem PIN confirmado, a saída não sai.
Login com cookie HttpOnly. A sessão fica no navegador, não na URL.
Conta inativa deixa de operar no painel e na chave de API. O saldo não some.
Relatórios
PIX in, P2P recebido e apoio de campanha no mesmo relatório, com status e valor líquido.
PIX out e P2P enviado, com chave de destino, taxa e quem autorizou o saque.
A área administrativa mostra o que a conta tem agora. Não é snapshot paralelo: é o saldo da conta.
Perguntas
Sim. Link de pagamento e a área administrativa cobrem cobrança e saque. A API entra quando o produto precisa criar PIX sozinho.
Depois do KYC aprovado. Até lá a conta fica em /analise. Login de conta aprovada vai para /area-administrativa.
Não. P2P é entre contas HK Pay. PIX de saída é saque para chave bancária. Os dois aparecem no extrato.
Não. Cada apoio é uma entrada PIX e usa a taxa de entrada do organizador.
Só na criação ou se regenerar. Depois o sistema guarda o hash. Quem perder o secret precisa gerar outra chave.
Começar
Cadastro público, documentos na sequência, e-mail quando o KYC terminar. Quem já foi aprovado entra em /area-administrativa.
Receba recompensas com base nos seus ganhos ao utilizar as soluções da HKPAY.
