Apple Pay Vindi: Como funciona esta carteira digital e como utilizar?
O Apple Pay é a carteira digital da Apple que permite ao comprador finalizar uma compra com Face ID ou Touch ID por meio de dispositivos da marca, como MacBooks com navegador Safari, Apple Watches e iPhones, sem precisar digitar os dados do cartão. Na Vindi, a solução processa pagamentos no cartão crédito (Visa e Mastercard) com a subadquirência exclusiva de Vindi Pagamentos. Trata-se de uma carteira de alta taxa de conversão e muito segura, onde o número real do cartão (PAN) nunca trafega pela sua loja virtual e nem pela Vindi — cada transação usa um token criptografado, de uso único, garantindo um total escopo seguro e de acordo com as normas PCI Compliance - estado de conformidade de maior nível de segurança em meios de pagamento.
Certificação
Quais são os pré-requisitos para habilitar o Apple Pay?
Antes de iniciar a ativação, o lojista precisa realizar alguns pré-requisitos cadastrais com Apple e necessita ter:
Conta Apple Developer ativa — assinatura anual de US$ 99, cobrada pela própria Apple (valor sujeito a reajuste da Apple).
Extensão Apple Pay habilitada — na plataforma Vindi
URL da loja — disponível para cadastro e verificação de domínio.
Credenciamento em Vindi Pagamentos — adquirência exclusiva da solução.
MÓDULO 1 - Criação do Merchant ID
Siga os três módulos abaixo, em ordem, para habilitar o Apple Pay na sua loja integrada à Vindi (via parceiro de checkout ou checkout próprio). O processo é dividido em criação do Merchant ID, configuração dos certificados e verificação de domínio.
O Merchant ID identifica sua loja de forma exclusiva perante o Apple Pay. Ele nunca expira e pode ser usado em múltiplas plataformas.
Passo 1 — Acesse o Apple Developer
Faça login em developer.apple.com e navegue até Certificates, Identifiers & Profiles no menu principal.
Passo 2 — Crie o Merchant ID
Na barra lateral, clique em Identifiers e no botão "+" no canto superior esquerdo.
Selecione Merchant IDs e clique em Continue.
Insira a descrição do comerciante e o nome do identificador.
Clique em Continue, revise as configurações e confirme em Register.
IMPORTANTE: O identificador criado será usado em todas as etapas seguintes e não pode ser alterado após o registro.
Fluxo completo de criação do Merchant ID no Apple Developer.
Passo 3 — Instale a extensão Apple Pay na Vindi
Com o Merchant ID criado, acesse app.vindi.com.br e instale a extensão.
Caminho: Configurações > Extensões e Integrações > Apple Pay > + Instalar.
Na tela de instalação, preencha os campos criados na etapa de geração do identifier (Merchant ID) na Apple:
Merchant ID: o identificador criado no Apple Developer. Exemplo: merchant.com.lojaexemplo ( A Apple recomenda o uso de reverse-domain/domínio inverso para o Merchant ID);
Nome da loja: ex.: Loja Exemplo - Este nome irá ser apresentado ao pagador na transação;
URL da loja: endereço onde o Apple Pay estará disponível - Exemplo lojaexemplo.com ou www.lojaexemplo.com.br.
ATENÇÃO: Insira a URL sem https://
Clique em Instalar. Você será redirecionado para a tela de configuração de certificados:
Extensão Apple Pay na Vindi — instalação e tela de configuração.
MÓDULO 2 - Configuração de Certificados
São necessários dois certificados: o Merchant Identity Certificate e o Payment Processing Certificate. Ambos seguem o mesmo fluxo entre Vindi e Apple Developer.
Passo 1 — Gere um CSR (Certificate Signing Request) na Vindi
Na tela de configuração da extensão, localize o bloco Merchant Identity Certificate e Payment Processing e clique em ambos os botões verdes de Criar CSR. Os arquivos serão baixados automaticamente.
ATENÇÃO: O CSR deve ser criado apenas uma vez. Não gere um novo CSR para o mesmo certificado — isso invalida o anterior.
Passo 2 — Gere o certificado de Merchant Identity na Apple
Volte ao Apple Developer, acesse a lista de Merchant IDs e edite o criado anteriormente.
Localize o Apple Pay Merchant Identity Certificate e clique em Editar.
Clique em Create Certificate na seção Apple Pay Merchant Identity Certificate.
Em Upload a Certificate Request, selecione o CSR baixado da Vindi.
Faça o download do certificado gerado pela Apple (.cer).
Passo 3 — Faça o upload do certificado na Vindi
Volte à extensão Apple Pay na Vindi e envie o arquivo .cer gerado pela Apple no campo correspondente ao Merchant Identity Certificate.
Fluxo do Merchant Identity Certificate: CSR na Vindi → Apple Developer → upload do .cer na Vindi.
Passo 4 — Repita o processo para o Payment Processing Certificate
O fluxo é idêntico ao anterior, agora para o Payment Processing Certificate:
Na Vindi, gere um novo CSR no bloco de Payment Processing.
No Apple Developer, acesse Create Certificate na seção Payment Processing.
Faça upload do CSR, baixe o certificado e envie-o de volta à Vindi.
ATENÇÃO: Ambos os certificados são obrigatórios. Nenhuma transação Apple Pay será processada sem os dois ativos.
Fluxo do Payment Processing Certificate: upload do CSR e retorno do .cer à Vindi.
IMPORTANTE: Validade dos certificados Apple Pay - O certificado de Payment Processing tem a validade de 25 meses. Após esse período, é necessário renová-lo seguindo o mesmo processo. A Vindi envia automaticamente avisos de expiração por e-mail ao endereço cadastrado na plataforma antes do seu vencimento.
Passo 5 — Criação de método de pagamento automático
Após a instalação, será criado automaticamente em sua conta o método de pagamento “Credit Card Apple Pay”
Verifique em Configurações > Métodos de Pagamentos > Visualize o método criado;
Para referência via API o código será “credit_card_apple_pay”.
MÓDULO 3 - Verificação de Domínio
A Apple exige que cada URL da sua loja seja verificada e vinculada ao Merchant ID. Repita estes passos para cada domínio que utilizará o Apple Pay.
Passo 1 — Adicione o domínio ao Merchant ID no Apple Developer
Pesquise pelo seu Merchant ID, abra-o e localize o módulo Merchant Domains.
Clique em Add Domain.
Insira a URL no campo “Enter the domain you wish to register”.
Clique em Save.
Passo 2 — Baixe o arquivo de verificação .txt
Após salvar, a Apple gera automaticamente um arquivo .txt de verificação vinculado ao domínio. Clique em Download.
ATENÇÃO: Não faça nenhuma alteração no arquivo .txt. Qualquer edição invalida a verificação.
Passo 3 — Publique o arquivo .txt (parceiro ou checkout próprio)
Forneça o arquivo gerado pela Apple ao time do parceiro (ex.: Wake ) ou publique-o no servidor de seu domínio de checkout próprio. Esta etapa é necessária para que a Apple confirme a propriedade do domínio.
Passo 4 — Validação de domínio
Após a confirmação da publicação do arquivo no servidor, a verificação deve ser realizada em até 60 minutos. Acesse sua conta Apple, na tela onde baixou o arquivo de domínio, e clique em Verify.
Concluída a sequência, o domínio ficará com status Verified — apto a transacionar crédito Visa e Mastercard via Vindi Pagamentos.
Fluxo de verificação de domínio: adição no Apple Developer e publicação do .txt (parceiro ou checkout próprio).
IMPORTANTE: Configuração concluída!
Com o Merchant ID criado, os dois certificados enviados e o domínio verificado, sua loja está pronta para aceitar pagamentos via Apple Pay pela Vindi. Lembre-se de renovar os certificados ao receber o aviso de expiração por e-mail (validade de 25 meses).
NOTA: Para os canais oficiais Vindi como Wake e Shopify: a publicação do arquivo de domínio é conduzida pelas Vindi ou Wake — procure seu gerente de contas. A verificação de domínio expira junto ao certificado SSL ou em 25 meses; manter a validação atualizada é responsabilidade do time da loja configurada em seu domínio próprio.
Integração e canais
Quais canais e dispositivos estão disponíveis?
O Apple Pay Vindi está disponível em iPhone e Mac (via navegador Safari) — onde está a maioria dos compradores da carteira. Os canais aplicáveis a ativação disponíveis são via SDK (Kit de desenvolvimento)/API Vindi e via Plataforma Wake e Shopify.
SDK Vindi
Como a loja desenvolve Apple Pay no seu checkout?
A Vindi oferece um kit completo que facilita o desenvolvimento da sua integração e atende a três perfis de lojistas:
Integração Front-end (@vindibr/wallets-sdk): A biblioteca oficial da Vindi para carteiras digitais simplifica toda a complexidade de integração com o Apple Pay. O SDK carrega a opção de pagamento, renderiza o botão oficial Apple Pay, gerencia a sessão do pagador e orquestra a validação de certificados (merchant validation) diretamente na Vindi. A tokenização do cartão ocorre do próprio navegador do pagador à Apple/Vindi, garantindo segurança por não trafegar dados sensíveis no ambiente do lojista, e retorna um token criptografado para o backend (Node.js 20+) criar a cobrança via API de faturas, com códigos externos customizados.
Otimização Completa (Server-side): Para lojistas que buscam uma solução mais robusta, o SDK oferece uma opção de servidor que pode ser instalada no backend do lojista, gerenciando também o processo de finalização da compra de ponta a ponta.
Bibliotecas Multi-Linguagem: O terceiro perfil é focado em flexibilidade, contando com pacotes do SDK para a carteira Apple Pay disponíveis em diversas linguagens de programação.
Onde encontrar a documentação e o pacote?
Disponível na organização Vindi em NPMjs — @vindibr/wallets-sdk (versão 1.0.1).
Documentação oficial: npmjs.com/package/@vindibr/wallets-sdk
ATENÇÃO: A chave privada é de uso exclusivo no backend (ex.: VindiBillingServer, via subpath @vindibr/wallets-sdk/server). Nunca a exponha no browser nem chame o endpoint de cobrança diretamente de uma página pública sem autenticação e validação dos dados.
Relatórios
Onde acompanhar as transações Apple Pay?
No painel da Vindi, acesse Relatórios › Carteiras digitais.
Relatórios › Carteiras digitais — filtro Carteira digital = Apple Pay.
Como filtrar as transações?
Use o filtro Carteira digital e escolha Apple Pay. Insira um período obrigatório (janela de até 3 meses). Clique em Exportar e aguarde para fazer o download na área de Relatórios > Exportados.
Quais dados aparecem no relatório?
Status da transação (Aprovada, Rejeitada, Aguardando Pagamento), a bandeira Visa/Mastercard, marca Apple Pay, e o cartão de forma tokenizada. O PAN (número real do cartão) nunca trafega pela Vindi nem pela loja, ou seja, o número do cartão exposto é um dado representativo do token, não o número real do cartão do pagador.
Detalhe da transação Apple Pay — método "Credit Card Apple Pay", bandeira Visa e cartão tokenizado.
Dúvidas mais frequentes:
Quais adquirentes e métodos são aceitos?
A solução é exclusiva para lojas que usam a Vindi Pagamentos como subaquirente, na modalidade Cartão de Crédito, para as bandeiras Visa e Mastercard.
Existe alguma restrição de uso?
Sim, a solução de Apple Pay Vindi não atende Recorrências nesta versão, portanto são destinadas a compras avulsas (Faturas Avulsas - Vendas de tipo E-commerce). Neste momento não está disponível para ativação via Link de Pagamentos ou Página de pagamentos Vindi.
As transações de Apple Pay atendem todas as funções de uma transação, como cancelamento?
Sim. Transações Apple Pay suportam estornos, cancelamentos, split de pagamentos Vindi e antifraudes internos (via plugins parceiros Vindi) e externos - integrados diretamente no ecossistema do lojista.
Esse tipo de transação é segura?
Sim, é 100% segura. O pagamento é autenticado por Face ID ou Touch ID, o que garante alta confiabilidade e a Apple gera um token criptografado único e descartável por transação. O número real do cartão não é exposto à loja nem à Vindi.
Existe custo adicional para Apple Pay?
Não há taxa extra por transação cobrada pela Vindi. O lojista mantém o mesmo MDR e as mesmas taxas contratadas em nossa subadquirente. O único custo adicional é a conta Apple Developer (US$99/ano), paga diretamente à Apple.
Quais são os benefícios?
Elimina o preenchimento de formulários longos no checkout, reduzindo o atrito e o abandono de carrinho — sobretudo em dispositivos mobile. A autenticação biométrica (Face ID e Touch ID) e o token também favorecem a aprovação no emissor do cartão em transações on-line e sua média histórica de conversão é de 85 à 92%.
Como posso contratar essa funcionalidade?
A funcionalidade é aberta para sua instalação. Para contratação de Vindi Pagamentos e apoio de integração, entre em contato com seu Gerente de Contas e nossa área de Implantação.