Recursos para IA

Posibles errores

A continuación se describen los errores más frecuentes al integrar Apple Pay, sus causas y cómo resolverlos.

Errores por requisitos de Apple

EscenarioMensaje de errorRequisitos de Apple
Dispositivo no compatibleApple Pay no disponible o el botón no apareceDispositivos: iPhone o iPad con iOS 10.1 o superior, Mac con macOS Sierra o superior y Touch ID o Face ID.

Navegador: Safari principalmente; otros navegadores tienen soporte limitado.

Configuración: Wallet configurada con al menos una tarjeta válida.
Dominio no verificadoMerchant validation failed o Domain not verifiedEl dominio debe estar registrado y verificado en el Portal Apple Developer.

El archivo de verificación .well-known/apple-developer-merchantid-domain-association debe ser accesible.

HTTPS es obligatorio; Apple Pay no funciona en HTTP.
Certificados inválidos o expiradosMerchant validation failed o Certificate errorMerchant Identity Certificate válido y no expirado.

Payment Processing Certificate configurado correctamente.

Los certificados deben estar asociados al Merchant ID correcto.

Errores de la API de Orders

Apple Pay procesa los pagos con la Orders API, por lo que los errores devueltos al crear la order o el card token son los mismos que en Checkout API. Consulta la lista completa de códigos, mensajes y soluciones posibles en Posibles errores de Checkout API.