Atualização na Integração de Pagamentos

Migração para Pagamento via iFrame — Ação necessária para parceiros

📣
Para garantir maior segurança nas transações e proteger o ecossistema de pagamentos da plataforma, estamos implementando uma mudança importante na forma como o formulário de pagamento é renderizado no checkout.
A partir da ativação pela Wake Commerce, lojas que utilizam o Conector Wake Gateway passarão a processar o pagamento dentro de um iFrame isolado. Parceiros e agências precisam preparar as lojas antes dessa data.

🔧 O que muda na prática?

O formulário de pagamento deixa de ser renderizado diretamente no DOM da loja e passa a ser exibido dentro de um iFrame seguro. Isso significa que:

A estilização do checkout precisa ser adaptada — campos dentro do iFrame não herdam o CSS global da loja.
Um arquivo CSS dedicado (secure-card.css) deve ser criado e ajustado para cada loja, conforme a versão do Storefront:
- Storefront 2.0 → Assets/CSS
- Storefront 1.0 → /c/checkout no Explorador de Arquivos do SE

🧪 Como testar antes da ativação?

O teste pode ser feito sem nenhuma alteração em produção, usando um cookie de sessão no console do navegador (F12):

document.cookie = "use-secure-gateway=true; path=/";

Isso habilita o iFrame apenas para a sua sessão. Após validar o layout, remova o cookie:

document.cookie = "use-secure-gateway=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/;";

⚠️
Storefront 2.0 com snippets customizados
Se o cookie não refletir na loja, os snippets nativos de renderização do formulário foram customizados. Nesse caso, crie uma branch de testes, localize a query que renderiza o meio de pagamento selecionado e adicione selectedPaymentMethod(useSecureGateway: true). Essa alteração é apenas para teste — não faça commit e não utilize em produção.

🚀 O que você precisa fazer?

Realize os testes: Use o cookie de sessão para visualizar o iFrame na loja e identificar ajustes necessários no CSS.
Crie ou ajuste o secure-card.css: Garanta que o formulário de pagamento esteja visualmente consistente com o layout da loja.
Aguarde a ativação: A ativação definitiva será feita pela Wake Commerce. Quando ocorrer, sua loja já estará preparada.

📋 Escopo desta versão

Esta migração se aplica, neste primeiro momento, exclusivamente a lojas com o Conector Wake Gateway ativo. Outros conectores serão comunicados em etapas futuras.

🚧
Ativação pela Wake Commerce
Você não precisa — e não deve — ativar o iFrame manualmente nas configurações da loja. A ativação será feita pelo nosso time. Sua responsabilidade como parceiro é garantir que os testes foram realizados e o secure-card.css está pronto.
Em caso de dúvidas, acione o Canal de Parceiros ou o seu Customer Success.