NovoApp da Woovi: sua conta PJ e Pix no celular
Woovi Logo
Changelog

Link de pagamento Pix com o domínio da sua empresa

Publicado em 19 de outubro de 2026

Domínio copiar.webp

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

Copyright © Woovi Instituição de Pagamento LTDA - CNPJ: 54.811.417/0001-63

Av. Santo Amaro, 3432, Brooklin - São Paulo

Woovi Logo