Siga esta lista de verificação completa para configurar sua conta Zonos Dashboard e integrar o Zonos Checkout em seu site ou plataforma personalizada.
1
Crie uma conta Zonos
Para começar, entre em contato com nossa equipe de vendas para criar uma conta e assinar um contrato. Assim que o contrato for assinado, você receberá dois microdepósitos em sua conta que deverão ser verificados.
Envie esses valores de microdepósito por e-mail para Accounting@zonos.com com seu ID de loja do Dashboard (com uma cópia para seu representante de vendas).
Depois de verificados, seus dados bancários serão exibidos em Dashboard -> Configurações -> Cobrança.
2
Definir configurações do Dashboard e Checkout
Depois de criar sua conta Zonos, você precisará definir as configurações no Dashboard para garantir que o Checkout funcione corretamente com sua loja. Esta seção cobre todas as configurações essenciais do Dashboard.
Conecte uma conta bancária para receber pagamentos pontuais do Checkout. Os pagamentos são processados diariamente com um atraso de 2 dias a partir da cobrança do pagamento. Para fazer isso, siga estas etapas:
Você será direcionado a um portal Stripe para concluir a configuração e fornecer as seguintes informações:
Informações da conta bancária.
EIN da empresa.
Número de Segurança Social de proprietário com 25% da empresa. Para obter mais detalhes sobre por que isso é necessário, consulte a documentação da Stripe.
Observação: Se você precisar atualizar seu calendário de pagamentos, entre em contato com support@zonos.com
O script Zonos JS requer uma lista de domínios permitidos por motivos de segurança. Isso evita que sites não autorizados carreguem o script e garante que ele seja executado apenas nos domínios aprovados. Sem essa configuração, o script retornará erros de permissão.
Em URLs, adicione seu domínio completo e quaisquer subdomínios onde o Checkout será usado. Por exemplo, se o seu domínio for example.com, você deve adicionar example.com e test.example.com.
Para cotar o frete na finalização da compra, você precisará conectar uma transportadora à sua conta Zonos. Isso permitirá que você habilite níveis de serviço de remessa específicos na finalização da compra.
Para conectar uma transportadora, siga estas etapas:
Navegue até Dashboard -> Configurações -> Frete -> Taxas
Clique em Adicionar operadora
Siga as instruções de configuração da operadora.
Para obter mais detalhes sobre como conectar contas de operadora, consulte nossa documentação.
O país de origem e o código HS são usados para calcular impostos e taxas com precisão.
Se você não fornecer um país de origem ou código HS específico, usaremos os valores substitutos configurados no Dashboard.
Para definir seu país de origem e código HS de backup:
Navegue até Dashboard -> Configurações -> Frete -> Catálogo.
Para país de origem, selecione o país onde a maioria dos seus produtos é fabricada.
Para o código HS, insira o código HS do seu produto mais comum. Se você não tiver um código HS, navegue até Classificar no Dashboard e insira o nome e a descrição do produto para gerar um código HS preciso.
3
Instale o snippet Zonos JS
O snippet Zonos JS é uma integração JavaScript do lado do cliente que permite a funcionalidade de checkout global em seu site. Serve como ponte entre sua plataforma de e-commerce e os serviços Zonos, gerenciando:
Experiência de checkout: renderize a interface de checkout e processe pagamentos.
Serviços de localização: detecta a localização do visitante e gerencia a conversão de moeda.
Integração de carrinho: conecta-se ao seu carrinho e sistema de pedidos existente.
Segurança: valida domínios e autentica solicitações de API.
O snippet é carregado de forma assíncrona para evitar qualquer impacto no desempenho do seu site. Ele é inicializado com as credenciais da API da sua loja e lida com todas as interações do lado do cliente com segurança. A implementação foi projetada para ser não intrusiva, exigindo alterações mínimas no fluxo de checkout existente.
Abaixo está um exemplo completo, incluindo carregamento de script, inicialização e manipulação de eventos para referência ao integrar o Checkout.
1
Passe os IDs correspondentes pelo customHTML do Checkout para que o relé saiba qual propriedade/pixel disparar:
1
Para obter instruções passo a passo do iframe, a referência completa do evento (incluindo mapeamento de carga útil de purchase / Purchase) e dicas de depuração, consulte:
Sincroniza o número da sua conta nativa com o Dashboard. Documentos →
orderAddTrackingNumber
Obrigatório somente se você não imprimir etiquetas no Dashboard. Garante que o rastreamento seja exibido no Dashboard para que Zonos possa garantir seus cálculos de custo no destino. Documentos →
Necessário para enviar pedidos do Checkout para sua plataforma nativa. Documentos →
ORDER_STATUS_CHANGED
Mantém seu sistema sincronizado com o Zonos quando o status do pedido muda (por exemplo, atendido, cancelado). Documentos →
7
Teste sua integração
Antes de lançar sua integração com o Checkout, é importante testar exaustivamente todos os aspectos da integração para garantir uma experiência tranquila para o cliente. Isso inclui testar o fluxo de checkout, processamento de pagamentos, criação de pedidos e funcionalidade de webhook.
Siga nosso guia de testes para verificar se sua integração está funcionando corretamente e identificar e corrigir quaisquer problemas antes de liberar para produção.
Perguntas frequentes
Abaixo estão algumas perguntas frequentes sobre o processo de integração.
Configure a experiência pós-compra em Dashboard -> Configurações -> Configurações de finalização de compra em Tipo de página de sucesso. Existem três opções disponíveis:
Mostrar página de sucesso do Zonos (padrão, recomendado) — O Zonos mostra uma página de agradecimento integrada após fazer o pedido. A página é sempre exibida, mesmo que o pedido não seja importado para o seu sistema, assim o comprador sempre recebe a confirmação.
Redirecionar para uma página de sucesso — Zonos aguarda em uma breve tela “Pedido concluído” até que o pedido seja criado e, em seguida, redireciona para o URL de sucesso configurado zOrderNumber (e orderId para carrinhos legados) adicionados como parâmetros de consulta.
Fechar o modal de checkout — Zonos fecha seu modal assim que o pagamento é capturado. Se você também configurar um URL de sucesso, o Zonos redirecionará para esse URL imediatamente após o Stripe receber o pagamento - sem esperar pela criação do pedido - e adicionar zonosCheckoutSessionId como um parâmetro de consulta. Use esta opção quando desejar a transferência mais rápida de volta para sua própria página de sucesso.
Ao usar Fechar o modal de checkout com uma URL de redirecionamento, pode levar alguns segundos para que o pedido seja associado à sessão de checkout após o redirecionamento. Ler zonosCheckoutSessionId do URL e consulte a consulta GraphQL checkoutSession do seu servidor usando seu token de credencial secreto até que o pedido esteja pronto. Nunca chame isso do navegador — o token da credencial secreta deve permanecer no servidor.
1query getCheckoutSession($id: String!
2checkoutSession )
3order
4id
Envie a consulta para https://api.zonos.com/graphql com seu token de credencial secreto em Dashboard -> Configurações -> Integrações passado como cabeçalho da solicitação credentialToken.
Sim. Se você deseja receber notificações quando um pedido for criado, no Dashboard, na seção E-mail de Configurações de finalização de compra, você pode inserir o endereço de e-mail dos membros da equipe que devem ser notificados quando um pedido for criado, enviado ou cancelado.
Integração personalizada
Integração personalizada
Crie uma integração completa do Checkout em seu site personalizado.
Lista de verificação de integração
Siga esta lista de verificação completa para configurar sua conta Zonos Dashboard e integrar o Zonos Checkout em seu site ou plataforma personalizada.
Crie uma conta Zonos
Para começar, entre em contato com nossa equipe de vendas para criar uma conta e assinar um contrato. Assim que o contrato for assinado, você receberá dois microdepósitos em sua conta que deverão ser verificados.
Envie esses valores de microdepósito por e-mail para Accounting@zonos.com com seu ID de loja do Dashboard (com uma cópia para seu representante de vendas).
Depois de verificados, seus dados bancários serão exibidos em Dashboard -> Configurações -> Cobrança.
Definir configurações do Dashboard e Checkout
Depois de criar sua conta Zonos, você precisará definir as configurações no Dashboard para garantir que o Checkout funcione corretamente com sua loja. Esta seção cobre todas as configurações essenciais do Dashboard.
Configurar pagamentos
Conecte uma conta bancária para receber pagamentos pontuais do Checkout. Os pagamentos são processados diariamente com um atraso de 2 dias a partir da cobrança do pagamento. Para fazer isso, siga estas etapas:
Configurar domínios permitidos
O script Zonos JS requer uma lista de domínios permitidos por motivos de segurança. Isso evita que sites não autorizados carreguem o script e garante que ele seja executado apenas nos domínios aprovados. Sem essa configuração, o script retornará erros de permissão.
Para configurá-lo:
example.com, você deve adicionarexample.cometest.example.com.Personalize as configurações da marca
Defina as configurações de sua marca no Dashboard para combinar com a aparência da sua loja.
Para fazer isso, siga estas etapas:
Para obter mais informações sobre configurações de marca, consulte nossa documentação.
Conecte uma transportadora
Para cotar o frete na finalização da compra, você precisará conectar uma transportadora à sua conta Zonos. Isso permitirá que você habilite níveis de serviço de remessa específicos na finalização da compra.
Para conectar uma transportadora, siga estas etapas:
Para obter mais detalhes sobre como conectar contas de operadora, consulte nossa documentação.
Configurar zonas de envio
As zonas de envio permitem configurar quais transportadoras e níveis de serviço estão disponíveis para diferentes regiões do mundo.
Para configurar zonas de envio, siga estas etapas:
Para mais detalhes sobre áreas de envio, consulte nossa documentação.
Defina um país de origem e código HS de backup
O país de origem e o código HS são usados para calcular impostos e taxas com precisão.
Se você não fornecer um país de origem ou código HS específico, usaremos os valores substitutos configurados no Dashboard.
Para definir seu país de origem e código HS de backup:
Instale o snippet Zonos JS
O snippet Zonos JS é uma integração JavaScript do lado do cliente que permite a funcionalidade de checkout global em seu site. Serve como ponte entre sua plataforma de e-commerce e os serviços Zonos, gerenciando:
O snippet é carregado de forma assíncrona para evitar qualquer impacto no desempenho do seu site. Ele é inicializado com as credenciais da API da sua loja e lida com todas as interações do lado do cliente com segurança. A implementação foi projetada para ser não intrusiva, exigindo alterações mínimas no fluxo de checkout existente.
Abaixo está um exemplo completo, incluindo carregamento de script, inicialização e manipulação de eventos para referência ao integrar o Checkout.
customHTMLdo Checkout para que o relé saiba qual propriedade/pixel disparar:Para obter instruções passo a passo do iframe, a referência completa do evento (incluindo mapeamento de carga útil de
purchase/Purchase) e dicas de depuração, consulte:Sincronize o rastreamento e o status do pedido no Dashboard
Para sincronizar pedidos entre seu sistema e o Zonos Dashboard, implemente estas chamadas de API e webhooks:
Mutações obrigatórias
orderUpdateAccountOrderNumberorderAddTrackingNumberWebhooks necessários
ORDER_CREATEDORDER_STATUS_CHANGEDTeste sua integração
Antes de lançar sua integração com o Checkout, é importante testar exaustivamente todos os aspectos da integração para garantir uma experiência tranquila para o cliente. Isso inclui testar o fluxo de checkout, processamento de pagamentos, criação de pedidos e funcionalidade de webhook.
Siga nosso guia de testes para verificar se sua integração está funcionando corretamente e identificar e corrigir quaisquer problemas antes de liberar para produção.
Perguntas frequentes
Abaixo estão algumas perguntas frequentes sobre o processo de integração.
Como o Zonos lida com a confirmação do pedido?
Configure a experiência pós-compra em Dashboard -> Configurações -> Configurações de finalização de compra em Tipo de página de sucesso. Existem três opções disponíveis:
zOrderNumber(eorderIdpara carrinhos legados) adicionados como parâmetros de consulta.zonosCheckoutSessionIdcomo um parâmetro de consulta. Use esta opção quando desejar a transferência mais rápida de volta para sua própria página de sucesso.Pesquise o pedido de
zonosCheckoutSessionIdAo usar Fechar o modal de checkout com uma URL de redirecionamento, pode levar alguns segundos para que o pedido seja associado à sessão de checkout após o redirecionamento. Ler
zonosCheckoutSessionIddo URL e consulte a consulta GraphQLcheckoutSessiondo seu servidor usando seu token de credencial secreto até que o pedido esteja pronto. Nunca chame isso do navegador — o token da credencial secreta deve permanecer no servidor.query getCheckoutSession($id: String!checkoutSession )orderidEnvie a consulta para
https://api.zonos.com/graphqlcom seu token de credencial secreto em Dashboard -> Configurações -> Integrações passado como cabeçalho da solicitaçãocredentialToken.Posso receber uma notificação quando um pedido for criado?
Sim. Se você deseja receber notificações quando um pedido for criado, no Dashboard, na seção E-mail de Configurações de finalização de compra, você pode inserir o endereço de e-mail dos membros da equipe que devem ser notificados quando um pedido for criado, enviado ou cancelado.
Esta página foi útil?