Como configurar as Carteiras Digitais da Cielo Apple Pay e Google Pay

A Wake agora conta com o Apple Pay e o Google Pay da Cielo homologados para o Storefront 2.0. Com isso, a sua loja pode oferecer pagamento por carteira digital no checkout, com a mesma segurança do cartão tradicional e sem que o cliente precise digitar os dados do cartão.

Um benefício importante de usar as carteiras com a Cielo: você não precisa ter uma conta de Apple Developer. Normalmente, habilitar o Apple Pay exige que o lojista mantenha uma conta de desenvolvedor da Apple, gere o Merchant ID e cuide dos certificados por conta própria. Com a Cielo, toda a geração das credenciais e do arquivo de verificação de domínio é feita dentro do portal da Cielo: você apenas segue o assistente de habilitação, publica no repositório da sua loja o arquivo que a Cielo entrega e depois preenche as chaves no admin da Wake.

Este artigo explica esse processo do início ao fim, para as duas carteiras.

1. Limitações de uso

Antes de iniciar a configuração, conheça os cenários em que as carteiras digitais funcionam:

• Compatíveis apenas com o Storefront 2.0. Lojas em versões anteriores do storefront não conseguem exibir os botões de Apple Pay e Google Pay no checkout.
• Não são compatíveis com Split de pedidos.
• Não são compatíveis com assinaturas (recorrência). As carteiras funcionam somente para compras avulsas.

2. Como configurar o Apple Pay

O processo tem quatro etapas: habilitar a carteira no portal da Cielo, publicar o arquivo de verificação de domínio no repositório da sua loja na Wake, concluir a habilitação na Cielo e, por fim, cadastrar as chaves no admin da Wake.

Etapa 1 — Habilitar o Apple Pay no portal da Cielo

1.Acesse o admin da Cielo e, no menu, vá em Empresas > Minhas empresas.

2.Selecione a razão social para a qual você quer habilitar o Apple Pay.

3.Role a tela até Lista de estabelecimentos e escolha o estabelecimento que será ativado.

4.Clique em Detalhes do estabelecimento e abra a aba Meios de pagamento.

5.Role a página até a seção Carteiras digitais com criptografia e localize o Apple Pay.

6.Ative a carteira pelo toggle.

7.Na pergunta sobre a origem da loja ("Como sua loja online foi criada?"), escolha a opção "Foi criado com Wake (plataforma de loja e-commerce)" e clique em Habilitar.

8.Na tela que se abre, clique em "Veja o passo a passo". É nesse ponto que a Cielo mostra as instruções e fornece o arquivo .txt de verificação de domínio que precisa ser publicado no repositório da sua loja na Wake.

Mantenha essa aba da Cielo aberta: você vai voltar para ela depois de publicar o arquivo.

Etapa 2 — Publicar o arquivo de verificação de domínio no repositório da Wake

Com o conteúdo fornecido pela Cielo em mãos:

1.No admin da Wake, acesse Storefront > Repositório.

2.Verifique qual branch está ativa (por exemplo: sf20). Anote esse nome.

3.Clique no botão "Repositório Git", no canto superior direito.

4.No modal que abrir, acesse o Git. Se você ainda não tem conta, será necessário criar uma.

5.Dentro do Git, troque para a branch com o mesmo nome da branch ativa no admin. Por padrão, o Git sempre abre na branch main — se você publicar o arquivo na branch errada, a validação não funciona.

6.Localize e abra a pasta Root. A partir daqui, há duas possibilidades:

• A pasta .well-known já existe: entre nela, crie o arquivo com o nome informado pela Cielo, cole o conteúdo fornecido e faça o commit.

• A pasta .well-known não existe: crie a pasta com esse nome exato — .well-known — e insira dentro dela o arquivo com o conteúdo fornecido pela Cielo. (No Git, a pasta é criada no momento em que você digita o caminho no nome do arquivo, por exemplo .well-known/nome-do-arquivo.txt.)

7.Clique em Commit changes.

Atenção: o nome do arquivo e o texto dentro do arquivo precisam ser EXATAMENTE os mesmos fornecidos pela Cielo. Qualquer diferença invalida a verificação de domínio e o botão de Apple Pay não é exibido no checkout. Ou seja:

• Não renomeie o arquivo nem altere a extensão .txt.
• Não edite, apague, acrescente nem reordene caracteres do conteúdo.
• Não insira espaços, linhas em branco ou quebras de linha extras.
• Não formate o texto nem salve o conteúdo em editores que alteram a codificação (como o Word). Se precisar conferir, use um editor de texto simples.

Na prática: copie da Cielo e cole no repositório sem tocar em nada.

Etapa 3 — Concluir a habilitação no portal da Cielo

Volte para o admin da Cielo, na tela Habilitar Apple Pay, e termine de preencher as informações solicitadas — estabelecimento e endereço da loja. Depois, clique em Revisão e salve. A partir daqui, as credenciais estão prontas e você já pode configurar as chaves na Wake.

Etapa 4 — Configurar as chaves no admin da Wake

No admin da Wake, acesse Pagamentos > Conectores de pagamento > Cielo - Apple Pay e preencha os campos abaixo. Todos os valores são fornecidos pela Cielo:

Compatibilidade: navegadores e dispositivos

O Apple Pay foi desenvolvido pela Apple para uso no Safari, em dispositivos Apple. Como a Cielo utiliza a versão mais recente do SDK da Apple, também é possível finalizar compras pelo Google Chrome e em dispositivos que não são da Apple: nesse cenário, o checkout exibe um QR Code que o cliente escaneia com a câmera do iPhone para concluir o pagamento no próprio aparelho. Essa jornada por QR Code requer iOS 18 ou versão posterior.

3. Como configurar o Google Pay

3.1 Pré-requisitos

Para habilitar o Google Pay é necessário que o lojista:

1.Tenha uma conta Google Empresas (Google Business). É nela que a loja é registrada junto ao Google para uso da carteira.

2.Gere, na conta Google Empresas, o código de identificação do comerciante (Merchant ID). Esse código é único e vinculado ao domínio da loja — o identificador de um domínio de testes não funciona no domínio de produção, e vice-versa.

3.Habilite a carteira digital junto à Cielo. No portal da Cielo, o Google Pay fica na mesma seção Carteiras digitais com criptografia (em Empresas > Minhas empresas > estabelecimento > Meios de pagamento) utilizada pelo Apple Pay.

4.Informe o código gerado no Google no admin da Wake, no campo GPayMerchantId do conector.

3.2 Configurar as chaves no admin da Wake

Acesse Pagamentos > Conectores de pagamento > Cielo - Google Pay e preencha:

Importante: o GPayMerchantId precisa corresponder ao domínio em que a carteira será utilizada. Se o código estiver vinculado a outro domínio, a compra é iniciada, mas o pagamento não é concluído.

4. 2ª Etapa - Grupos de Pagamento e Parcelamentos

Após as primeiras configurações, você deverá clicar em Grupos e Parcelamentos >> Parcelamentos e seguir o passo a passo completo no artigo Grupos e Pagamentos.

Em resumo, no gerenciamento de pagamentos você deve criar um grupo de pagamento, adicionar a ele as configurações de Apple Pay e/ou Google Pay da Cielo e definir as condições de parcelamento.

Essa é a etapa seguinte à configuração das chaves e é indispensável: sem concluir os Grupos e Parcelamentos, as carteiras não funcionam de fato na Wake.