Configurar gateway GalaxPay
Como integrar o Quaza ao provedor GalaxPay
Esta wiki ensina a configurar o gateway GalaxPay no Quaza: cadastrar credenciais, vincular à carteira, validar notificação automática e testar. Tipo: Subadquirente foco sistema online/recorrência.
Glossário
| Termo |
O que é |
| Gateway |
API do provedor que gera/cancela cobranças (boleto, PIX, cartão) |
| Notificação automática |
Notificação POST que o provedor envia ao Quaza quando o status muda |
| Token |
Credencial de autenticação (chave da API, autenticação por chave, OAuth) |
| mTLS |
TLS mútuo — certificado cliente exigido pelo provedor |
| Ambiente de testes |
Ambiente de testes — não cobra de verdade |
| Carteira |
Conta financeira do Quaza vinculada ao gateway |
O que GalaxPay cobre
- Boleto
- PIX
- Cartão de Crédito
- Recorrência
- Link de pagamento
| Atributo |
Valor |
| Autenticação |
identificador GalaxPay + chave GalaxPay (OAuth) |
| Notificação automática |
Auto |
| Ambiente de testes |
ambiente de testes.cel.cash |
| Portal |
https://galaxpay.com.br |
Fluxo de configuração
1. Conta no portal GalaxPay
Crie conta produção (e ambiente de testes separada se for testar).
↓
2. Obter credenciais
identificador GalaxPay + chave GalaxPay (OAuth) — extraia do portal.
↓
3. Cadastrar Carteira no Quaza
Financeiro › Carteira → aba Gateway → escolha GalaxPay e cole as credenciais.
↓
4. Configurar Notificação automática (se aplicável)
Auto
↓
5. Testar com cobrança real
Gere uma cobrança de R$ 1,00 — confira que retorna OK e notificação automática chega.
Obter credenciais no portal
Acesse https://galaxpay.com.br
e siga o procedimento de criação de aplicação/integração.
📌 Ambiente de testes vs Produção: ambiente de testes.cel.cash
Configurar carteira no Quaza
Financeiro › Carteira
Adicione carteira; aba Gateway tem os campos do provider GalaxPay.
Notificação automática
Auto
https://[seu-quaza]/notificação automática/financeiro/galaxpay/[id-carteira]
Testar (ambiente de testes)
- Cadastre carteira secundária em modo ambiente de testes no Quaza
- Crie cliente teste e contrato fictício
- Gere cobrança via essa carteira
- Verifique no portal GalaxPay que cobrança aparece
- Simule pagamento (ambiente de testes) e confira notificação automática chegou no Quaza
Verificar Gateway Registro de operações
Financeiro › Financeiro Gateway
Registro de operações mostra cada chamada API + resposta. Filtre por carteira para ver só as chamadas GalaxPay.
Passo a passo: configurar este gateway
💡 Cenário: sua empresa abriu conta no provedor e quer começar a emitir cobranças automaticamente pelo Quaza.
-
Passo 1 — No portal do provedor, gere as credenciais (chave da API ou certificado digital).
-
Passo 2 — No Quaza, abra: Financeiro › Cartera.
-
Passo 3 — Clique em + Adicionar carteira de cobro (ou edite a existente).
-
Passo 4 — Preencha os campos básicos: nome da carteira, banco/instituição, conta.
-
Passo 5 — Vá na aba Gateway.
-
Passo 6 — Selecione o provedor na lista.
-
Passo 7 — Cole a credencial obtida no portal do provedor.
-
Passo 8 — Marque se é Ambiente de testes ou Produção.
-
Passo 9 — Salve a configuração.
-
Passo 10 — Teste: gere uma cobrança de valor baixo e veja se aparece no portal do provedor.
Passo a passo: investigar problema (cliente pagou e Quaza não baixou)
-
Passo 1 — Abra: Financeiro › Financeiro Gateway (gateway log).
-
Passo 2 — Filtre pela carteira correspondente.
-
Passo 3 — Localize a chamada da cobrança em questão.
-
Passo 4 — Veja a resposta do provedor — se OK, a cobrança foi enviada.
-
Passo 5 — Se a notificação automática não chegou: confira no portal do provedor se a URL configurada está acessível (HTTPS válido público).
-
Passo 6 — Última opção: force baixa manual ou aguarde a próxima consulta periódica do Quaza.
- Subadquirente foco recorrência (mensalidade)
- Plano de cobrança nativo
- Negativação Serasa integrada
Pegadinhas
⚠️ 1. identificador GalaxPay ≠ identificador comercial (MerchantId) de outros — formato específico
⚠️ 2. Ambiente de testes URL muda (cel.cash) — atenção configuração
⚠️ 3. Recorrência: ID de plano deve existir na GalaxPay antes
FAQ
Posso ter múltiplas carteiras GalaxPay?
Sim, uma por conta no portal GalaxPay. Tokens diferentes.
Cliente paga mas Quaza não baixa.
Verifique notificação automática (URL pública? HTTPS válido?). Se notificação automática não chegar, espere consulta periódica diário ou force baixa manual.
Token expirou.
Renove no portal GalaxPay e atualize na carteira.