Integrar Apple Pay

Descobra como integrar o Apple Pay à sua solução de Cards.

Introdução

Para adicionar o Apple Pay à sua solução de Cards, você precisará completar estas 3 etapas:

1. Assinatura do contrato comercial

O primeiro passo para oferecer o Apple Pay é concordar e assinar as condições comerciais conosco. Se você ainda não fez isso, entre em contato com nossa equipe de vendas.

2. Configuração do BIN

Aqui estão algumas informações necessárias para preencher o formulário e configurar seu BIN para o Apple Pay.

👉🏼 ID da Equipe

1. Acesse o site Apple Developers e faça login com suas credenciais.
2. Role para baixo até "Membership Details".
3. Lá você encontrará seu ID da Equipe.

👉🏼 ADAM, Apple ID e Bundle ID

1. Faça login no App Store Connect com suas credenciais.
2. Selecione "My Apps" e escolha o aplicativo correto.
3. Vá para a opção "App Information" no menu de navegação à esquerda e depois para "General Information".
4. Lá você encontrará o Apple ID e o Bundle ID.

👉🏼 Contrato assinado

Você precisará assinar um contrato para indicar à Apple que você oferecerá serviços de Tokenização conosco. Para fazer isso, entre em contato com nossa equipe de Integrações.

Importante: Você pode assinar manualmente e digitalizar ou fazer uma assinatura digital.

👉🏼 Ativo de marketing

A Apple exige que você anexe pelo menos uma peça de marketing comunicando que seu cartão é compatível com o serviço de Tokenização do Apple Pay. Além disso, verificará se você cumpre o seu Guia de Marketing e Assets.

Desde a Pomelo, recomendamos um caminho simples para atender a este requisito:

1. Utilize a arte do seu cartão.
2. Acompanhe com o seu logo e o logo oficial do Apple Pay.
3. Você pode usá-lo em uma postagem nas redes sociais, no seu site ou em uma campanha de e-mail.

Com isso, você já terá o mínimo necessário para enviar para validação da Apple.

A seguir, disponibilizamos exemplos já construídos e validados pela Apple, onde seguindo os passos acima você poderá avançar nesta etapa. Escolha de acordo com o idioma e a marca:

• Exemplo peça de marketing Visa - ES
• Exemplo peça de marketing Mastercard - ES
• Exemplo peça de marketingVisa - PT
• Exemplo peça de marketing Mastercard - PT

Também compartilhamos o Guía de Marketing e os assets oficiais da Apple correspondentes a cada país, caso precise complementar:

• Guia de Assets México
• Guia de Assets Colômbia
• Guia de Assets Brasil
• Guia de Assets Argentina
• Guia de Assets Peru

3. Ajustes técnicos

Compartilharemos um passo a passo dos ajustes técnicos que você precisará fazer para oferecer suporte ao Apple Pay em seu aplicativo. Como é uma funcionalidade própria da Apple, você precisará fazer as alterações na linguagem de programação nativa deles, o Swift.

👉🏼 Adicionar o botão para iniciar o fluxo

Você precisará adicionar um botão à sua tela de cartão que permita iniciar o fluxo, como no exemplo a seguir:

👉🏼 Gerar informações para provisionar um cartão usando nosso endpoint

Para provisionar um cartão no Apple Pay, você primeiro precisará gerar as informações que posteriormente enviará à Apple para que seus clientes possam cadastrar seus cartões na carteira. Você fará isso usando este endpoint.

👉🏼 Provisionar o token

Aqui está um passo a passo de como provisionar um token para o cartão do seu cliente.

Passo 1 - Verificar se o dispositivo e seu aplicativo são compatíveis com o Apple Pay

Passo 2 - Iniciar o fluxo

Passo 3 - Construir o objeto

Passo 4 - Notificar o cliente sobre o erro

Passo 5 - Obter informações do cartão

Nesta etapa, fornecemos um exemplo codificado, mas em seu aplicativo, você precisará construir um mecanismo para buscar as informações do cartão do seu usuário.

Lembre-se de que no "passo 3" criamos uma variável, let card = cardInformation(), e é essa que estamos usando neste passo.

Para obter os dados do cartão, você precisará seguir os passos desta documentação.

Passo 6 - Entrar em contato com a Apple e a Pomelo

Primeiro, você precisará chamar a função PKAddPaymentPassViewControllerDelegate para obter as informações que, em seguida, usará para entrar em contato conosco.

Em seguida, você precisará construir o objeto IssuerRequest com a resposta que obteve no passo anterior e entrar em contato conosco usando este endpoint.

Finalmente, com a resposta que obteve de nosso endpoint, você precisará fazer a chamada à Apple para continuar o fluxo de provisionamento usando a função PKAddPaymentPassRequest().

Certifique-se de que as informações que você recebeu estejam codificadas em base64.

Passo 7 - Ouvir o resultado do provisionamento

Documentação adicional

Caso você precise, aqui está um guia de solução de problemas.

Importante:

• Por enquanto, você pode usar apenas uma arte de cartão por BIN.
• Para o fluxo de Provisionamento Manual, não é necessário fazer ajustes na sua integração técnica.
• Desde que recebemos o formulário completo e carregamos a configuração no sistema, você precisará esperar pelo menos 10 dias úteis para que as alterações sejam implementadas.
• Você precisará nos fornecer de 5 a 20 card-id para habilitarmos esses cartões para testar os fluxos.
  • Esses card-id devem corresponder a cartões de produção.
  • Quando você tiver validado corretamente que tudo está funcionando conforme o esperado, entre em contato conosco para que possamos habilitar todo o seu BIN no Apple Pay. Esse é um processo que precisa ser coordenado com a bandeira.
• Você precisará ter o endereço de e-mail e o número de celular dos seus clientes registrados com o código de área sem símbolo para poder enviar o código de verificação de validação de identidade. Exemplo: 541123456777
  • Caso seus clientes não tenham informações atualizadas, você poderá atualizá-las usando este endpoint.