
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:
-
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/parahttps://woovi.com, preservando caminho e query string. -
Ajuste Host e SNI: envie o cabeçalho
Host: woovi.come usewoovi.comcomo SNI na conexão TLS. -
Repasse as respostas como chegam: aceite
GETePOST, sem reescrever nem armazenar em cache. O HTML traz o QR Code e o Pix Copia e Cola de cada cobrança. -
Monte o link no seu domínio: use o
paymentLinkIDretornado na criação da cobrança para gerar a URL no seu endereço.
Antes de ir para produção:
-
Crie uma cobrança de teste e copie o
paymentLinkID. -
Abra o link no seu domínio e confira valor, QR Code e botão de copiar o Pix.
-
Confirme que a API da página responde pelo seu domínio (
POST /pay/graphql). -
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 emconnect-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
