Conectar a Shopify com segurança

Este guia se aplica à versão do ShopiPress indicada no cabeçalho da página, publicada oficialmente no Freemius. Confirme a versão instalada antes de aplicar o procedimento. Versões posteriores podem alterar telas, valores padrão ou fronteiras de serviço.

Resultado esperado

Uma loja Shopify fica conectada com seu subdomínio myshopify.com e um token público da API Storefront. O teste de conexão é concluído sem introduzir uma credencial privada da API Admin.

Use o subdomínio da loja e um token público da API Storefront, teste a conexão e preserve a fronteira comercial.

Antes de começar

• Uma loja Shopify existente e permissão para criar ou obter um token Storefront público.
• Uma instalação do ShopiPress em funcionamento cuja identidade candidata já tenha sido verificada.
• Conexões HTTPS de saída do WordPress para o endpoint Storefront myshopify.com configurado.
• Nenhum dado de cliente, pedido, pagamento nem credencial privada da API Admin nas notas de teste.

Prepare um ponto de restauração e identifique o registro de referência na Shopify e a URL ou tela de administração do WordPress que comprovará o resultado. O teste deve ser pequeno o bastante para ser repetido sem criar um estado de catálogo ambíguo.

Escopo e limites atuais

O candidato exato aceita a conexão de uma única loja. Uma conexão bem-sucedida verifica o alcance do Storefront; não prova que cada registro do catálogo possa ser sincronizado nem que exista automação em segundo plano.

Mantenha o modelo de responsabilidade visível durante toda a tarefa: a Shopify continua sendo a fonte comercial e o sistema de pagamento; o ShopiPress conecta, sincroniza e renderiza o catálogo conforme os contratos entregues; o WordPress detém o contexto de publicação. Um resultado bem-sucedido no WordPress não deve ser interpretado como transferência de pedidos, clientes, pagamentos ou autoridade sobre o estoque.

Procedimento

1. Copie apenas o subdomínio da loja esperado pelo campo, não uma URL arbitrária com caminhos ou parâmetros de consulta.
2. Insira o token Storefront público. Não o substitua por um token de acesso da API Admin quando um teste falhar.
3. Escolha Testar conexão e aguarde uma resposta explícita de sucesso ou de erro.
4. Salve somente depois que o teste de conexão for bem-sucedido e a identidade da loja exibida for a pretendida.
5. Avance para a descoberta do catálogo, examine o resumo e mantenha manual a primeira sincronização.

Não pule a etapa de revisão entre uma ação administrativa e a publicação pública. Uma resposta de controle bem-sucedida é apenas uma camada de evidência; o registro salvo no WordPress, a página renderizada e o caminho comercial da Shopify precisam coincidir.

Verificar o resultado

• A área Início informa a loja conectada em vez de Desconectado.
• A descoberta do catálogo consegue consultar a fonte sem expor o token em páginas renderizadas ou capturas de tela.
• Uma ação de compra continua sendo resolvida pela Shopify e não por um mecanismo transacional do WordPress.

Verifique o resultado na página WordPress renderizada e na superfície autoritativa da Shopify, não apenas na tela de administração do ShopiPress. Use um produto representativo com dados de preço, disponibilidade, variante e coleção. Repita a menor operação segura quando a idempotência importar e registre qualquer diferença antes de ampliar o teste.

Erros frequentes

• Resposta não autorizada: verifique novamente se o token é público, está ativo e associado à loja pretendida.
• Loja não encontrada: normalize o subdomínio myshopify.com e remova protocolos, barras e domínios alheios.
• Erro de rede: confirme que o WordPress consegue fazer requisições HTTPS de saída e que nenhuma camada de segurança bloqueia o endpoint Storefront.

Quando um resultado for inesperado, interrompa as ações amplas e reduza o caso a um registro, uma URL e um renderizador. Preserve a resposta com falha antes de alterar configurações ou limpar caches, para que o diagnóstico permaneça reproduzível.

Solução de problemas

1. Confirme a versão e a edição do pacote.
2. Reproduza o menor caso seguro com dados controlados.
3. Identifique se a Shopify, o ShopiPress ou o WordPress responde pela etapa que falha.
4. Compare o resultado observado com o estado de capacidade entregue, parcial ou ausente.
5. Restaure o ambiente de teste, repita uma vez e registre se o resultado é estável.

Segurança e dados

O token público também merece manuseio controlado porque delimita o acesso à vitrine. Não o exiba em chamados, capturas de tela, gravações de navegador ou configurações versionadas. Restrinja a administração do ShopiPress a papéis confiáveis.

Registre a versão instalada, a edição, as versões do WordPress e do PHP, o construtor ou a integração de SEO ativa, a URL exata, o viewport e as ações ordenadas que produziram o resultado. Capture apenas dados de catálogo controlados. Oculte o token Storefront, dados de clientes, informações de pedidos, domínios privados e qualquer segredo de ambiente antes que um artefato saia do espaço de validação.

Consequências de SEO

A conexão por si só não altera nenhuma decisão canônica. Antes de publicar os produtos sincronizados, decida se a Shopify ou o WordPress é a superfície principal de produto e verifique a resposta renderizada em vez de confiar em um rótulo de configuração.

Evidências a registrar

Registre a versão instalada, a edição, as versões do WordPress e do PHP, o construtor ou a integração de SEO ativa, a URL exata, o viewport e as ações ordenadas que produziram o resultado. Capture apenas dados de catálogo controlados. Oculte o token Storefront, dados de clientes, informações de pedidos, domínios privados e qualquer segredo de ambiente antes que um artefato saia do espaço de validação.

Guias relacionados

• Instalação
• Publicar com WordPress
• Google e SEO
• Segurança e dados

Versão e estado do produto

O ShopiPress está publicado oficialmente no Freemius. Este guia descreve a versão documentada. Os links de compra e download serão adicionados a este site quando seus destinos estiverem configurados.