Conectar OpenPix (Woovi)

⏱ Tempo estimado: 5 minutos

O OpenPix (Woovi) é o PSP mais fácil de integrar — 100% focado em Pix, sem certificados, sem OAuth. Apenas um AppID.

Criar conta no OpenPix

Acesse app.openpix.com
Clique em "Cadastre-se"
Preencha seus dados (aceita PF e PJ)
Complete a verificação

💡O OpenPix oferece ambiente de teste gratuito — você pode testar sem custos.

Obter AppID

No painel, vá em API/Plugins → Nova API
Dê um nome (ex: "Hubpay")
Clique em Salvar
Copie o AppID gerado

O AppID é uma string longa (ex: Q2xpZW50ZV9JZDo...). Copie inteiro.

Conectar no Hubpay

Acesse hubpay.dev/dashboard/psps
Clique em Conectar novo PSP
Selecione OpenPix (Woovi)
Selecione o ambiente (Test ou Live)
Dê um label (ex: "OpenPix principal")
Cole o AppID
Clique em Salvar credencial

Configurar webhook

Após salvar, siga as instruções na tela pra configurar o webhook na plataforma OpenPix.

Testar

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": "openpix",
    "description": "Teste OpenPix"
  }'

Nenhum campo de payer é obrigatório — é o PSP mais flexível.

Por que OpenPix?

Zero certificado — só um AppID
Zero OAuth — sem token, sem refresh, sem expiração
100% Pix — feito especificamente pra Pix
Ambiente de teste gratuito
Documentação excelente em developers.woovi.com
Open source — SDKs e plugins

Solução de problemas

Erro	Causa	Solução
`502` com "unauthorized"	AppID incorreto	Verifique se copiou o AppID completo sem espaços.
`502` com "correlationID duplicado"	Cobrança com mesmo ID já existe	O Hubpay gera IDs únicos automaticamente. Se persistir, pode ser retry duplicado.
Webhook não chega	Webhook não configurado	Configure em API/Plugins → Webhook na plataforma OpenPix.
Status ACTIVE mas quer COMPLETED	Cobrança não foi paga	No teste, use o simulador da OpenPix pra aprovar pagamento.

Testando pagamento no sandbox

A OpenPix oferece simulador de pagamento no painel:

Crie uma cobrança via API
No painel OpenPix, vá em Cobranças → encontre a cobrança
Clique em Simular pagamento (disponível no ambiente de teste)
O webhook OPENPIX:CHARGE_COMPLETED será disparado