Guides
GuidesSuporteAPI Reference

Apple Pay

Suggest Edits

🚧

Importante!

As funcionalidades apresentadas abaixo estão disponíveis tanto para cliente PSP quanto para clientes Gateway integrados via V5.

Os clientes Gateway devem estar integrados em uma das adquirentes compatíveis. São elas: Stone, Rede, Getnet e Cielo 3.0.

Entendendo os conceitos

O Apple Pay é um sistema de pagamento e carteira digital que permite aos usuários realizarem pagamentos de forma rápida e segura em lojas físicas, aplicativos e na web, usando dispositivos Apple. Ele suporta cartões de crédito, dados de entrega, cobrança e contatos, possibilitando pagamentos por aproximação ou online, com autenticação biométrica e tokenização para maior segurança dos usuários e dos lojistas.

Como funciona

Ao utilizar o Apple Pay, é apresentado uma interface intuitiva que exibe todas as formas de pagamento previamente salvas em seu dispositivo Apple, incluindo cartões de crédito e débito. Com alguns toques, ele pode selecionar rapidamente a forma de pagamento desejada.

📘

Dados de Pagamento

O lojista pode definir quais campos devem ser preenchidos no momento do pagamento, como por exemplo: endereço de cobrança, endereço de entrega, telefone de contato, e-mail de contato, etc.

Fluxo de Pagamento

O fluxo de pagamento ocorre da seguinte maneira:

  1. O usuário clica no botão de finalização da compra via Apple Pay, e uma interface com as formas de pagamento compatíveis é exibida no dispositivo Apple.
  2. O usuário seleciona uma opção e autentica o pagamento por meio de Face ID, Touch ID ou senha.
  3. O Apple Pay gera um token seguro referente à forma de pagamento escolhida.
  4. Seu site recebe esse token e o envia ao back-end junto com os detalhes da compra.
  5. O back-end processa a compra e envia o token ao provedor de pagamento para concluir a transação.

Primeiros Passos

Etapas da integração:

  1. Credenciamento na Apple Pay ;
  2. Integração Checkout x Apple Pay;
  3. Habilitação na Stone;
  4. Integração Cliente V5 x Apple Pay;
  5. Testes e homologação.

ETAPA 1: Credenciamento na Apple Pay

Para implementar o Apple Pay em seu aplicativo ou site, é necessário seguir algumas etapas de configuração na sua conta de desenvolvedor. Essas etapas incluem registrar um ID de comerciante, criar o certificado de processamento de pagamento e, para o uso do Apple Pay no site (web), registrar os domínios do comerciante, criar um certificado de identidade para autenticar a comunicação com os servidores do Apple Pay e verificar o domínio.

Passo 1: Configuração do Merchant Identifier

Um identificador de comerciante identifica você exclusivamente para o Apple Pay como um comerciante que pode aceitar pagamentos. Esse identificador nunca expira, e você pode usar o mesmo para vários app's. Para criar um Merchant Identifier você precisa acessar o Portal de Desenvolvedores da Apple e executar os seguintes passos:

  1. Na seção Certificates, Identifiers & Profiles, selecione Identifiers no menu lateral, e então clique no botão (+) ao lado do título:

  2. Selecione a opção Merchant IDs e então clique em Continue:

  3. Coloque um valor nos campos Description e Identifier, seguindo suas especificações, e clique em Continue:

  4. Para finalizar, clique em Register:


Passo 2: Crie um certificado de processamento de Pagamento

Um certificado de processamento de pagamento é associado ao seu identificador de comerciante e usado para criptografar informações de pagamento. O certificado de processamento de pagamento expira a cada 25 meses. Caso o certificado seja revogado, você pode recriá-lo.

Antes de iniciar a criação do certificado através da sua conta de desenvolvedor na Apple, você deve obter o certificado no formato “.CSR” junto ao time de atendimento do Pagar.me. Para isso, você entre em contato com nosso time de atendimento ao cliente pelo e-mail [email protected], pelo chat na sua dashboard ou pelo telefone 4004-1330.

Com o certificado “.CSR” em mãos:

  1. Na seção Certificates, Identifiers & Profiles, selecione Identifiers, no menu lateral.

  2. Utilizando o filtro localizado à direita superior (App IDs), encontre o item Merchant IDs:

  3. Selecione o identifier criado anteriormente:

  4. No bloco Apple Pay Payment Processing Certificate, clique no botão Create Certificate ao final do texto explicativo:

  5. Escolha a opção No em Edit or Configure Merchant ID:

  6. Na caixa de diálogo, clique em Choose File e escolha o certificado “.CSR” enviado pela Pagar.me:

  7. Clique em Continue:

  8. Clique em Download para baixar o arquivo “.CER”:


Passo 3: Registre os domínios do comerciante e crie um certificado de identidade

🚧

Importante

Este passo só precisa ser executado se você deseja oferecer o Apple Pay no seu site (Web).

