Obtener los certificados de Apple Developer
Para comenzar a ofrecer pagos rápidos y seguros con Apple Pay, es necesario realizar algunas configuraciones para que sea posible validar la identidad del sitio y del vendedor, y así permitir las transacciones garantizando la seguridad de los datos de pago.
Selecciona el tipo de plataforma a continuación y sigue las instrucciones según tu tipo de integración.
Para poder utilizar Apple Pay como medio de pago, es necesario registrar y verificar tu dominio en el Portal Apple Developer. Para ello, sigue los pasos a continuación.
- En el Portal Apple Developer, navega hasta "Certificates > Identifiers & Profiles", agrega tu dominio y guarda.
- Descarga el archivo
.txtgenerado. Es importante destacar que cada vez que haces clic en el botón de descarga en el panel, se descarga un nuevo archivo que invalida el anterior. - Sube ese archivo a tu servidor en una carpeta oculta llamada
.well-known. - En el Portal, haz clic en el botón Verify para realizar la verificación del archivo.
- Verifica que al acceder a "https://tu-dominio/.well-known/apple-developer-merchantid-domain-association.txt" se muestre el contenido del archivo de verificación.
Para poder utilizar Apple Pay como medio de pago, es necesario incluir el certificado que se usará para comprobar que eres un vendedor autorizado, garantizando que tu aplicación es de un merchant con habilitación para solicitar pagos vía Apple Pay. Para ello, sigue los pasos a continuación.
- Envía un POST con tu Access Token de pruebasClave privada de la aplicación creada en Mercado Pago, utilizado en el backend. Puedes acceder a él a través de Tus integraciones > Detalles de aplicación > Pruebas > Credenciales de prueba. al endpoint certificates/csr/generateAPI de Mercado Pago para generar el 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 | Descripción |
type | Tipo de certificado. Para esta etapa, debe ser "merchant". Guarda el certificate_id para los pasos siguientes. |
flow | Valor fijo apple_pay. |
merchantIdentifier | Identificador único de tu negocio en Apple Pay. Debe coincidir con el Merchant ID configurado en Apple. |
organization | Nombre de tu organización. |
country | Código del país, por ejemplo BR. |
- La API devolverá una respuesta con los valores
certificate_idycertificate. Decodifica el campocertificate(en formato Base64) y guárdalo en un archivo.pem. - En el Portal Apple Developer, ve a Certificates, Identifiers & Profiles > Identifiers, selecciona tu Merchant ID y, en la sección Apple Pay Merchant Identity Certificate, haz clic en Create Certificate y sube el archivo
.pemgenerado. - Luego, descarga el certificado firmado.
- Por último, envía un POST con tu Access Token de pruebasClave privada de la aplicación creada en Mercado Pago, utilizado en el backend. Puedes acceder a él a través de Tus integraciones > Detalles de aplicación > Pruebas > Credenciales de prueba. al endpoint certificates/certificate/uploadAPI de Mercado Pago para agregar el certificado firmado.
curl
curl --location 'https://api.mercadopago.com/certificates/certificate/upload' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --form 'certificate=@"/User/Downloads/apple_pay.cer"'
| Elemento | Descripción |
Authorization | Header con tu Access Token de pruebasClave privada de la aplicación creada en Mercado Pago, utilizado en el backend. Puedes acceder a él a través de Tus integraciones > Detalles de aplicación > Pruebas > Credenciales de prueba.. |
certificate | Archivo del certificado generado y firmado en Apple. |
- Finalizado el proceso, deberás realizar nuevamente la verificación de dominio en Apple.
Para poder utilizar Apple Pay como medio de pago, es necesario incluir el certificado que se usará para desencriptar los datos de pago, interpretando de forma segura el payload utilizado en el pago. Para ello, sigue los pasos a continuación.
- Realiza una solicitud al endpoint certificates/csr/generateAPI de Mercado Pago para generar el 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 | Descripción |
type | Tipo de certificado. Para esta etapa, debe ser "payment". Guarda el certificate_id para los pasos siguientes. |
flow | Valor fijo apple_pay. |
merchantIdentifier | Identificador único de tu negocio en Apple Pay. Debe coincidir con el Merchant ID configurado en Apple. |
organization | Nombre de tu organización. |
country | Código del país, por ejemplo BR. |
- La API devolverá una respuesta con los valores
certificate_idycertificate. Decodifica el campocertificate(en formato Base64) y guárdalo en un archivo.pem. - En el Portal Apple Developer, ve a Certificates, Identifiers & Profiles > Identifiers, selecciona tu Merchant ID y, en la sección Apple Pay Payment Processing Certificate, haz clic en Create Certificate y sube el archivo
.pemgenerado. - Luego, descarga el certificado firmado.
- Por último, envía un POST con tu Access Token de pruebasClave privada de la aplicación creada en Mercado Pago, utilizado en el backend. Puedes acceder a él a través de Tus integraciones > Detalles de aplicación > Pruebas > Credenciales de prueba. al endpoint certificates/certificate/uploadAPI de Mercado Pago para agregar el certificado firmado.
curl
curl --location 'https://api.mercadopago.com/certificates/certificate/upload' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --form 'certificate=@"/User/Downloads/apple_pay.cer"'
| Elemento | Descripción |
Authorization | Header con tu Access Token de pruebasClave privada de la aplicación creada en Mercado Pago, utilizado en el backend. Puedes acceder a él a través de Tus integraciones > Detalles de aplicación > Pruebas > Credenciales de prueba.. |
certificate | Archivo del certificado generado y firmado en Apple. |
- Finalizado el proceso, deberás realizar nuevamente la verificación de dominio en Apple.
Con esto, tu entorno de desarrollo ya está listo para continuar con las configuraciones específicas para ofrecer Apple Pay.
