A Woovi lançou o link de pagamento no domínio da sua empresa. Em vez de `woovi.com/pay/...`, seu cliente abre um endereço como `pagar.sualoja.com.br` e paga com Pix na mesma página de sempre, com QR Code e Pix Copia e Cola.
O que muda?
O endereço da cobrança passa a ser o da sua marca nos dois pontos que o pagador acessa:
- Link de pagamento: a página com valor, QR Code e Pix Copia e Cola, agora no seu domínio.
- Comprovante: disponível no mesmo endereço, em `/receipts/{paymentLinkID}`.
A confirmação continua em tempo real: assim que o Pix é pago, a página muda para "pago" sem recarregar.
Como funciona?
Toda a configuração fica na sua infraestrutura. Um proxy reverso no seu domínio encaminha as requisições para a Woovi, que continua entregando a página, o QR Code e a confirmação. Não há nada a alterar na plataforma Woovi.
O que você precisa:
- Um domínio ou subdomínio da sua empresa.
- Um certificado TLS válido para esse endereço (Let's Encrypt, por exemplo).
- Um proxy reverso: nginx, Caddy, Traefik, Cloudflare ou o load balancer da sua nuvem.
Configuração em 4 passos:
1. Encaminhe os caminhos de pagamento: direcione `/pay/` (página, scripts, ícones e a API `/pay/graphql`) e, se quiser o comprovante no seu domínio, `/receipts/` para `https://woovi.com`, preservando caminho e query string.
2. Ajuste Host e SNI: envie o cabeçalho `Host: woovi.com` e use `woovi.com` como SNI na conexão TLS.
3. Repasse as respostas como chegam: aceite `GET` e `POST`, sem reescrever nem armazenar em cache. O HTML traz o QR Code e o Pix Copia e Cola de cada cobrança.
4. Monte o link no seu domínio: use o `paymentLinkID` retornado na criação da cobrança para gerar a URL no seu endereço.
Antes de ir para produção:
1. Crie uma cobrança de teste e copie o `paymentLinkID`.
2. Abra o link no seu domínio e confira valor, QR Code e botão de copiar o Pix.
3. Confirme que a API da página responde pelo seu domínio (`POST /pay/graphql`).
4. Pague a cobrança e veja a página mudar para "pago" sem recarregar.
Pontos de atenção para o time de tecnologia:
- A confirmação em tempo real usa WebSocket direto com `woovi.com`. Se o seu site usa Content Security Policy, inclua essa conexão em `connect-src`.
- As imagens da página são servidas por `img.woovi.com`.
- Para que o pagador receba só o link da sua marca, envie as notificações de cobrança pelo seu próprio sistema.
- Operações com alto volume de cobranças podem alinhar a configuração com o time da Woovi antes de entrar em produção.
- Trate o proxy com o mesmo cuidado do seu site principal: HTTPS em todo o caminho entre pagador, proxy e Woovi, e acesso restrito à configuração do proxy e do DNS.
Por que isso importa?
- Endereço reconhecível: o pagador vê o domínio da sua marca antes de pagar, o mesmo do seu site e das suas comunicações.
- Mesma operação de sempre:página, API, confirmação e conciliação continuam na Woovi, sem mudança no seu fluxo de cobrança.
- Controle com o seu time: domínio, certificado e proxy ficam na sua infraestrutura, configurados do jeito que sua empresa já trabalha.
Como ativar?
Não há nada a ativar na plataforma. Basta configurar o proxy seguindo o guia, que traz exemplos prontos para nginx e Caddy. No Caddy, o certificado é emitido automaticamente.
📘 Guia completo: https://developers.woovi.com/docs/charge/how-to-payment-link-custom-domain
