Conectar Stripe

⏱ Tempo estimado: 5 minutos

O Stripe é um dos PSPs mais populares do mundo. A integração com o Hubpay usa apenas uma Secret Key (sk_test_... ou sk_live_...).

1. Acesse dashboard.stripe.com/register
2. Crie uma conta (aceita email pessoal)
3. Complete a verificação de identidade

1. No dashboard Stripe, vá em Settings → Payment methods
2. Procure por Pix e ative
3. O Pix está disponível pra contas no Brasil, EUA, UE, CA, GB, AU, SG e CH

1. No dashboard, vá em Developers → API keys
2. Copie a Secret key:
   • Sandbox: começa com sk_test_
   • Produção: começa com sk_live_

1. Acesse hubpay.dev/dashboard/psps
2. Clique em Conectar novo PSP
3. Selecione Stripe
4. Selecione o ambiente:
   • Test se a chave começa com sk_test_
   • Live se a chave começa com sk_live_
5. Dê um label (ex: "Stripe principal")
6. Cole a Secret Key
7. Clique em Salvar credencial

Após salvar, siga as instruções exibidas na tela pra configurar o webhook no dashboard do Stripe (Developers → Webhooks → Add endpoint).

Selecione os eventos:

• payment_intent.succeeded
• payment_intent.payment_failed
• payment_intent.canceled
• payment_intent.processing

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": "stripe",
    "description": "Teste Stripe Pix",
    "payer": {
      "email": "teste@example.com"
    }
  }'

O Pix copia e cola virá no campo pix.copy_paste.

Testando pagamento no sandbox

No sandbox do Stripe, use o email succeed_immediately@example.com no campo payer.email pra simular pagamento instantâneo:

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": "stripe",
    "payer": {
      "email": "succeed_immediately@example.com"
    }
  }'

O webhook payment_intent.succeeded será disparado em poucos segundos.

Solução de problemas

Links úteis

• Dashboard Stripe
• Documentação Pix Stripe
• API keys