Registro de domínio:

  1. Em Certificates, Identifiers & Profiles”, clique em Identifiers na barra lateral e selecione Merchant IDs no menu pop-up no canto superior direito;

  2. À direita, selecione seu merchant identifier;

  3. Em Merchant Domains, clique em Add Domain;

  4. Insira o nome de domínio totalmente qualificado e clique em Save;

  5. Clique em Download, coloque o arquivo baixado no local especificado e clique em Verify;

  6. Clique em Done.

Crie um certificado de identidade de comerciante:

  1. Em Certificates, Identifiers & Profiles, clique em Identifiers na barra lateral e selecione Merchant IDs no menu pop-up no canto superior direito;

  2. À direita, selecione seu merchant identifier;

  3. Em Apple Pay Merchant Identity Certificate, clique em Create Certificate;

  4. Crie uma solicitação de assinatura de certificado no seu Mac e clique em Continue;

  5. Clique em Choose File;

  6. Na caixa de diálogo exibida, selecione o arquivo de solicitação de certificado (um arquivo com uma extensão de arquivo ".certSigningRequest") e clique em Choose;

  7. Clique em Continue;

  8. Clique em Download.

O arquivo do certificado (um arquivo com uma extensão de arquivo ".cer") aparece na sua pasta Downloads.

Para saber mais sobre o Apple Pay na web, visite a documentação do Apple Pay JS.


ETAPA 2: Integração checkout x Apple Pay

Boa parte do processo para disponibilização do botão “Pagar com Apple Pay” no seu app ou site será realizado na sua integração junto à wallet. Por isso, recomendamos que siga as orientações disponíveis na Documentação da Apple para a implementação, que é totalmente self-service.

🚧

Bandeiras compatíveis

Ao iniciar uma sessão de pagamentos junto à Apple, você deve indicar apenas as bandeiras de cartão compatíveis com o seu credenciador. Se seu credenciador for a Stone, as bandeiras compatíveis são Visa e Mastercard.

Ao final do processo realizado na API da Apple, você receberá um JSON contendo dois campos importantes que deverão ser utilizados na “ETAPA 4”. São os campospaymentData.data e ephemeralPublicKey.header.EphemeralPublicKey.

Json

{
  "applePayData": {
    "paymentData": {
      "version": "EC_v1",
      "data": "as01vRj+n9crY2vome7zc+u7Tz0+qg2La/KJdasdaf87das6D+ddo9sZu70uJQJH1I+44N6PrVhilNDem97vOXq2VYDXiVJ27F/Q9wGQDgZBeGcZ6Pml9SIelHqUauBcQoOatrlnWPUL8kbdpT8WqgzXyaCh7oeTz=z6++rp/ofjvSjnGtOqAUsnrzvw4uzkcyKUSsfROdJ6B/Xzgu/T9fMIr5UxXD2DPF1SNh3ydEJABKz4HFjDW7ObvbQeua4GYxJdpQLpI3NgUbJy91E/LOyb/+PcCtO+0=a41tBrfnTTF9qsPuCIw8HWIEEKSRofn27NTofxev/i+nHEfqEtqNrN/epIvhzceD/gDiGetfiLKMzf94ARmpWUAMC==",
      "signature": "(…)",
      "header": {
        "ephemeralPublicKey": "MFkwEwZJKoZIzj0dasGASDafeAQcDQgAEo+ReGClSmQ4hDJD1yh9nci3V4l7kPm2AQtKZMMvuNS0iK5sn/1A9l3kw1B1xCqOycZmnPSng7p5hpTvrei1BCA==",
        "publicKeyHash": "KXN06+BtJu6yEfF9zDhr7f4M/2HwVybnx0FGfC520gB=",
        "transactionId": "71c5b61c3791546e94d2b4893a6c69aaac2ab86b5c113c83a7d89057906a9b5f"
      }
    },
    "paymentMethod": {
      "displayName": "MasterCard 1212",
      "network": "MasterCard",
      "type": "credit"
    },
    "transactionIdentifier": "81C5B61C379164A8NSF74JDSB86B5C363C83A7D89057906A9BAC"
  },
  "x_document": "24562608994",
  "x_name": "João da Silva"
}

📘

Importante

Durante a implementação da Apple, haverá uma referência ao certificado ".CER", gerado durante a ETAPA 1, para criptografar os dados durante a comunicação com a Apple. No fluxo de integração, NÃO implemente o processo de descriptografia dos dados retornados pela Apple, pois esse trabalho é feito pela API do Pagar.me.


ETAPA 3: Habilitação na Stone

Para realizar a habilitação na Stone, é necessário entrar em contato com o nosso Time de Atendimento, solicitar a habilitação do Apple Pay e fornecer o certificado ".CER" gerado na etapa 1, passo 2. Você pode entrar em contato com nosso time de atendimento pelo e-mail [email protected], pelo chat na sua dashboard ou pelo telefone 4004-1330.


ETAPA 4: Integração Cliente V5 x Apple Pay

Esta integração é realizada através da nossa API V5 e envolve a operação de criação de pedidos no meio de pagamento Cartão, com certas especificidades da Apple. Para obter acesso à documentação de integração da nossa API V5, clique aqui.

Updated about 1 month ago