Guia de Integração: Apple Pay

Atualizado em 13 de agosto de 2026

1. Criando o Merchant ID

Acesse o Apple Developer e faça login com a conta que possui o programa de desenvolvedor ativo.
No canto superior esquerdo, clique no botão azul +.
Em Registrar um novo identificador, mantenha selecionada a opção Merchant IDs e clique em Continuar.
Preencha os campos:
- Descrição: utilizada apenas para identificação dentro do painel da Apple. Pode ser qualquer nome de sua preferência.
- Identificador: recomendamos utilizar o domínio do seu gateway de forma invertida, adicionando o prefixo merchant.

Exemplo:

Domínio:

app.CN Pay.com.br

Merchant ID:

merchant.br.com.CN Pay.app

Finalize o cadastro.

Após isso, o Merchant ID estará criado e poderá ser informado no painel administrativo e enviado à adquirente, caso seja solicitado.

2. Gerando o certificado do Merchant

Para autenticar o Merchant durante o pagamento no checkout, é necessário criar um Apple Pay Merchant Identity Certificate.

Importante: o Merchant ID deve estar criado antes de iniciar esta etapa.

2.1 Criando o certificado na Apple

Acesse o Apple Developer – Certificates e faça login, se necessário.
No canto superior esquerdo, clique no botão azul +.
Em Create a New Certificate, selecione:
Apple Pay Merchant Identity Certificate
Clique em Continuar.
Selecione o Merchant ID criado anteriormente.
Exemplo:
```
merchant.br.com.CN Pay.app
```
A Apple solicitará um Certificate Signing Request (.csr).

3. Gerando a chave `.key` e o `.csr`

Abra o terminal da sua máquina e execute os comandos abaixo.

Primeiro, gere a chave privada:

openssl genrsa -out merchant_identity.key 2048

Depois, gere o Certificate Signing Request:

openssl req -new \   -key merchant_identity.key \   -out merchant_identity.csr

Ao finalizar, serão gerados dois arquivos:

merchant_identity.key merchant_identity.csr

Para que serve cada arquivo?

merchant_identity.key: chave privada que será utilizada na configuração do painel administrativo.
merchant_identity.csr: arquivo que será enviado à Apple para gerar o certificado do Merchant.

Atenção: o arquivo .key é uma credencial privada. Não compartilhe esse arquivo publicamente nem o envie para terceiros que não sejam responsáveis pela configuração da integração.

4. Gerando o certificado `.cer`

Retorne à página da Apple onde está sendo criado o Apple Pay Merchant Identity Certificate.
Faça upload do arquivo:
```
merchant_identity.csr
```
Finalize o processo.

A Apple disponibilizará o certificado no formato:

.cer

Para configurar a integração no nosso painel, será necessário converter esse certificado para .pem.

5. Convertendo o `.cer` para `.pem`

Com o certificado .cer baixado da Apple, execute:

openssl x509 \   -inform DER \   -in merchant_id.cer \   -out merchant_identity.pem

Caso o arquivo tenha outro nome, substitua merchant_id.cer pelo nome correspondente.

Após a conversão, será criado:

merchant_identity.pem

6. Configurando a integração no painel administrativo

Ao finalizar o processo, você deverá possuir os seguintes arquivos:

merchant_identity.key merchant_identity.pem

No painel administrativo, informe:

Merchant ID
Merchant Identity Certificate (.pem)
Merchant Identity Key (.key)
Merchant Name — opcional

Após salvar as informações, as credenciais necessárias para autenticação do Merchant estarão configuradas.

7. Payment Processing Certificate

Dependendo da adquirente utilizada, também poderá ser necessário gerar o:

Apple Pay Payment Processing Certificate.

Esse certificado é diferente do Apple Pay Merchant Identity Certificate apresentado neste tutorial.

A necessidade e o processo de utilização do Payment Processing Certificate dependem da adquirente responsável pelo processamento das transações.

Por isso, consulte a sua adquirente para confirmar se esse certificado também será necessário para habilitar o Apple Pay como método de pagamento.