Apple Pay via Gateway Wake

O Apple Pay permite que seus clientes finalizem compras com Face ID, Touch ID ou Apple Watch — sem digitar dados do cartão. 

Este guia cobre todo o processo de habilitação: criação do Merchant ID, configuração dos certificados, verificação de domínio e ativação no ADM Wake.

PRÉ-REQUISITOS

Antes de iniciar, certifique-se de ter todos os pré-requisitos abaixo:

• Storefront 2.0 habilitado — o Apple Pay não é compatível com versões anteriores do checkout
• Conta Apple Developer ativa — assinatura anual de US$ 99 em developer.apple.com
• Conta no Gateway Wake — acesso ao admin Wake com permissão para configurar conectores de pagamento

MÓDULO 1 — CRIAR O MERCHANT ID NO APPLE DEVELOPER

O Merchant ID identifica sua loja de forma exclusiva no ecossistema Apple Pay. Ele não expira e pode ser reutilizado em múltiplos domínios e plataformas.

Passo 1 — Acesse o Apple Developer e abra Identifiers

Faça login em developer.apple.com. No menu principal, acesse Certificates, Identifiers & Profiles. Na barra lateral, selecione Identifiers e, no menu suspenso à direita, escolha Merchant IDs.

Tela inicial do Apple Developer — acesse 'Certificados, IDs e Perfis'

Lista de Identifiers — selecione 'Merchant IDs' no menu suspenso

Passo 2 — Crie um novo Merchant ID

Clique no botão + no canto superior esquerdo. Na tela de seleção de tipo, escolha Merchant IDs e clique em Continue.

Selecione 'Merchant IDs' na lista de tipos de identifier

Preencha a Description (nome amigável que você usará para identificar qual o seu Mercahnt ID) e o Identifier — use o padrão reverse-domain. Exemplo: loja com URL www.minhaloja.com.br coloque no identifier  merchant.com.minhaloja. 

Clique em Continue e confirme em Register.

Preencha Description e Identifier — o identificador não poderá ser alterado após o registro

Atenção: O Identifier não pode ser alterado após o registro. Escolha um nome representativo do domínio da sua loja antes de confirmar.

Passo 3 — Confirme o Merchant ID criado

Após o registro, seu novo Merchant ID aparecerá na lista de Identifiers. Guarde o valor do Identifier — ele será necessário nas etapas seguintes.

Merchant ID criado e visível na lista — copie o Identifier para uso nas próximas etapas

Passo 4 — Instale a extensão Apple Pay no Gateway Wake

Com o Merchant ID criado, acesse o portal Gateway Wake e instale a extensão no caminho: Configurações > Extensões e Integrações > Apple Pay > + Instalar. Preencha os campos abaixo e clique em Instalar:

• Merchant ID: o identificador criado no Apple Developer.
• Nome da loja: ex: Loja da Wake.
• Origem (URL da loja): endereço da loja onde o Apple Pay estará disponível.

MÓDULO 2 — CONFIGURAR OS CERTIFICADOS

São necessários dois certificados: Merchant Identity Certificate e Payment Processing Certificate. O fluxo para ambos é o mesmo: gerar o CSR no Gateway Wake → fazer upload na Apple → retornar o .cer ao Gateway Wake.

ℹ Validade: Os certificados emitidos pela Apple têm validade de 25 meses. O Gateway Wake enviará um aviso por e-mail antes do vencimento para que você renove com antecedência.

Merchant Identity Certificate

Passo 1 — Gere o CSR no Gateway Wake

Acesse a tela de configuração do Apple Pay no painel do Gateway Wake. No bloco Merchant Identity Certificate, clique em Download CSR — o arquivo .csr será baixado automaticamente.

Clique em 'Download CSR' na seção Merchant Identity Certificate

Atenção: Gere o CSR apenas uma vez por certificado. Gerar um novo CSR invalida o anterior.

Passo 2 — Crie o certificado no Apple Developer

No Apple Developer, abra seu Merchant ID e clique em Edit. Na seção Apple Pay Merchant Identity Certificate, clique em Create Certificate.

Na edição do Merchant ID, clique em 'Create Certificate' na seção Merchant Identity Certificate

Na próxima tela, faça upload do arquivo .csr baixado do Gateway Wake e clique em Continue. Depois, clique em Download para salvar o .cer gerado pela Apple.

Faça upload do .csr e baixe o .cer gerado — este arquivo será enviado de volta ao Gateway Wake

