Para usar nossa solução de Tokenização, é necessário que você tenha contratado serviços de emissão de cartões e processamento de transações.

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:

Fluxo de Apple

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

Se você é um membro afiliado, precisará fazer sua própria configuração do BIN no Mastercard Connect ou no Visa Online.

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 solicita que você anexe pelo menos um anúncio de marketing anunciando que você oferece serviços de Tokenização com o Apple Pay. Além disso, eles validarão se você está em conformidade com Guia de Marketing e ativos deles.

Abaixo estão os ativos correspondentes a cada país para você criar suas peças de marketing:

Também fornecemos alguns exemplos para referência:

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.

Após a conclusão da sua integração, você precisará nos fornecer 3 elementos que exigem a aprovação final da Apple.

  • O contrato assinado.
  • Uma gravação ou vídeo que mostre detalhadamente o fluxo de Provisionamento por Push, desde o momento em que o aplicativo é iniciado até que um cartão seja cadastrado com sucesso.
  • Pelo menos uma peça de marketing seguindo as diretrizes fornecidas pelo Apple Pay.

O conteúdo desta documentação foi útil?