Safari no descarga el archivo pkpass, lo descarga como un bloque de texto o nunca muestra la hoja Añadir a Apple Wallet. El formato pkpass debería ser el camino más sencillo hacia Apple Wallet, así que cuando falla la transferencia suele valer la pena comprobar una cabecera del servidor o un ajuste de Safari.
Aquí encontrarás lo que Safari espera de una URL pkpass, configuraciones incorrectas habituales del servidor, los ajustes del iPhone que conviene revisar y una solución alternativa de Mac a iPhone que puede ayudar cuando el archivo .pkpass subyacente es válido.
Qué espera Safari de una URL pkpass
La guía para desarrolladores de Apple Wallet es clara sobre cómo debe servirse un archivo pkpass. Safari solo lo entrega a Apple Wallet cuando la respuesta coincide con la especificación.
Tipo MIME correcto
La guía para desarrolladores de Wallet de Apple indica que Mail y Safari esperan application/vnd.apple.pkpass. Cualquier otro tipo (text/html, application/octet-stream) suele romper la transferencia.
Content-Disposition
Content-Disposition: attachment; filename="pass.pkpass" es una recomendación práctica para el servidor. No es un requisito de la especificación de Apple, pero la disposición inline puede mostrar el archivo sin procesar.
Solicitud GET
La URL de descarga debe responder a una solicitud GET. Los puntos de acceso que solo aceptan POST fallan porque Safari sigue los enlaces mediante GET.
iOS 6 o posterior
La compatibilidad con pases llegó con iOS 6 (entonces llamado Passbook; cambió a Wallet en iOS 9). El formato de paquete .pkpasses (varios pases en un archivo) requiere iOS 15 o posterior.
Para conocer mejor el formato de archivo, consulta qué es un archivo pkpass.
El problema está en el servidor, no en Safari
Cómo saber qué recibe Safari
Una comprobación rápida indica si el pase está dañado o si el servidor está mal configurado.
- Al tocar el enlace aparece una hoja de vista previa de Apple Wallet
- El botón Añadir a Apple Wallet aparece arriba a la derecha
- El archivo se descarga en silencio y Wallet se abre
- La página se carga con texto binario ilegible
- Safari solicita una descarga, pero el archivo termina como .zip o .html
- La pulsación larga y Descargar archivo enlazado guardan un bloque inutilizable
- La página redirige mediante un flujo OAuth que elimina el archivo
En el iPhone: ajustes de Safari que bloquean las descargas
Incluso con un pkpass servido correctamente, conviene probar algunos ajustes del iPhone.
- Navegación privada: La navegación privada no es un bloqueo universal documentado. Abrir el enlace en una pestaña normal es una prueba rápida de diagnóstico.
- Bloqueadores de contenido: Los bloqueadores agresivos que eliminan etiquetas de script pueden romper la descarga cuando los emisores usan enlaces controlados por JavaScript. Desactiva el bloqueador para el dominio del emisor.
- Ubicación de las descargas de Safari: Ajustes, Apps, Safari, Descargas. Selecciona En mi iPhone o iCloud Drive. Una ubicación mal configurada puede provocar un fallo silencioso.
- Almacenamiento lleno: Un iPhone casi lleno rechaza nuevas descargas. Libera unos cientos de megabytes y vuelve a intentarlo.
- VPN activa: Una VPN no es una causa universal. Desactívala brevemente para comprobar si el enrutamiento o los filtros del emisor afectan a la solicitud.
Chrome, Firefox y otros navegadores de iOS
Evita la descarga defectuosa
NeatPass facilita convertir cualquier entrada, pase o tarjeta de fidelización en Apple Wallet.
Solución 1: abrirlo en Apple Mail
Si Safari tiene problemas con la URL, enviarte el enlace y abrirlo en Apple Mail suele funcionar. El gestor integrado de Mail dirige los adjuntos pkpass directamente a Wallet.
Envíate el enlace
Ábrelo en Apple Mail
Toca Añadir a Apple Wallet
Solución 2: descargarlo en el Mac y usar AirDrop al iPhone
Es una solución útil cuando Safari en el iPhone rechaza la descarga. Los navegadores del Mac pueden guardar un pkpass en el disco, y enviar por AirDrop un archivo .pkpass válido del Mac al iPhone puede entregarlo directamente a Apple Wallet. Esto no repara un archivo HTML, ZIP o bloque de texto corrupto al que solo se haya cambiado el nombre a .pkpass.
Descarga el archivo en el Mac
Usa AirDrop al iPhone
Acéptalo en el iPhone
Para saber más sobre cómo transferir códigos de barras y pases entre dispositivos, consulta copiar un código de barras del Mac al iPhone y la guía de métodos de importación.
Solución 3: captura el código de barras y vuelve a crear el pase
Si el pkpass original está roto en el emisor (certificado caducado o JSON mal formado), ninguna solución del lado del cliente funcionará. La opción práctica es tomar el código de barras del billete original, de una captura de pantalla o de un PDF y crear un pase Wallet nuevo.
NeatPass lee códigos de barras de capturas de pantalla, PDF y cámara, y después emite un pase limpio firmado con PassKit que conserva los mismos datos escaneables. El contenido del código de barras se mantiene, por lo que el pase se escanea igual en cualquier lector. El modelo de privacidad está documentado en la FAQ de privacidad y el pase funciona sin Internet (modo sin conexión).
Fidelidad de los datos del código de barras
Para consultar los formatos de códigos de barras compatibles durante esta reconstrucción, visita códigos de barras compatibles y cómo añadir un pase a Wallet.
Preguntas frecuentes
Crea un pase Wallet limpio
DescargarTu pase en Wallet
Cuando Safari rechaza una descarga pkpass, el archivo puede estar mal configurado en el origen. Pide al emisor que lo corrija o evita la entrega defectuosa con AirDrop, Apple Mail o reconstruyendo el pase a partir del código de barras.
Si los pases simplemente no se instalan una vez que están en el dispositivo, consulta la guía de problemas de Wallet.