O Checkout Rishi é projetado para máxima compatibilidade, mas algumas coisas não são possíveis no momento. Esta página é honesta sobre o que ele não faz, para evitar surpresas.
Mudanças estruturais de layout
A estrutura do checkout (ordem das etapas, posições dos blocos) não é configurável visualmente. Você pode mudar via CSS se tiver o conhecimento, mas a estrutura é fixa.
Por que: o layout padrão é resultado de testes A/B em vários nichos. Permitir mudar quebra a otimização e introduz casos que precisam ser testados de novo.
Se você tem uma sugestão concreta de mudança que faria sentido para vários casos, abra um ticket — ela pode virar nova configuração.
Visualização de cartão de crédito
Plugins que mostram um "cartão visual" (com bandeira, animação ao virar, etc.) não funcionam integrados ao Checkout Rishi.
Por que: além de pesado e não-responsivo, esse recurso geralmente carrega bibliotecas grandes de animação. Há planos para um recurso próprio, otimizado, mas só será lançado quando for possível fazer com performance e segurança aceitáveis.
PayPal Transparente
O layout do PayPal Transparente fica "ok", mas não é otimizado da mesma forma que outros gateways.
Por que: o template do PayPal Transparente roda dentro de um iframe carregado direto pelo PayPal. Não há como alterar o conteúdo do iframe — o markup vem de fora.
Conflito com auto-completar do navegador (cartão)
Como o Checkout Rishi limita o tamanho dos campos Número e Complemento do endereço, o auto-completar do navegador pode falhar ao preencher o número do cartão de crédito em alguns gateways.
Esse cenário é raro. Antes de aplicar o ajuste, abra um ticket para confirmar que é esse o problema.
Para desativar a limitação:
add_filter( 'wc_smart_checkout_restrict_address_fields_length', '__return_false' );
Páginas de obrigado em iframes/popups de gateways
Alguns gateways redirecionam o cliente para fora do site para aprovar o pagamento (3DS, autenticação bancária). A página de obrigado só aparece após o cliente voltar ao site.
Por que: o controle do fluxo está com o gateway. O Checkout Rishi não consegue interceptar a etapa de aprovação externa.
Recursos descontinuados
- Juno — descontinuada. Removida do plugin a partir da v1.9.x.
- Suporte ao PHP 7.4 — removido em v2.3.3 (após reverter).
Backports e suporte a versões antigas
O plugin requer:
- PHP 7.3+ (mínimo) — recomendado PHP 8.2+.
- WooCommerce versão atual ou recente (até 2 versões major atrás).
- WordPress versão atual ou recente.
Não há suporte para versões muito antigas de WordPress/WooCommerce. Se você está em uma versão fora desse intervalo, atualize antes.
Não é um plugin de internacionalização
O Checkout Rishi é otimizado para o mercado brasileiro. Embora algumas configurações possam funcionar em outros mercados, recursos como:
- CEP (BrazilAPI/ViaCEP) — específico do Brasil.
- CPF/CNPJ — campos com validação brasileira.
- Pix — método específico do Brasil.
Não fazem sentido fora daqui. Lojas internacionais devem usar checkouts genéricos.
A partir da versão atual há suporte parcial a telefone internacional (primeiro passo para internacionalização), mas o plugin como um todo permanece focado no Brasil.
Sem suporte para personalizações
O suporte oficial cobre:
- Configurações nativas do plugin (Customizer e WooCommerce).
- Bugs reproduzíveis.
- Conflitos com plugins/temas listados em Integrações.
Não cobre:
- CSS/JS personalizado.
- Templates sobrescritos no tema.
- Snippets adicionados via Code Snippets ou functions.php.
- Mudanças que dependem de filtros documentados em Hooks e filtros.
Se você quer customização avançada e não tem desenvolvedor, considere abrir um projeto pago em vez de tentar resolver via tickets.