| Tabla de Contenido |
|
|
Acepta pagos con Apple Pay en tu integración con Kushki. Dependiendo del tipo de solución que utilices (Smartlink/Botón o Integración a medida), el proceso de configuración varía.
🚧 BETA: Disponibilidad Limitada 🇵🇪 🇨🇱
Ten en cuenta que Apple Pay se encuentra actualmente en fase Beta. Esta funcionalidad está disponible únicamente para comercios en Chile y Perú, y procesa transacciones exclusivamente con tarjetas Visa y Mastercard.
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. Sin embargo, es necesario activar manualmente esta opción en tu consola de Kushki.
Al momento de crear o editar tu Smartlink o Botón de Pagos en la Consola, asegúrate de habilitar el interruptor (toggle) correspondiente a Apple Pay en la sección de "Medios de Pago".
- Smartlinks: Revisa el paso a paso para la activación de Apple Pay en Smartlinks.
- Botón de Pagos: Consulta la guía para la activación de Apple Pay en Botones 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).
- Contacta al equipo de Soporte de Kushki.
- Solicita el Certificado de configuración de Apple Pay.
- 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.
- Ingresa a la Consola de Kushki.
- Dirígete a Configuración > Integraciones.
- Busca la sección de Apple Pay.
- Ingresa la URL de tu dominio (ejemplo:
tu-dominio.com) en el campo correspondiente. - 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.
Paso 4: Implementación técnica
Una vez verificado el dominio, debes proceder con la implementación técnica según tu método de integración:
- Kajita: Sigue la guía para activar Apple Pay en tu formulario Kajita.
- Kushki.js v2 (Hosted Fields): Revisa la documentación de integración de Apple Pay en v2.
- Kushki.js v1: Consulta los ejemplos de pago único para ver la implementación.
¿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.