Guías
Página de estadoDashboardReservar una demostración
Empieza a escribir para buscar...

Requisitos previos (Apple Pay)

📘

Apple Pay es compatible con navegadores de terceros, como Google Chrome, para usuarios con iOS 18 o superior.

Utiliza esta guía para preparar y configurar Apple Pay con Yuno.

Cuando hayas terminado, estarás listo para elegir tu ruta de integración (SDK o Directa) para pagos únicos y recurrentes.

Paso 1: Registrar un identificador de comerciante

📘

Si utilizas VTEX como plataforma de comercio electrónico, tendrás que configurar tu ID de comerciante de Apple Pay. Para obtener instrucciones detalladas, consulta la documentación oficial de VTEX.

En el panel de desarrolladores de Apple:

  1. Accede a Apple Developer, ve a Certificados, Identificadores y Perfiles, y selecciona Registrar un nuevo identificador.
  2. Elige ID de comerciante.
  3. Introduzca una Descripción (p. ej., Apple Pay Integration) y un Identifier en el formato merchant.com.y.uno.YourBusinessName.

Paso 2: Generar un certificado de procesamiento de pagos

  1. Crea un nuevo directorio (por ejemplo, Downloads/ApplePayFiles) para almacenar los archivos del certificado.
  2. Abre Keychain Access en tu Mac.
  3. Vaya a Acceso a Llaveros > Asistente de Certificados > pedido un Certificado a una Autoridad de Certificación.

  1. Rellene el formulario:

    • Dirección deEmail : su dirección de email
    • Nombre común: un nombre para el certificado (por ejemplo, John Doe ProcessingCertificate)
    • Dirección de Email de CA: dejar en blanco
    • Seleccione Guardar en disco
    • Marque Permítame especificar la información del par de claves

  2. Haga clic en Continúe en, luego guarde el archivo como CertificateSigningRequestPaymentProcessingCertificate.certSigningRequest en su directorio de trabajo.

  3. Cuando se le solicite la configuración del par de claves, utiliza:

    • Tipo de clave: Curva elíptica (EC)
    • Tamaño de la clave: 256 bits
    • Algoritmo: ECDSA

Paso 3: Recupere y convierta el certificado de procesamiento de pagos

  1. Vaya a la lista de Apple Developer Merchant ID.
  2. Selecciona tu ID de comerciante y haz clic en Crear certificado en Certificado de procesamiento de pago Apple Pay.
  3. Cuando se le solicite, responda No a "¿Se procesarán los pagos... exclusivamente en China continental?".
  4. Subir el archivo CertificateSigningRequestPaymentProcessingCertificate.certSigningRequest.
  5. Descargue el certificado firmado como apple_pay.cer y guárdelo en su directorio.
  6. Convertir el certificado al formato PEM:
openssl x509 -inform DER -in apple_pay.cer -out apple_pay.pem

Paso 4: Exportar la clave privada

  1. En Acceso a llaveros, busque la clave que creó (por ejemplo, John Doe ProcessingCertificate).
  2. Haga clic con el botón derecho y seleccione Exportar.
  3. Exportar la clave como .p12 archivo (por ejemplo, JohnDoeProcessingCertificate.p12) y guárdelo en su directorio de trabajo.
  4. Establezca una contraseña segura (la usará en el siguiente paso).
  5. Convertir el .p12 a una clave privada en formato PEM:
openssl pkcs12 -in JohnDoeProcessingCertificate.p12 -nocerts -nodes | sed -ne '/-BEGIN PRIVATE KEY-/,/-END PRIVATE KEY-/p' > ProcessingCertificatePrivateKey.pem

La clave privada se almacenará en ProcessingCertificatePrivateKey.pem.

Paso 5: Cargue el certificado y la clave en Yuno

  1. Abre el Panel de Control de Yuno > Conexiones > Apple Pay > Conectar
  2. Introduzca el contenido de ProcessingCertificatePrivateKey.pem hacia clave de procesamiento de pago .
  3. Introduzca el contenido de apple_pay.pem En el Certificado de procesamiento de pagos .

Paso 6: Generar un certificado de identidad de comerciante

  1. Abre Acceso a Llaveros, navega hasta Asistente de Certificados > pedido un Certificado a una Autoridad de Certificación, y entra:
  • Dirección deEmail : su email
  • Nombre común: p. ej., John Doe MerchantIdentityCertificate
  • Deje en blanco la dirección de Email de CA
  • Seleccione Guardar en disco
  1. Guardar como CertificateSigningRequestMerchantIdentityCertificate.certSigningRequest.

