Acepta pagos con Apple Pay en tu integración con Kushki.Acepta pagos con Apple Pay en tu integración con Kushki. Dependiendo del tipo de solución que utilices (Smartlink/Botón, Integración a medida o Integración directa con Apple Pay), el proceso de configuración varía.
Importante
🚧 BETA: Disponibilidad Limitada 🇵🇪 🇨🇱 🇲🇽 🇨🇴 Ten en cuenta que Apple Pay se encuentra actualmente en fase Beta. Esta funcionalidad está disponible únicamente para comercios en Chile, México, Colombia y Perú bajo el modelo de Adquiriencia Kushki.
1. Integraciones no-code: 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".
No. Para Integraciones No-Code (Smartlinks, Botón de Pagos) e Integraciones a medida (librerias y Kajita), no necesitas una cuenta de Apple Developer.Al usar Kushki como tu procesador, 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.
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.
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
⚠️ 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.
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-associationPuedes verificar que el archivo está correctamente alojado ejecutando el siguiente comando en tu terminal o simplemente pegando la URL en tu navegador:
Debes recibir una respuesta 200 OK y el archivo debe ser descargable o visible.
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.
Kushki.js v2 (Hosted Fields): Revisa la documentación de integración de Apple Pay en v2 para ejemplos de la integración en pagos únicos y suscripciones.
Regresa a la consola de Apple (sección Merchant IDs), selecciona tu ID y haz clic en Create Certificate bajo el título Apple Pay Merchant Identity Certificate.
Carga el archivo merchant_id.csr generado y pulsa Continue.
Descarga el certificado (merchant_id.cer).
Fase 3: Genera el Apple Pay Payment Processing Certificate#
Una vez que el Merchant ID y el Merchant Identity Certificate hayan sido generados, es necesario obtener un Certificate Signing Request.Sigue los siguientes pasos para obtener el certificado:
1.
Crea la clave privada EC (P-256): Ejecuta el siguiente comando para generar la llave de procesamiento:
Éxito: Si el archivo es accesible, Apple verificará el dominio de inmediato y verás el estado como "Verified".
Error: Si la verificación falla, revisa estos puntos críticos antes de intentar de nuevo:
Ruta exacta: asegúrate de que la carpeta se llame .well-known (con el punto al inicio) y el nombre del archivo no tenga extensiones extrañas.
Accesibilidad: intenta abrir la URL del archivo desde una ventana de incógnito en tu navegador. Si tú no puedes verlo, Apple tampoco podrá.
Redirecciones: asegúrate de que tu servidor no esté forzando redirecciones o bloqueos de seguridad (firewalls) que impidan la lectura directa del archivo de texto.
Una vez que cuentas con tus certificados y el dominio verificado, debes proceder con la programación del botón de pago en tu sitio web.
Importante
Para implementar el botón y para más información, apóyate en la guía oficial de Apple Pay on the Web
Sigue los siguientes pasos:
Crear la Sesión de Apple Pay: Utiliza tu Merchant Identity Certificate (generado en la Fase 2) para comunicarte con los servidores de Apple. Esto es obligatorio para validar tu identidad y permitir que la hoja de pago (Wallet) se despliegue en el dispositivo del cliente.
Desencriptar los datos: Una vez que el cliente autoriza la compra, Apple te devolverá un objeto de pago encriptado. Debes utilizar la llave privada de tu Payment Processing Certificate (generada en la Fase 3) para desencriptar este paquete y obtener los datos de la tarjeta (DPAN, criptograma, etc.).
Tokenizar con Kushki: Finalmente, con la información de la tarjeta ya desencriptada, debes enviarla a Kushki para generar un token seguro de transporte.
Debes consumir el endpoint para crear un Network Token.
¿Hay códigos especiales de declinación para las transacciones de Apple Pay? No, porque la transacción viaja hacia las marcas por el mismo flujo de tarjeta, y aplican los mismos códigos de declinación ya existentes.
¿Hay montos máximos o mínimos por transacción? No, no existen límites específicos de montos impuestos por Apple Pay.
¿Funciona desde aplicaciones móviles? No. Actualmente, la funcionalidad está disponible solo para compras utilizando navegadores web.
¿El registro de dominios debe realizarse en UAT (pruebas) y Producción? Sí, Apple exige que el dominio sea validado en ambos ambientes para procesar pagos correctamente.
¿Aplica la autenticación con 3DS para transacciones realizadas con Apple Pay? Las transacciones Apple Pay no requieren 3DS porque al registrar la tarjeta en la billetera el proceso es autorizado por el Emisor
