--- title: "Apple Pay (legado)" url: "https://devcenter.stone.com.br/legacy-apple-pay" image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_Apple+Pay+(legado),props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9sZWdhY3ktYXBwbGUtcGF5Ig,s_gHJydX-3zDWdMD4Q.png" --- # Apple Pay 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… Documentação legada do Pagar.me v5 Esta página descreve um conceito da **Pagar.me v5** (versão clássica). Para projetos novos, explore o **[API Catalog](https://devcenter.stone.com.br/catalog)**. 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](#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. ![](https://files.readme.io/d2f333c9427bbc072e8f3eda6c7ecf8637899622e1d7e3ddf511e1c3633cd09e-image.png) ## [Como funciona](#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](#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. ![](https://files.readme.io/750fb6ce360cc101461d813fdf21e19da275d2f2d74108efddb0e50396287752-image.png) ## [Primeiros Passos](#primeiros-passos) ## [Etapas da integração](#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](#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](#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](https://developer.apple.com/) 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: ![](https://files.readme.io/0e54f4d504047917d3c1dbd355b2e07ea22e819b6ab8ddca62663c5a3e757e91-image.png) 2. Selecione a opção `Merchant IDs` e então clique em `Continue`: ![](https://files.readme.io/8e05925bd69d97c6e2e8c0d358780dc688b625217ecd3e19e148c60711c6c7d0-image.png) 3. Coloque um valor nos campos **Description** e **Identifier**, seguindo suas especificações, e clique em `Continue`: ![](https://files.readme.io/24f2a7d4e3864fe4f0d5ee6ac78c34b12c79d2e62aaf296391b42163f22d97fa-image.png) 4. Para finalizar, clique em `Register`: ![](https://files.readme.io/72484567ab8955da88080244cf1677faf169b757c777454c6ce6bbd039739e3b-image.png) ### [Passo 2: Crie um certificado de processamento de Pagamento](#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” seguindo os passos indicados na sessão [Apple Pay: Gestão de Certificados](https://devcenter.stone.com.br/legacy-apple-pay-certificados). 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**: ![](https://files.readme.io/42ddb4d06665f2bbe0f0b441755c631853165d03f12f900f6ea7f130d19edd90-image.png) 3. Selecione o **identifier** criado anteriormente: ![](https://files.readme.io/a58e06cda909060764fe39b2fdf1dd7ccf60c9d9a24fca90805888e574bb5efd-image.png) 4. No bloco **Apple Pay Payment Processing Certificate**, clique no botão `Create Certificate` ao final do texto explicativo: ![](https://files.readme.io/69a5904de8df7fabdc7322e55f93a6a53d0c61b0c28b27f0f3ad1f2cde1c469e-image.png) 5. Escolha a opção `No` em **Edit or Configure Merchant ID**: 6. ![](https://files.readme.io/9f6256245dfbf7f4b88f7c67851965f7f91afac7b329d47fe5f8e0ca8a21759c-image.png) Na caixa de diálogo, clique em `Choose File` e escolha o certificado “.CSR” enviado pela Pagar.me: ![](https://files.readme.io/77dbb6a6ed4dc69ea966c9312ea28fb4b586682113992580360869f19a74b959-image.png) 7. Clique em `Continue`: ![](https://files.readme.io/1b006e49578a18a12fe54d56413b81ee6e7690e7742350355fababff034d04cd-image.png) 8. Clique em `Download` para baixar o arquivo “.CER”: ![](https://files.readme.io/e9b1f93252e3e4bed80e80695e91e1b52aedd30439092fcce60bee87f3b2c785-image.png) ### [Passo 3: Registre os domínios do comerciante e crie um certificado de identidade](#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](#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; ![](https://files.readme.io/9c924d78136b276e5260d8a2bb757313df350bed65cc11f54b232ae86120fc2b-image.png) 2. À direita, selecione seu **merchant identifier**; ![](https://files.readme.io/c619084f503815a69f3a8202ba89f628dee9799acd5896fa25802be8dff0013b-image.png) 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](#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; ![](https://files.readme.io/baef8c2aafa557e00192025b01fe289883c3564177abe6d4ab38317048067704-image.png) 2. À direita, selecione seu **merchant identifier**; ![](https://files.readme.io/a905144b9fbb45ebaecb78697f5ee8bf10d579d01c679726fc9f785c6cfa81d4-image.png) 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](https://developer.apple.com/documentation/applepayjs) do Apple Pay JS. ## [ETAPA 2: Integração checkout x Apple Pay](#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](https://developer.apple.com/documentation) 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 campos**paymentData.data** e **ephemeralPublicKey.header.EphemeralPublicKey**. ### [Json](#json) ```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 decriptografia dos dados retornados pela Apple, pois esse trabalho é feito pela API do Pagar.me. ## [ETAPA 3: Habilitação na Stone](#etapa-3-habilitação-na-stone) Para realizar a habilitação na Stone, é necessário seguir as etapas na página de [Gestão de Certificados](https://devcenter.stone.com.br/legacy-apple-pay-certificados#etapa-2-cadastro-do-csr-e-gera%C3%A7%C3%A3o-do-cer-no-portal-da-apple-developer) ## [ETAPA 4: Integração Cliente V5 x Apple Pay](#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](https://devcenter.stone.com.br/apis/v5-docs-legacy/docs). --- **Jornada: [Cobrar um cliente](https://devcenter.stone.com.br/legacy-overview-transacao)** Etapa 19 de 22 [**Etapa anterior**Google Pay](https://devcenter.stone.com.br/legacy-google-pay)[**Próxima etapa**Apple Pay: Certificados](https://devcenter.stone.com.br/legacy-apple-pay-certificados) Siga a Stone nas redes sociais [](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ) © Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57 Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.