Hubpay
← Conectar PSPs

Conectar PagSeguro (PagBank)

⏱ Tempo estimado: 10 minutos

O PagSeguro (agora PagBank) é o PSP mais popular do varejo brasileiro. A integração com o Hubpay usa apenas um Token simples e configuração automática de webhook.

1

Criar conta no PagSeguro

Para testes (Sandbox)

  1. Acesse sandbox.pagseguro.uol.com.br
  2. Crie uma conta de teste
  3. A conta sandbox é aprovada automaticamente

Para produção

  1. Acesse pagseguro.uol.com.br
  2. Crie conta ou use sua conta existente
  3. Complete a verificação de identidade
2

Obter Token

Sandbox

  1. Acesse sandbox.pagseguro.uol.com.br
  2. Vá em Perfis de Integração → Vendedor
  3. Copie o Token da seção Credenciais

Produção

  1. Acesse pagseguro.uol.com.br
  2. Vá em Venda online → Integração via API
  3. Clique em Gerar Token
  4. O token será enviado pro seu email de cadastro
3

Conectar no Hubpay

  1. Acesse hubpay.dev/dashboard/psps
  2. Clique em Conectar novo PSP
  3. Selecione PagSeguro
  4. Selecione o ambiente:
    • Test = sandbox
    • Live = produção
  5. Cole o Token
  6. Clique em Salvar credencial
4

Webhook (automático!)

💡Diferente dos outros PSPs, o PagSeguro não exige configuração manual de webhook. O Hubpay inclui a URL de notificação automaticamente em cada cobrança criada (via campo notification_urls do pedido). Quando uma cobrança Pix for paga, o PagSeguro notifica o Hubpay diretamente.
5

Testar

⚠️O PagSeguro exige dados completos do pagador (payer.name, payer.email e payer.document com CPF/CNPJ). O valor mínimo Pix no sandbox é R$ 1,00 (100 centavos).
bash
curl -X POST https://api.hubpay.dev/v1/charges \
  -H "Authorization: Bearer hpx_test_SUA_CHAVE_HUBPAY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1000,
    "provider": "pagseguro",
    "description": "Teste PagSeguro Pix",
    "payer": {
      "name": "Jose da Silva",
      "email": "jose@email.com",
      "document": "12345678909"
    }
  }'

Solução de problemas

ErroCausaSolução
502 com "UNAUTHORIZED"Token inválidoVerifique se copiou sem espaços. Confirme que o token corresponde ao ambiente (sandbox vs produção)
400 com "customer is required"Dados do pagador faltandoInclua payer.name, payer.email e payer.document
400 com "must be between 100 and 999999900"Valor menor que R$ 1,00Valor mínimo no PagSeguro é 100 centavos (R$ 1,00)
Pix não apareceQR code não geradoVerifique se Pix está habilitado na conta PagSeguro

Links úteis