Passo 3 — Faça o upload do .cer no Gateway Wake

Volte à configuração do Apple Pay no Portal Gateway Wake. No campo Upload Certificado (.cer) da seção Merchant Identity Certificate, selecione o arquivo .cer baixado da Apple e salve.

Payment Processing Certificate

Passo 1 — Repita o mesmo fluxo para o Payment Processing Certificate

O processo é idêntico, agora para o bloco Payment Processing Certificate:

1.No Gateway Wake, clique em Download CSR na seção Payment Processing Certificate

2.No Apple Developer, acesse Create Certificate na seção Apple Pay Payment Processing Certificate

3.Faça upload do .csr, baixe o .cer e envie-o de volta ao Gateway Wake

Clique em 'Download CSR' na seção Payment Processing Certificate

No Apple Developer, clique em 'Create Certificate' na seção Payment Processing

Faça upload do CSR do Payment Processing

Passo 2 — Confirme a configuração completa

Com os dois certificados enviados, a tela de configuração exibirá ambos os blocos preenchidos. Clique em Atualizar para salvar.

Configuração concluída — ambos os certificados com CSR gerado e .cer enviado

Atenção: Ambos os certificados são obrigatórios. Nenhuma transação Apple Pay será processada enquanto os dois não estiverem ativos.

MÓDULO 3 — VERIFICAR O DOMÍNIO

A Apple exige que cada URL da loja seja verificada e vinculada ao Merchant ID. Repita este processo para cada domínio que utilizará o Apple Pay.

Passo 1 — Adicione o domínio ao Merchant ID

No Apple Developer, abra seu Merchant ID e localize a seção Merchant Domains. Clique em Add Domain, insira a URL da loja e salve.

Seção 'Merchant Domains' — clique em 'Add Domain' e insira a URL da sua loja

Passo 2 — Baixe o arquivo de verificação .txt

Após salvar, a Apple gera um arquivo .txt de verificação. Clique em Download para salvá-lo.

A Apple indica o caminho onde o arquivo deve ser publicado — baixe o .txt sem editá-lo

Atenção: Não edite o arquivo .txt. Qualquer alteração no conteúdo invalida a verificação.

Passo 3 — Adição do certificado no repositório da loja

Atenção: recomendamos que você peça ajuda à sua agência ou a um desenvolvedor parceiro para concluir esse passo

O documento .txt que você acabou de baixar na Apple Developer no passo anterior, deve ser adicionado na raíz do site através do caminho Root > .well-known 

Para isso, acesse o repositório da sua loja e faça o upload do arquivo dentro da pasta .well-know. 

Feito isso, volte ao portal da Apple Developer e clique no botão “Verify” na mesma tela onde você baixou o certificado .txt

Com o arquivo publicado, clique em 'Verify' no Apple Developer — domínio ficará com status Verified

MÓDULO 4 — ATIVAR NO ADM WAKE

Com o Merchant ID criado, os certificados configurados e o domínio verificado, ative o Apple Pay no painel administrativo da Wake.

Passo 1 — Gere as chaves de API no Portal Gateway Wake

Acesse o Portal Gateway Wake e navegue até:

gateway.fbits.app  →  Configurações  →  Chaves de API  →  Nova chave

Gere duas chaves: uma do tipo Chave privada e outra do tipo Chave pública.

Já tem chaves de cartão de crédito, boleto ou Pix? Você pode reutilizá-las — não é necessário criar novas chaves.

Passo 2 — Acesse o Conector Wallet no ADM Wake

Acesse o ADM Wake  →  Pagamentos  →  Conectores de Pagamento  → Gateway>   Wallet e preencha os dados do conector:

Passo 3 —  Gerenciamento de pagamentos

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

MÓDULO 5 — PONTOS DE ATENÇÃO

Limitações

Pontos de atenção — leia antes de configurar:

• Não compatível com transação única desativada para Split de pedido 
• Não compatível com split de pagamentos no momento
• Adquirente exclusiva: Vindi — o Apple Pay via Gateway Wake processa transações exclusivamente pela adquirente Vindi
• Disponível apenas para Storefront 2.0 — integrações com checkout legado não são suportadas
• Não compatível com assinaturas — cobranças recorrentes não estão disponíveis nesta integração
• Não compatível no momento com Troca de pagamento
• Não compatível com as features de checkout online, não cancelar transações recusadas pela adquirente e estorno total via ADM no momento