Como Integrar Checkout Transparente a uma Loja Online

O que você precisa antes de começar

Integrar um checkout transparente à sua loja online é conectar duas plataformas por um aplicativo privado que troca dados via API. Na prática, você cria um app dentro da sua loja, dá as permissões certas, copia as chaves de acesso e cola no checkout. Em poucos minutos a coisa está rodando.

Só precisa de duas contas prontas antes de começar: a conta no checkout e a conta na plataforma da loja onde você já vende hoje. Sem essas duas, não tem integração.

O checkout costuma trazer um onboarding guiado. Você segue o passo a passo e ele vai pedindo cada informação na ordem. É simples. O que trava a maioria não é a complexidade, é pular etapa ou perder o token na hora errada. Mais pra frente eu explico por quê.

Onde achar a URL e o domínio da loja

A primeira coisa que o onboarding pede é a URL da sua loja, no formato nome-do-domínio.com.

E como descobrir isso? Direto. Vai na dashboard da sua plataforma, entra em configurações. Lá aparece o nome da loja e, logo abaixo, o link no formato .com.

Você copia tudo que vem antes do .com e cola no campo que o checkout pediu. Só o nome do domínio, sem o .com no final. É esse pedaço que identifica sua loja na hora de conectar.

Como criar o aplicativo privado para a conexão

Agora vem a parte que assusta quem nunca mexeu, mas é mecânico.

O app privado é a ponte. É ele que carrega as permissões e libera o checkout pra ler e gravar dados na sua loja. Sem o app, não existe conexão.

O onboarding normalmente tem um botão que leva direto pra página certa. Você clica, ele pede pra permitir o desenvolvimento de aplicativos personalizados, você permite. Pede de novo, permite de novo. Plataforma é assim, confirma tudo duas vezes.

Depois você clica em criar um app. Funciona assim:

• Nome do app: usa o nome do próprio checkout, pra você identificar depois
• Campo de desenvolvedor: deixa exatamente o que já vem preenchido, não mexe
• Clica em criar app

Pronto. O aplicativo existe. Mas ainda não faz nada, porque está sem permissão nenhuma.

Como configurar escopos e permissões de API

App criado, agora vem o passo que define se a integração vai funcionar de verdade: as permissões de acesso.

Você clica em configurar escopos da API. É aqui que você libera o app pra acessar partes da sua loja: produtos, pedidos, clientes, e por aí vai.

Um aviso de quem já apanhou com isso. As plataformas atualizam as permissões com frequência. De vez em quando o checkout passa a exigir um escopo novo que antes nem existia. Aí o que acontece: a integração que rodava lisa começa a falhar e você nem sabe por quê.

A recomendação é dar todas as permissões disponíveis, no nível mais alto, leitura e escrita. Assim, se a plataforma pedir um escopo a mais lá na frente, você não precisa voltar, refazer o app e reconfigurar tudo do zero.

Depois de marcar tudo, você deixa sempre a versão mais recente da API selecionada e clica em salvar. Vai aparecer a janela confirmando que a configuração foi salva.

Como gerar e usar as chaves e o token de acesso

Configuração salva, você vai em credenciais da API. É de onde saem as chaves que entram no checkout.

Mas antes de revelar qualquer chave, você precisa instalar o app. Clica em instalar app, confirma instalar de novo. Só depois disso as credenciais ficam disponíveis.

Agora presta atenção, porque essa é a parte onde mais gente se queima:

O token de acesso só aparece uma única vez. Depois que você clica em revelar e copiar, ele some pra sempre. Fechou o navegador, computador desligou, deu qualquer pane, acabou. Você vai ter que apagar o app e criar tudo de novo. Não tem botão de mostrar de novo.

Então faça na ordem, com calma:

1. Copia a chave de API e cola no campo chave de API do checkout
2. Copia a chave secreta e cola no campo correspondente
3. Revela o token de acesso, copia na hora e cola imediatamente

Com os três campos preenchidos, clica em próximo. A conexão entre loja e checkout está feita.

Como importar os produtos para o novo checkout

Última etapa: trazer todo o catálogo da loja pra dentro do checkout, pra você organizar as ofertas no novo ambiente.

O checkout puxa os produtos via API, usando exatamente as permissões que você liberou lá atrás. Por isso o passo das permissões importa tanto. Se faltou escopo de leitura de produto, a importação trava aqui.

O tempo de importação varia com o tamanho do catálogo. Loja com poucos produtos importa em segundos. Catálogo grande pode levar mais. Deixa rodar e não fecha a aba no meio.

Uma observação pra quem opera no volume: configurar uma integração é um trabalho pontual, mas escalar campanha em cima dela não é. Quem roda muitos produtos em várias contas de anúncio acaba lidando com naming repetitivo e setup manual conta por conta. Pra essa parte do fluxo, plataformas como o DirectAds padronizam naming e configuração entre contas, tirando o erro humano de cada subida.

Takeaways

• Tenha as duas contas prontas (checkout e plataforma da loja) antes de iniciar o onboarding.
• Libere todas as permissões de API no nível leitura e escrita, pra não refazer o app quando a plataforma exigir escopo novo.
• Copie o token de acesso no exato momento em que ele aparece. Ele revela uma vez só.
• Confira a importação dos produtos até o fim antes de fechar a aba.

Perguntas frequentes

O token de acesso aparece mais de uma vez?

Não. O token revela uma única vez. Depois de copiar, ele some. Se perder, a saída é apagar o aplicativo e criar outro do zero pra gerar um token novo.

Por que dar todas as permissões de API?

Porque as plataformas atualizam os escopos com frequência. Liberando tudo agora, você evita que uma exigência futura quebre a integração e force você a reconfigurar o app.

Onde encontro a URL da minha loja?

Na dashboard da plataforma, dentro de configurações. O nome da loja aparece com o link no formato .com logo abaixo. Você copia só o que vem antes do .com.

Quanto tempo demora pra importar os produtos?

Depende da quantidade. Catálogos pequenos importam em segundos, catálogos grandes levam mais. Deixe o processo rodar sem fechar a aba.