Integração personalizada

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 Painel -> Configurações -> Cobrança.

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:

1. Navegue até Painel -> Configurações -> Configurações de finalização de compra.
2. Clique em Adicionar conta bancária
3. 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 o documentação da listra.

Observação: Se você precisar atualizar seu calendário de pagamentos, entre em contato com support@zonos.com

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:

1. Navegue até Painel -> Configurações -> Configurações de finalização de compra
2. 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.

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:

1. Navegue até Painel -> Configurações -> Configurações de checkout -> Marca
2. Defina as seguintes configurações: -Logotipo.
   • Marca e cor de destaque.
   • Tema, estilo e fonte.

Para obter mais informações sobre configurações de marca, consulte nosso 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:

1. Navegue até Painel -> Configurações -> Frete -> Taxas
2. Clique em Adicionar operadora
3. Siga as instruções de configuração da operadora.

Para obter mais detalhes sobre como conectar contas de operadora, consulte nosso 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:

1. Navegue até Painel -> Configurações -> Frete -> Locais
2. Clique em Nova zona
3. Insira um nome de zona e selecione os países para os quais deseja enviar.
4. Selecione a operadora e o nível de serviço que deseja oferecer.

Para mais detalhes sobre áreas de envio, consulte nosso 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:

1. Navegue até Painel -> Configurações -> Frete -> Catálogo.
2. Para país de origem, selecione o país onde a maioria dos seus produtos é fabricada.
3. 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.

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.

4. Passe os IDs correspondentes pelo seu customHTML Faça check-out 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:

• Google Analytics 4 para Checkout com iframe
• Pixel do Facebook para Checkout com iframe

Para sincronizar pedidos entre seu sistema e o Zonos Dashboard, implemente estas chamadas de API e webhooks:

Mutações obrigatórias 

Webhooks necessários 

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.

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 Painel -> 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.

Pesquise o pedido de zonosCheckoutSessionId 

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.

Envie a consulta para https://api.zonos.com/graphql com seu token de credencial secreto em Painel -> Configurações -> Integrações passado como cabeçalho da solicitação credentialToken.

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.