O Checkout Rishi tem um sistema próprio de login que dispensa senha. O cliente digita o e-mail e recebe um link mágico ou um código de acesso de 6 dígitos. Em seguida, é direcionado de volta ao checkout já autenticado.
Modos disponíveis
A configuração fica em WooCommerce → Configurações → Pagamento → Checkout Inteligente, no campo Tipo de login.
| Opção | Como funciona |
|---|---|
| Tela individual (padrão) | Login aparece em uma tela dedicada antes do checkout. |
| Etapa do checkout | Login vira a primeira etapa da timeline. |
| Junto dos dados de perfil | Login fica embutido no formulário de dados do cliente. |
O modo de envio (link mágico ou código) é controlado por uma opção adicional no mesmo bloco.
Link mágico
O cliente digita o e-mail, recebe uma mensagem com um link, clica e é autenticado automaticamente. O link contém parâmetros assinados e é válido por um tempo limitado.
Exemplo de URL gerada:
https://exemplo.com.br/wc-api/smart-checkout/login/?uid=1&magic_login=b272f22ada678c009c50
Código de acesso
O cliente digita o e-mail, recebe um código de 6 dígitos por e-mail, digita o código no checkout e é autenticado. É um passo a mais que o link mágico, mas resolve cenários onde o cliente abre o link em um navegador diferente.
Cache
Para o link mágico funcionar em sites com cache, garanta que:
- A API do WooCommerce esteja ativa (rota
/wc-api/). - O sistema de cache faça bypass quando o parâmetro
magic_loginaparecer na URL.
A maioria dos plugins de cache faz isso automaticamente. Se o cliente clica no link mas continua deslogado, o cache provavelmente está retornando uma página estática.
Como testar
- Conecte-se à conta de administrador do site.
- Instale o plugin WP Mail Logging — ele registra todos os e-mails enviados pelo site.
- Em uma aba anônima, adicione itens ao carrinho e vá ao checkout.
- Informe o e-mail de uma segunda conta de cliente que você tenha acesso.
- Solicite o link.
- Volte à aba do administrador e abra Ferramentas → WP Mail Log.
- Encontre o último e-mail e copie o link com o botão direito.
- Cole em uma nova aba — a conta deve ser autenticada.
Abrir com clique direito → "Abrir em nova aba" preserva os parâmetros do link. Alguns navegadores reescrevem a URL ao clicar diretamente no preview do e-mail.
Problemas comuns
- Cliente não é redirecionado — verifique a mensagem de erro exibida e confirme que os parâmetros obrigatórios estão na URL.
- Cliente é logado mas vai para a Página inicial — algum plugin ou snippet força redirecionamento após login. Procure por
wp_loginactions. - Cliente é redirecionado mas as credenciais são inválidas — se o usuário tem dupla autenticação ativa, o link mágico não funciona. O cliente precisa logar normalmente nesse caso.
Filtros e actions para devs
do_action( 'wc_smart_checkout_link_request_sent', $url, $user )— disparado após o link mágico ser enviado.do_action( 'wc_smart_checkout_access_code_sent', $code, $user )— disparado após o código de acesso ser enviado.do_action( 'wc_smart_checkout_link_request_error', $error, $email )— disparado em caso de erro de envio.apply_filters( 'wc_smart_checkout_do_not_restore_cart_on_access_link', false )— retornetruepara impedir que o carrinho seja restaurado quando o cliente clicar no link.
Veja a referência completa em Hooks e filtros.