Conectar PSPs
O Hubpay orquestra seus provedores de pagamento (PSPs). Antes de criar cobranças, você precisa conectar pelo menos um PSP no dashboard.
PSPs suportados
| PSP | Autenticação | Pix | Sandbox | Dificuldade |
|---|---|---|---|---|
| Asaas | API Key | ✓ | ✓ | Fácil |
| Mercado Pago | Access Token | ✓ | ✓ | Fácil |
| Efí (Gerencianet) | Client ID + Secret + Certificado mTLS | ✓ | ✓ | Médio |
| Pagar.me | Secret Key | ✓ | ✓ | Fácil |
| Stark Bank | ECDSA (Project ID + chave privada) | ✓ | ✓ | Médio |
| Stripe | Secret Key | ✓ | ✓ | Fácil |
| Iugu | API Token | ✓ | ✓ (conta de teste) | Fácil |
| PagSeguro / PagBank | Token (Bearer) | ✓ | ✓ | Fácil |
| Banco Inter | Client ID + Secret + Certificado mTLS | ✓ | ✓ | Médio |
| Sicredi | Client ID + Secret + Certificado mTLS | ✓ | ✓ (homologação) | Médio |
| Sicoob | Client ID + Certificado ICP-Brasil mTLS | ✓ | ✓ (sandbox) | Médio-alto |
| OpenPix (Woovi) | AppID | ✓ | ✓ (ambiente de teste) | Muito fácil |
| Bradesco | Client ID + Secret + Certificado mTLS | ✓ | ✓ (homologação) | Alto |
Recomendação para iniciantes
Se é sua primeira vez integrando Pix, recomendamos começar pelo Asaas:
- Cadastro rápido (aprovação automática no sandbox)
- API Key simples, sem certificado
- Documentação clara
- Sandbox totalmente funcional
Usando múltiplos PSPs
Você pode conectar quantos PSPs quiser (no plano Pro ou superior). Com 2 ou mais PSPs conectados, você pode usar provider: "random" para distribuição automática via Smart Routing.
Guias passo a passo
API Key simples, aprovação rápida
Access Token via painel de devs
Client ID + Secret + certificado mTLS
Secret Key simples
Autenticação ECDSA (par de chaves)
Secret Key simples (sk_test_/sk_live_)
API Token simples (grupo Itaú)
Token Bearer + webhook automático
OAuth2 + mTLS (.crt + .key separados, só PJ)
OAuth2 + mTLS (cooperativa, só PJ associado)
Certificado ICP-Brasil A1 (cooperados PF/PJ)
Apenas AppID, sem OAuth nem certificado
OAuth2 + mTLS, exige contato com o banco (PJ)