Paso 7: Recupere y convierta el certificado de identidad del comerciante

  1. Vaya a la lista de Apple Developer Merchant ID.
  2. Seleccione su ID de comerciante y haga clic en Crear certificado en Certificado de identidad de comerciante de Apple Pay.
  3. Subir el CertificateSigningRequestMerchantIdentityCertificate.certSigningRequest .
  4. Descargue el certificado firmado como merchant_id.cer y guárdalo.
  5. Convertirlo a PEM:
openssl x509 -inform DER -in comerciante_id.cer -out comerciante_id.pem

Paso 8: Exportar la clave privada de identidad del comerciante

  1. En Acceso a llaveros, busque el certificado creado en el paso 6, por ejemplo John Doe MerchantIdentityCertificate.
  2. Haga clic derecho y exporte como JohnDoeMerchantIdentityCertificate.p12.
  3. Establezca una contraseña segura.
  4. Convertir la clave privada a PEM:
openssl pkcs12 -in JohnDoeMerchantIdentityCertificate.p12 -nocerts -nodes | sed -ne '/-BEGIN PRIVATE KEY-/,/-END PRIVATE KEY-/p' > MerchantIdentityCertificatePrivateKey.pem

La clave privada estará disponible como MerchantIdentityCertificatePrivateKey.pem.

Paso 9: Cargue el certificado de identidad del comerciante y la clave

  1. Vuelve a tu conexión Apple Pay en el Panel de Control de Yuno.
  2. Copiar el contenido de MerchantIdentityCertificatePrivateKey.pem y pégalos en el Clave de identidad del comerciante .
  3. Pegar el contenido de merchant_id.pem En el Certificado de identidad del comerciante .

Paso 10: Registre sus dominios comerciales

  1. Vaya a la lista de Apple Developer Merchant ID.
  2. Seleccione su ID de vendedor y haga clic en Añadir dominio en Dominios de vendedor.
  3. Introduzca el dominio (por ejemplo, demo.y.uno) y haga clic en Save.
⚠️

Nota

También debes alojar el programa de Apple apple-developer-merchantid-domain-association archivo en:

https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association

Una vez completados todos los pasos, puedes continuar con la configuración del Panel de control.

Paso 11: Conexión a Apple Pay Dashboard

  1. Accede a tu panel de control de Yuno.
  2. Vaya a la sección Conexiones.
  3. Busca y selecciona la opción Apple Pay y haz clic en Conectar.
  4. Proporciona un Nombre para la conexión, selecciona Apple Pay como método depago y proporciona la información que adquiriste al seguir el proceso de Requisitos previos, haz clic en Siguiente.
  5. Configure los costos de instalación (opcional) y las cuentas en los siguientes dos pasos.
  6. Haz clic en Guardar. Apple Pay se añadirá a tus conexiones.

Paso 12: Configurar el enrutamiento del Panel de control

Configura una nueva ruta para controlar cómo se procesan los pagos a través de Apple Pay.

📘

Visite la página Enrutamiento para obtener más información sobre este paso.

  1. En el Panel de Control de Yuno, navega a la sección de Enrutamiento.
  2. Busca la conexión de Apple Pay. Si aún no has creado una ruta para Apple Pay, estará en la pestaña No publicado.
  3. Configure una nueva ruta pulsando Configurar en su módulo Apple Pay (o Ver si la ruta está publicada) y, a continuación, pulse Crear nueva ruta. Dale un nombre a la conexión y pulsa Guardar.
  4. Agregue condiciones para especificar cómo deben enrutarse los pagos a través de Apple Pay.
  5. Agregue Apple Pay como procesador de pagos para esta ruta para garantizar que los pagos que cumplan con las condiciones definidas se procesen a través de Apple Pay.
  6. Publique la ruta una vez definidas todas las configuraciones.

Aquí hay una ruta sencilla para procesar todos los pagos a través de Apple Pay.

Paso 13: Activar Apple Pay en Checkout Builder

📘

Visita la página del Generador de Checkout para obtener información adicional sobre este paso.

Para que Apple Pay esté disponible para sus usuarios finales, debe habilitarlo en Checkout Builder:

  1. En el Panel de Control de Yuno, navega a la sección de Checkout Builder.
  2. Localiza los métodos depago disponibles y activa Apple Pay. Haz clic en los tres puntos junto a cada método para ver opciones adicionales.
  3. Haz clic en Publicar configuración para que Apple Pay esté disponible como opción de pago para todas las transacciones que cumplan los criterios de enrutamiento definidos.
📘

Si planea implementar pagos recurrentes, deberá configurar una URL adicional en su conexión de Apple Pay donde los clientes puedan gestionar sus suscripciones (cancelar, modificar, etc.). Esta URL debe ser creada y alojada por su plataforma comercial.

Próximos pasos

Tras completar la configuración del Panel de control, elige tu ruta para integrarlo mediante SDK o Direct:


Actualizado hace 3 meses