Obter os certificados do Apple Developer
Para começar a oferecer pagamentos rápidos e seguros com Apple Pay, é necessário realizar algumas configurações para que seja possível validar a identidade do site e do vendedor, e assim permitir as transações garantindo a segurança dos dados de pagamento.
Selecione o tipo de plataforma abaixo e siga as instruções de acordo com seu tipo de integração.
Para estar apto para utilizar Apple Pay como um meio de pagamento é necessário registrar e verificar seu domínio no Portal Apple Developer. Para isso, siga os passos abaixo.
- No Portal Apple Developer, navegue até "Certificates > Identifiers & Profiles", adicione seu domínio e salve.
- Faça o download do arquivo
.txtgerado. Importante salientar que a cada clique no botão de download no painel, um novo arquivo é baixado e invalida o anterior. - Faça o upload desse arquivo no seu servidor em uma pasta oculta chamada
.well-known. - No Portal, clique no botão Verify para realizar a verificação do arquivo.
- Confira se, ao acessar
https://seu-dominio/.well-known/apple-developer-merchantid-domain-association.txt, o conteúdo do arquivo de verificação será exibido.
Para estar apto para utilizar Apple Pay como um meio de pagamento é necessário incluir o certificado que será usado para comprovar que você é um vendedor autorizado, garantindo que sua aplicação é de um merchant com habilitação para solicitar pagamentos via Apple Pay. Para isso, siga os passos abaixo.
- Envie uma solicitação com seu Access Token de testeChave privada da aplicação criada no Mercado Pago e que é utilizada no backend. Você pode acessá-la através de Suas integrações > Dados da integração > Testes > Credenciais de teste. ao endpoint certificates/csr/generatePOST do Mercado Pago para gerar o certificado.
curlcurl --location 'https://api.mercadopago.com/certificates/csr/generate' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \ --data '{ "type": "merchant", "flow": "apple_pay", "merchantIdentifier": "merchant.your-identifier", "organization": "MyOrg", "country": "BR" }'
| Parâmetro | Tipo | Descrição | Obrigatoriedade |
type | String | Tipo de certificado. Para esta etapa, deve ser "merchant". Guarde o certificate_id para os passos seguintes. | Obrigatório |
flow | String | Fluxo de pagamento. Para Apple Pay, o valor fixo deve ser apple_pay. | Obrigatório |
merchantIdentifier | String | Identificador único do seu negócio no Apple Pay. Deve coincidir com o Merchant ID configurado na Apple. | Obrigatório |
organization | String | Nome da sua organização. | Obrigatório |
country | String | Código do país como, por exemplo, BR. | Obrigatório |
- A API devolverá uma resposta com os valores
certificate_idecertificate. Decodifique o campocertificate(em formato Base64) e salve-o em um arquivo.pem. - No Portal Apple Developer, vá até Certificates, Identifiers & Profiles > Identifiers, selecione seu Merchant ID e, na seção Apple Pay Merchant Identity Certificate, clique em Create Certificate e faça o upload do arquivo
.pemgerado. - Em seguida, faça o download do certificado assinado.
- Por fim, envie uma solicitação com seu Access Token de testeChave privada da aplicação criada no Mercado Pago e que é utilizada no backend. Você pode acessá-la através de Suas integrações > Dados da integração > Testes > Credenciais de teste. ao endpoint certificates/certificate/uploadPOST do Mercado Pago para adicionar o certificado assinado.
curlcurl --location 'https://api.mercadopago.com/certificates/certificate/upload' \ --header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \ --form 'certificate=@"/User/Downloads/apple_pay.cer"'
| Elemento | Tipo | Descrição | Obrigatoriedade |
Authorization | Header | Header com seu Access Token de testeChave privada da aplicação criada no Mercado Pago e que é utilizada no backend. Você pode acessá-la através de Suas integrações > Dados da integração > Testes > Credenciais de teste.. | Obrigatório |
certificate | File | Arquivo do certificado gerado e assinado na Apple. | Obrigatório |
- Finalizado o processo, você precisará realizar novamente a verificação de domínio na Apple.
Para estar apto para utilizar Apple Pay como um meio de pagamento é necessário incluir o certificado que será usado para a descriptografar os dados de pagamento, interpretando com segurança o payload utilizado no pagamento. Para isso, siga os passos abaixo.
- Faça uma requisição ao endpoint certificates/csr/generatePOST do Mercado Pago para gerar o certificado.
curlcurl --location 'https://api.mercadopago.com/certificates/csr/generate' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \ --data '{ "type": "payment", "flow": "apple_pay", "merchantIdentifier": "merchant.your-identifier", "organization": "MyOrg", "country": "BR" }'
| Parâmetro | Tipo | Descrição | Obrigatoriedade |
type | String | Tipo de certificado. Para esta etapa, deve ser "payment". Guarde o certificate_id para os passos seguintes. | Obrigatório |
flow | String | Fluxo de pagamento. Para Apple Pay, o valor fixo deve ser apple_pay. | Obrigatório |
merchantIdentifier | String | Identificador único do seu negócio no Apple Pay. Deve coincidir com o Merchant ID configurado na Apple. | Obrigatório |
organization | String | Nome da sua organização. | Obrigatório |
country | String | Código do país como, por exemplo, BR. | Obrigatório |
- A API devolverá uma resposta com os valores
certificate_idecertificate. Decodifique o campocertificate(em formato Base64) e salve-o em um arquivo.pem. - No Portal Apple Developer, vá até Certificates, Identifiers & Profiles > Identifiers, selecione seu Merchant ID e, na seção Apple Pay Payment Processing Certificate, clique em Create Certificate e faça o upload do arquivo
.pemgerado. - Em seguida, faça o download do certificado assinado.
- Por fim, envie uma solicitação com seu Access Token de testeChave privada da aplicação criada no Mercado Pago e que é utilizada no backend. Você pode acessá-la através de Suas integrações > Dados da integração > Testes > Credenciais de teste. ao endpoint certificates/certificate/uploadPOST do Mercado Pago para adicionar o certificado assinado.
curlcurl --location 'https://api.mercadopago.com/certificates/certificate/upload' \ --header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \ --form 'certificate=@"/User/Downloads/apple_pay.cer"'
| Elemento | Tipo | Descrição | Obrigatoriedade |
Authorization | Header | Header com seu Access Token de testeChave privada da aplicação criada no Mercado Pago e que é utilizada no backend. Você pode acessá-la através de Suas integrações > Dados da integração > Testes > Credenciais de teste.. | Obrigatório |
certificate | File | Arquivo do certificado gerado e assinado na Apple. | Obrigatório |
- Finalizado o processo, você precisará realizar novamente a verificação de domínio na Apple.
Com isso, seu ambiente de desenvolvimento já está pronto para continuar com as configurações específicas para oferecer o Apple Pay.