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 um POST 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/generateAPI do Mercado Pago para gerar o certificado.
curl
curl --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": [valor], "organization": "MyOrg", "country": "BR" }'
| Parâmetro | Descrição |
type | Tipo de certificado. Para esta etapa, deve ser "merchant". Guarde o certificate_id para os passos seguintes. |
flow | Valor fixo apple_pay. |
merchantIdentifier | Identificador único do seu negócio no Apple Pay. Deve coincidir com o Merchant ID configurado na Apple. |
organization | Nome da sua organização. |
country | Código do país, por exemplo BR. |
- 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 um POST 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/uploadAPI do Mercado Pago para adicionar o certificado assinado.
curl
curl --location 'https://api.mercadopago.com/certificates/certificate/upload' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --form 'certificate=@"/User/Downloads/apple_pay.cer"'
| Elemento | Descrição |
Authorization | 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.. |
certificate | Arquivo do certificado gerado e assinado na Apple. |
- 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/generateAPI do Mercado Pago para gerar o certificado.
curl
curl --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": [valor], "organization": "MyOrg", "country": "BR" }'
| Parâmetro | Descrição |
type | Tipo de certificado. Para esta etapa, deve ser "payment". Guarde o certificate_id para os passos seguintes. |
flow | Valor fixo apple_pay. |
merchantIdentifier | Identificador único do seu negócio no Apple Pay. Deve coincidir com o Merchant ID configurado na Apple. |
organization | Nome da sua organização. |
country | Código do país, por exemplo BR. |
- 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 um POST 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/uploadAPI do Mercado Pago para adicionar o certificado assinado.
curl
curl --location 'https://api.mercadopago.com/certificates/certificate/upload' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --form 'certificate=@"/User/Downloads/apple_pay.cer"'
| Elemento | Descrição |
Authorization | 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.. |
certificate | Arquivo do certificado gerado e assinado na Apple. |
- 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.
