Siga esta lista de verificação completa para configurar a sua conta no Zonos Dashboard e integrar o Zonos Checkout no seu site ou plataforma personalizada.
1
Criar uma conta Zonos
Para começar, contacte a nossa equipa de vendas para criar uma conta e assinar um contrato. Depois de assinado o contrato, receberá na sua conta dois microdepósitos que têm de ser verificados.
Envie os valores destes microdepósitos por e-mail para accounting@zonos.com, juntamente com o ID da sua loja no Dashboard (com o seu representante de vendas em CC).
Depois de verificados, os seus dados bancários serão apresentados em Dashboard -> Definições -> Faturação.
2
Configurar as definições do Dashboard e do Checkout
Depois de criar a sua conta Zonos, terá de configurar as definições no Dashboard para garantir que o Checkout funciona corretamente com a sua loja. Esta secção abrange todas as configurações essenciais do Dashboard.
Associe uma conta bancária para receber atempadamente os pagamentos do Checkout. Os pagamentos são processados diariamente, com um prazo de 2 dias a partir da captura do pagamento. Para tal, siga estes passos:
Será redirecionado para um portal da Stripe para concluir a configuração e fornecer as seguintes informações:
Informações da conta bancária.
EIN da empresa.
Número da Segurança Social (Social Security Number) de um proprietário com 25% da empresa. Para mais detalhes sobre o motivo deste requisito, consulte a documentação da Stripe.
Nota: Se precisar de alterar o calendário dos seus pagamentos, contacte support@zonos.com
O script Zonos JS requer uma lista de domínios permitidos por motivos de segurança. Isto impede que sites não autorizados carreguem o script e garante que este só é executado nos seus domínios aprovados. Sem esta configuração, o script devolverá erros de permissão.
Em URLs, adicione o seu domínio completo e todos os subdomínios onde o Checkout será utilizado. Por exemplo, se o seu domínio for example.com, deve adicionar example.com e test.example.com.
Para apresentar cotações de envio no checkout, terá de associar uma transportadora à sua conta Zonos. Isto permitir-lhe-á ativar níveis de serviço de envio específicos no checkout.
Para associar uma transportadora, siga estes passos:
Navegue até Dashboard -> Definições -> Envio -> Tarifas
Clique em Adicionar transportadora
Siga as instruções de configuração da transportadora.
Para mais detalhes sobre como associar contas de transportadoras, consulte a nossa documentação.
O país de origem e o código HS são utilizados para calcular com precisão os direitos aduaneiros e os impostos.
Se não indicar um país de origem ou um código HS específico, utilizaremos os valores de recurso configurados no Dashboard.
Para definir o país de origem e o código HS de recurso:
Navegue até Dashboard -> Definições -> Envio -> Catálogo.
Para o país de origem, selecione o país onde a maioria dos seus produtos é fabricada.
Para o código HS, introduza o código HS do seu produto mais comum. Se não tiver um código HS, navegue até Classify no Dashboard e introduza o nome e a descrição do produto para gerar um código HS preciso.
3
Instalar o snippet Zonos JS
O snippet Zonos JS é uma integração JavaScript do lado do cliente que ativa a funcionalidade de checkout global no seu site. Funciona como ponte entre a sua plataforma de comércio eletrónico e os serviços Zonos, tratando de:
Experiência de checkout: apresenta a interface do checkout e processa os pagamentos.
Serviços de localização: deteta a localização do visitante e gere a conversão de moeda.
Integração do carrinho: liga-se ao seu carrinho e sistema de encomendas existentes.
Segurança: valida os domínios e autentica os pedidos à API.
O snippet é carregado de forma assíncrona para não afetar o desempenho do seu site. É inicializado com as credenciais de API da sua loja e trata de todas as interações do lado do cliente de forma segura. A implementação foi concebida para ser pouco intrusiva, exigindo alterações mínimas ao seu fluxo de checkout existente.
Segue-se um exemplo completo, que inclui o carregamento do script, a inicialização e o tratamento de eventos, para consultar ao integrar o Checkout.
1
Passe os IDs correspondentes através do customHTML do Checkout para que o relay saiba em que propriedade/pixel deve disparar os eventos:
1
Para instruções passo a passo para iframes, a referência completa de eventos (incluindo o mapeamento do payload de purchase / Purchase) e sugestões de depuração, consulte:
Sincroniza o número de encomenda nativo da sua conta com o Dashboard. Documentação →
orderAddTrackingNumber
Obrigatória apenas se não imprimir as etiquetas no Dashboard. Garante que o número de seguimento aparece no Dashboard para que a Zonos possa garantir os seus cálculos de landed cost. Documentação →
Necessário para enviar as encomendas do Checkout para a sua plataforma nativa. Documentação →
ORDER_STATUS_CHANGED
Mantém o seu sistema sincronizado com a Zonos quando o estado das encomendas muda (por exemplo, expedida, cancelada). Documentação →
7
Testar a sua integração
Antes de colocar a sua integração do Checkout em produção, é importante testar exaustivamente todos os aspetos da integração para garantir uma experiência sem problemas para o cliente. Isto inclui testar o fluxo de checkout, o processamento de pagamentos, a criação de encomendas e o funcionamento dos webhooks.
Siga o nosso guia de testes para verificar se a sua integração está a funcionar corretamente e para identificar e corrigir eventuais problemas antes de a lançar em produção.
Perguntas frequentes
Seguem-se algumas perguntas frequentes sobre o processo de integração.
Configure a experiência pós-compra em Dashboard -> Definições -> Definições do Checkout, em Tipo de página de sucesso. Estão disponíveis três opções:
Mostrar a página de sucesso da Zonos (predefinição, recomendada) — A Zonos apresenta uma página de agradecimento integrada depois de a encomenda ser efetuada. A página é sempre apresentada, mesmo que a importação da encomenda para o seu sistema falhe, pelo que o comprador recebe sempre uma confirmação.
Redirecionar para uma página de sucesso — A Zonos aguarda num breve ecrã "Encomenda concluída" até a encomenda ser criada e, em seguida, redireciona para o URL de sucesso configurado, acrescentando zOrderNumber (e orderId para carrinhos antigos) como parâmetros de consulta.
Fechar o modal do checkout — A Zonos fecha o seu modal assim que o pagamento é capturado. Se também configurar um URL de sucesso, a Zonos redireciona para esse URL imediatamente depois de a Stripe cobrar o pagamento — sem esperar que a encomenda seja criada — e acrescenta zonosCheckoutSessionId como parâmetro de consulta. Utilize esta opção quando pretender o regresso mais rápido possível à sua própria página de sucesso.
Quando utiliza Fechar o modal do checkout com um URL de redirecionamento, a encomenda pode demorar alguns segundos a ficar associada à sessão de checkout após o redirecionamento. Leia zonosCheckoutSessionId a partir do URL e consulte periodicamente a query GraphQL checkoutSession a partir do seu servidor, utilizando o seu token de credencial secreto, até a encomenda estar pronta. Nunca faça esta chamada a partir do navegador — o token de credencial secreto tem de permanecer no servidor.
1query getCheckoutSession($id: String!){
2 checkoutSession(id:$id) {
3 order {
4 id
5}
6}
7}
Envie a query para https://api.zonos.com/graphql com o seu token de credencial secreto, obtido em Dashboard -> Definições -> Integrações, passado no cabeçalho do pedido credentialToken.
Sim. Se pretender receber notificações quando for criada uma encomenda, pode introduzir, no Dashboard, na secção E-mail das Definições do Checkout, o endereço de e-mail dos membros da equipa que devem ser notificados quando uma encomenda for criada, expedida ou cancelada.
Integração personalizada
Integração personalizada
Crie uma integração completa do Checkout no seu site personalizado.
Lista de verificação da integração
Siga esta lista de verificação completa para configurar a sua conta no Zonos Dashboard e integrar o Zonos Checkout no seu site ou plataforma personalizada.
Criar uma conta Zonos
Para começar, contacte a nossa equipa de vendas para criar uma conta e assinar um contrato. Depois de assinado o contrato, receberá na sua conta dois microdepósitos que têm de ser verificados.
Envie os valores destes microdepósitos por e-mail para accounting@zonos.com, juntamente com o ID da sua loja no Dashboard (com o seu representante de vendas em CC).
Depois de verificados, os seus dados bancários serão apresentados em Dashboard -> Definições -> Faturação.
Configurar as definições do Dashboard e do Checkout
Depois de criar a sua conta Zonos, terá de configurar as definições no Dashboard para garantir que o Checkout funciona corretamente com a sua loja. Esta secção abrange todas as configurações essenciais do Dashboard.
Configurar os pagamentos ao comerciante
Associe uma conta bancária para receber atempadamente os pagamentos do Checkout. Os pagamentos são processados diariamente, com um prazo de 2 dias a partir da captura do pagamento. Para tal, siga estes passos:
Configurar os domínios permitidos
O script Zonos JS requer uma lista de domínios permitidos por motivos de segurança. Isto impede que sites não autorizados carreguem o script e garante que este só é executado nos seus domínios aprovados. Sem esta configuração, o script devolverá erros de permissão.
Para configurar:
example.com, deve adicionarexample.cometest.example.com.Personalizar as definições de marca
Configure as definições de marca no Dashboard para corresponderem à imagem e ao estilo da sua loja.
Para tal, siga estes passos:
Para mais informações sobre as definições de marca, consulte a nossa documentação.
Associar uma transportadora
Para apresentar cotações de envio no checkout, terá de associar uma transportadora à sua conta Zonos. Isto permitir-lhe-á ativar níveis de serviço de envio específicos no checkout.
Para associar uma transportadora, siga estes passos:
Para mais detalhes sobre como associar contas de transportadoras, consulte a nossa documentação.
Configurar zonas de envio
As zonas de envio permitem configurar que transportadoras e níveis de serviço estão disponíveis para as diferentes regiões do mundo.
Para configurar zonas de envio, siga estes passos:
Para mais detalhes sobre as zonas de envio, consulte a nossa documentação.
Definir um país de origem e um código HS de recurso
O país de origem e o código HS são utilizados para calcular com precisão os direitos aduaneiros e os impostos.
Se não indicar um país de origem ou um código HS específico, utilizaremos os valores de recurso configurados no Dashboard.
Para definir o país de origem e o código HS de recurso:
Instalar o snippet Zonos JS
O snippet Zonos JS é uma integração JavaScript do lado do cliente que ativa a funcionalidade de checkout global no seu site. Funciona como ponte entre a sua plataforma de comércio eletrónico e os serviços Zonos, tratando de:
O snippet é carregado de forma assíncrona para não afetar o desempenho do seu site. É inicializado com as credenciais de API da sua loja e trata de todas as interações do lado do cliente de forma segura. A implementação foi concebida para ser pouco intrusiva, exigindo alterações mínimas ao seu fluxo de checkout existente.
Segue-se um exemplo completo, que inclui o carregamento do script, a inicialização e o tratamento de eventos, para consultar ao integrar o Checkout.
customHTMLdo Checkout para que o relay saiba em que propriedade/pixel deve disparar os eventos:Para instruções passo a passo para iframes, a referência completa de eventos (incluindo o mapeamento do payload de
purchase/Purchase) e sugestões de depuração, consulte:Sincronizar o acompanhamento e o estado das encomendas com o Dashboard
Para sincronizar as encomendas entre o seu sistema e o Zonos Dashboard, implemente estas chamadas à API e estes webhooks:
Mutações obrigatórias
orderUpdateAccountOrderNumberorderAddTrackingNumberWebhooks obrigatórios
ORDER_CREATEDORDER_STATUS_CHANGEDTestar a sua integração
Antes de colocar a sua integração do Checkout em produção, é importante testar exaustivamente todos os aspetos da integração para garantir uma experiência sem problemas para o cliente. Isto inclui testar o fluxo de checkout, o processamento de pagamentos, a criação de encomendas e o funcionamento dos webhooks.
Siga o nosso guia de testes para verificar se a sua integração está a funcionar corretamente e para identificar e corrigir eventuais problemas antes de a lançar em produção.
Perguntas frequentes
Seguem-se algumas perguntas frequentes sobre o processo de integração.
Como é que a Zonos trata a confirmação de encomendas?
Configure a experiência pós-compra em Dashboard -> Definições -> Definições do Checkout, em Tipo de página de sucesso. Estão disponíveis três opções:
zOrderNumber(eorderIdpara carrinhos antigos) como parâmetros de consulta.zonosCheckoutSessionIdcomo parâmetro de consulta. Utilize esta opção quando pretender o regresso mais rápido possível à sua própria página de sucesso.Procurar a encomenda a partir de
zonosCheckoutSessionIdQuando utiliza Fechar o modal do checkout com um URL de redirecionamento, a encomenda pode demorar alguns segundos a ficar associada à sessão de checkout após o redirecionamento. Leia
zonosCheckoutSessionIda partir do URL e consulte periodicamente a query GraphQLcheckoutSessiona partir do seu servidor, utilizando o seu token de credencial secreto, até a encomenda estar pronta. Nunca faça esta chamada a partir do navegador — o token de credencial secreto tem de permanecer no servidor.query getCheckoutSession($id: String!) {checkoutSession(id: $id) {order {id}}}Envie a query para
https://api.zonos.com/graphqlcom o seu token de credencial secreto, obtido em Dashboard -> Definições -> Integrações, passado no cabeçalho do pedidocredentialToken.Posso ser notificado quando é criada uma encomenda?
Sim. Se pretender receber notificações quando for criada uma encomenda, pode introduzir, no Dashboard, na secção E-mail das Definições do Checkout, o endereço de e-mail dos membros da equipa que devem ser notificados quando uma encomenda for criada, expedida ou cancelada.
Esta página foi útil?