Primeiros Passos

Do zero à primeira cobrança Pix em menos de 5 minutos.

1

Criar conta

Acesse hubpay.dev/signup e crie sua conta. O plano Free já vem com 10 cobranças/mês — sem cartão.

2

Conectar um PSP

No dashboard, vá em PSPs e adicione sua API key do Asaas ou Mercado Pago. Use o ambiente test para testar.

3

Gerar API Key

Vá em API Keys e crie uma chave de ambiente test.

4

Criar a primeira cobrança

bash
curl https://api.hubpay.dev/v1/charges \
  -X POST \
  -H "Authorization: Bearer hpx_test_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000,
    "provider": "asaas",
    "description": "Pedido #1234",
    "payer": {
      "name": "João Silva",
      "document": "12345678901",
      "email": "joao@exemplo.com"
    }
  }'
5

Usar o Pix na resposta

A resposta inclui pix.copy_paste pronto para o pagador usar:

json
{
  "id": "chg_abc123",
  "status": "pending",
  "amount": 5000,
  "pix": {
    "copy_paste": "00020126580014br.gov.bcb.pix...",
    "qr_code_base64": "iVBORw0KGgo..."
  }
}
6

Configurar webhook (opcional)

Para receber notificação quando o pagamento for confirmado, cadastre um endpoint em Webhooks. O Hubpay vai chamar sua URL com o evento charge.paid.

Ver documentação de webhooks →