Configuración de Apple Pay

Acepta pagos con Apple Pay en tu integración con Kushki. Dependiendo del tipo de solución que utilices (Plugins/Smartlink o Integración a medida), el proceso de configuración varía.

💡 Nota: ¿Necesito una cuenta de Apple Developer?
No. Al usar Kushki como tu procesador de pagos, nosotros gestionamos la complejidad de los certificados con Apple. Solo necesitas alojar el archivo que te entregamos para demostrar que eres el dueño del dominio.

1. Integraciones directas (Botón de Pagos y Smartlinks)

Si utilizas Botón de Pagos (Webcheckout) o Smartlinks, la integración técnica ya está resuelta por nosotros.

Para habilitar Apple Pay, simplemente debes ponerte en contacto con tu Account Manager o con nuestro equipo de Soporte para solicitar la activación del método de pago en tu comercio. Una vez activo, el botón de Apple Pay aparecerá automáticamente en tu formulario de pago.

2. Integraciones a medida (Librerías y Kajita)

Si utilizas Kushki.js (v1) o v2 (hosted fields) o Kajita, es necesario realizar una verificación de dominio para garantizar que tu sitio web está autorizado para procesar pagos con Apple Pay.

ℹ️ Requisitos previos: Antes de iniciar, asegúrate de tener acceso a la Consola de Kushki, específicamente al módulo de Configuración.

Paso 1: Solicitar el archivo de verificación

Para validar tu dominio, necesitas el archivo de asociación de comerciante de Apple (apple-developer-merchantid-domain-association).

1. Contacta al equipo de Soporte de Kushki.
2. Solicita el Certificado de configuración de Apple Pay.
3. Especifica para qué ambiente requieres el archivo: Pruebas (UAT) o Producción.

❗ Importante: Los archivos de verificación son únicos para cada ambiente. Asegúrate de solicitar y utilizar el archivo correcto para UAT o Producción según corresponda.

Paso 2: Alojamiento del archivo en tu servidor

Una vez que Kushki te entregue el archivo, debes alojarlo en tu servidor web. Apple requiere que este archivo sea accesible públicamente a través del protocolo HTTPS en una ruta específica.

Crea una carpeta llamada .well-known en la raíz de tu dominio y coloca allí el archivo descargado. La URL final debe verse así:

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

Puedes verificar que el archivo está correctamente alojado ejecutando el siguiente comando en tu terminal o simplemente pegando la URL en tu navegador:

curl -I https://tu-dominio.com/.well-known/apple-developer-merchantid-domain-association

Debes recibir una respuesta 200 OK y el archivo debe ser descargable o visible.

Paso 3: Registro de dominio en la Consola Kushki

Con el archivo alojado correctamente, el último paso es registrar tu dominio en nuestra plataforma para finalizar la asociación.

1. Ingresa a la Consola de Kushki.
2. Dirígete a Configuración > Integraciones.
3. Busca la sección de Apple Pay.
4. Ingresa la URL de tu dominio (ejemplo: tu-dominio.com) en el campo correspondiente.
5. Haz clic en Registrar o Verificar.

En este momento, Kushki se comunicará con Apple para verificar que el archivo existe en tu servidor. Si todo es correcto, el dominio quedará verificado y podrás comenzar a procesar transacciones con Apple Pay.