Conectar Pagar.me

⏱ Tempo estimado: 5 minutos

O Pagar.me usa uma Secret Key simples para autenticação.

1. Acesse pagar.me
2. Clique em "Começar agora" ou "Criar conta"
3. Preencha seus dados
4. Aguarde aprovação

1. Acesse o Dashboard Pagar.me
2. Vá em Configurações → Chaves de API
3. Copie a Secret Key:
   • Para testes: começa com sk_test_
   • Para produção: começa com sk_

1. Acesse hubpay.dev/dashboard/psps
2. Clique em Conectar novo PSP
3. Selecione Pagar.me
4. Selecione o ambiente:
   • Test se está usando chave de teste (sk_test_...)
   • Live se está usando chave de produção (sk_...)
5. Dê um label (ex: "Pagar.me principal")
6. Cole a Secret Key
7. Clique em Salvar credencial

curl -X POST https://api.hubpay.dev/v1/charges \
  -H "Authorization: Bearer hpx_test_SUA_CHAVE_HUBPAY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 2000,
    "provider": "pagarme",
    "description": "Teste Pagar.me",
    "payer": {
      "name": "João da Silva",
      "document": "12345678900",
      "email": "joao@example.com"
    }
  }'

Após salvar a credencial, o Hubpay gera uma URL de webhook única pra ela. Formato:

https://api.hubpay.dev/api/wh/{uuid}

1. Em /dashboard/psps, no menu "..." da credencial, clique em Copiar URL do webhook e Copiar token do webhook.
2. No Dashboard Pagar.me: Configurações → Webhooks → Criar webhook.
3. Cole a URL no campo URL.
4. Configure o token como header HTTP x-hubpay-token (cole o valor copiado).
5. Marque os eventos: charge.paid, charge.payment_failed, charge.refunded, charge.canceled, charge.overpaid, charge.underpaid.
6. Salve.

Solução de problemas

Links úteis

• Dashboard Pagar.me
• Documentação Pagar.me