Enlaces de compra externa de App Store en 2026
La directriz 3.1.1 de revisión de la app sigue exigiendo que los bienes y servicios digitales vendidos dentro de una app de App Store usen la compra dentro de la app, pero la lista de excepciones volvió a crecer, y en 2026 hay tres formas distintas en que una app conforme puede enviar a un cliente a una página de pago propia. El texto actual de la directriz 3.1.1(a) lo dice sin rodeos: los desarrolladores pueden solicitar derechos para incluir un enlace en su app a un sitio web que posean o del que mantengan responsabilidad, y —la frase que más importa a los editores de EE. UU.— "Estos derechos no son necesarios para que los desarrolladores incluyan botones, enlaces externos u otras llamadas a la acción en sus apps de la tienda de EE. UU." En cualquier otra tienda, la misma directriz indica que las apps y sus metadatos no pueden incluir botones, enlaces externos u otras llamadas a la acción que dirijan a los clientes a mecanismos de compra distintos de la compra dentro de la app.
La versión en una línea: la tienda de Estados Unidos no necesita ningún entitlement; el entitlement com.apple.developer.storekit.external-purchase-link cubre las tiendas iOS/iPadOS donde Apple permite un enlace de salida; y el nuevo entitlement de enlace de compra personalizado está limitado por región, con Brasil y Japón sumándose a los códigos de país de la UE. ExternalPurchaseLink te indica en tiempo de ejecución si algo de esto aplica, eligibleURLs y open(url:) abren realmente el enlace, y cada token que se devuelve debe notificarse a través de la API del servidor de compras externas.
Paso 1 — Determina en cuál de las tres rutas está tu app
La primera vía es la tienda de EE. UU.: los enlaces de salida están permitidos sin necesidad de un entitlement, y la propia directriz lo dice explícitamente. La segunda vía es com.apple.developer.storekit.external-purchase-link, también conocido como entitlement de enlace de compra externa de StoreKit: el propio resumen de Apple indica que «permite a las apps que cumplen los requisitos incluir un enlace que dirige a los usuarios de la app a un sitio web para realizar una compra externa», y el acuerdo del entitlement limita ese enlace a informar a los usuarios dónde y cómo comprar artículos dentro de la app, incluido el hecho de que pueden estar disponibles a un precio comparativamente más bajo. La tercera vía es com.apple.developer.storekit.custom-purchase-link.allowed-regions: un entitlement que «permite a una app que cumple los requisitos ofrecer compras externas dentro de la app o en un sitio web, en regiones específicas», y cuyo valor no es un booleano sino un array de códigos ISO-3166-1 de dos letras. Según la documentación, las regiones permitidas para enlaces de compra personalizados incluyen Brasil (br), Japón (jp) y los códigos de países de la UE: Austria, Bélgica, Bulgaria, Croacia, Chipre, Chequia, Dinamarca, Estonia, Finlandia, Francia, Alemania, Grecia, Hungría, Irlanda, Italia, Letonia, Lituania, Luxemburgo, Malta, Países Bajos, Polonia, Portugal, Rumanía, Eslovaquia, Eslovenia, España y Suecia.
Antes de escribir código, enumera las tiendas en las que realmente publicas. Un único enlace global que ignore el límite de la tienda es la forma más común de que esta función acabe en un rechazo.
Paso 2 — Consigue el derecho en tu perfil de firma
Los derechos se conceden por cuenta de desarrollador, no por ficha de la tienda, y Apple expone la limitación directamente: los derechos "solo pueden usarse en iOS o iPadOS App Store en escaparates concretos". Una vez que la cuenta recibe el derecho StoreKit External Purchase Link, lo añades a tu app abriendo el archivo .entitlements del proyecto en Xcode, añadiendo la clave com.apple.developer.storekit.external-purchase-link y estableciendo su valor en true. Para la variante limitada por región, la clave es com.apple.developer.storekit.custom-purchase-link.allowed-regions y el valor es un array de los códigos de país en minúsculas donde pretendes ofrecer la funcionalidad; la redacción de Apple es que "solo debe incluir regiones donde Apple admite opciones de enlace de compra personalizado".
Como el entitlement está vinculado al perfil de aprovisionamiento, la secuencia práctica es: solicitarlo, esperar a que aparezca la capacidad, regenerar los perfiles, volver a firmar y luego subir. Una compilación firmada con un perfil antiguo simplemente no podrá abrir el enlace, y el fallo aparece en tiempo de ejecución, no en tiempo de compilación.
Paso 3 — Configura las URL de destino en Info.plist
Two property list keys do the work, and picking the right one decides which API you call. SKExternalPurchaseLink is a dictionary whose keys are lowercased ISO 3166-1 alpha-2 country codes — one destination URL per country code. Apple lists the valid codes: the twenty-seven EU member states plus Iceland (is), Norway (no) and Russia (ru). SKExternalPurchaseMultiLink is the multi-link variant: the same dictionary shape, but each country code maps to an array of one to five destination URLs.
Cada URL de destino debe cumplir cuatro condiciones, y la cuarta es la que se pasa por alto: debe usar el esquema HTTPS, formar una URL absoluta válida, no contener parámetros de consulta y tener 1.000 caracteres ASCII o menos. Además, Apple afirma que «En todo momento, las URL de destino que proporciones en la clave de la lista de propiedades deben coincidir con los valores de tu binario de la app que envías a la revisión de la app», así que las URL forman parte, en la práctica, de tu envío a revisión, y cambiarlas es una versión, no una edición de configuración.
MultiLink no está disponible para todos: puedes incluir uno o varios enlaces por código de país si tu app cumple los requisitos del entitlement StoreKit External Purchase Link tal como lo describe Apple; de lo contrario, incluyes exactamente un enlace por código de país.
Paso 4 — Controla la interfaz con canOpen antes de dibujar nada
canOpen es un booleano que responde a «¿puede esta app abrir correctamente el enlace de compra externa configurado en la tienda actual de App Store?». Apple documenta exactamente tres condiciones que deben cumplirse todas: la tienda actual permite la compra externa y la persona es elegible para realizar compras externas; tu app configura el derecho com.apple.developer.storekit.custom-purchase-link.allowed-regions o com.apple.developer.storekit.external-purchase-link; y tu app configura un enlace para la tienda actual. Cualquier otro caso es false. No hace falta volver a comprobarlo salvo que cambie la tienda de App Store, lo que significa que puedes evaluarlo una vez al iniciar y controlar la interfaz de tu muro de pago a partir del resultado. Cuando es false, la alternativa documentada es comprobar canMakePayments y mantener la compra dentro de la app.
Paso 5 — Abrir el enlace: open() u open(url:)
Con un único enlace configurado, llama a ExternalPurchaseLink.open(). Con la clave de varios enlaces, lee eligibleURLs —el array de enlaces que la app ha configurado para la tienda actual— y llama a open(url:) con el que elijas, en respuesta a una interacción deliberada del usuario, como tocar un botón. Apple deja claro que eligibleURLs devuelve nil en tres situaciones: la tienda no permite la compra externa o la persona no es elegible; falta el derecho; o no hay enlaces configurados para la tienda actual. Nil junto con un SKExternalPurchaseLink configurado significa recurrir a canOpen; nil sin él significa recurrir a canMakePayments.
open(url:) es asíncrono y presenta una hoja de continuación que permite a la persona elegir si la app muestra el enlace de compra externa. Devuelve el control antes de que se presente la hoja y puede lanzar un StoreKitError cuando falta el derecho, no hay ningún enlace configurado para la tienda, la tienda no admite compras externas, la persona no es elegible o se produce un error de red o del sistema. Si la persona elige continuar, StoreKit abre tu URL en el navegador predeterminado y le añade un token de compra externa y el ID de paquete de la app; ese token es la razón de ser del paso de reporte.
Paso 6 — Reporta cada token a través de la External Purchase Server API
La API de servidor de compras externas es una API REST a la que llamas desde tu propio servidor para «informar de los tokens de compra externa y de las transacciones de tus clientes relacionadas con esos tokens». La instrucción no es opcional y no se limita a las ventas completadas: informa de todos los tokens, incluidos los que no dieron lugar a ninguna transacción. En concreto, Apple enumera cuatro casos que requieren cada uno un informe: un token con líneas de detalle cuando un cliente completa una o varias transacciones; un token sin líneas de detalle cuando el cliente no completa ninguna; un token no reconocido, cuando llega una notificación de servidor de App Store para un token del que no tienes registro; y tokens duplicados de ACQUISITION y SERVICES. La autorización utiliza tokens web JSON generados a partir de claves de API que creas en App Store Connect.
Si ya usas App Store Server Notifications V2, el flujo de informes es el lugar natural para conectarlo: la notificación te indica que existe un token, tu tienda registra la transacción y el informe de la API External Purchase Server cierra el ciclo.
Paso 7 — Mantén a la vista el límite de la tienda
Todo lo anterior está delimitado por una frase que se repite en las directrices y en el derecho: los derechos se limitan al iOS o al iPadOS App Store en escaparates concretos, y fuera del escaparate de Estados Unidos la app y sus metadatos no pueden incluir botones, enlaces externos ni otras llamadas a la acción que dirijan a los clientes a mecanismos de compra distintos de la compra dentro de la app. Ese límite se aplica también a los metadatos: una captura de pantalla que muestre un pago externo en un escaparate donde no se permiten enlaces es un riesgo de rechazo, no una decisión de marketing.
Errores que conviene releer
- Los parámetros de consulta están prohibidos. Los parámetros de seguimiento en la URL de destino incumplen las reglas documentadas de URL; el token que añade StoreKit es lo que transporta la atribución.
- La autorización es una capacidad de firma, no un ajuste del servidor. Añadir la clave a
.entitlementssin la capacidad concedida genera un perfil que no puede usarla. - Las URL deben coincidir con el binario en todo momento. Redactar una nueva URL de destino sin una versión publicada es una discrepancia que Apple documenta como requisito, no como preferencia.
- Un enlace por país, salvo que cumplas los requisitos de MultiLink. Un arreglo de cinco URL en una tienda donde solo se permite un enlace es un problema de revisión.
- Las apps solo para EE. UU. no necesitan nada. Si tus fichas son solo para EE. UU., la directriz 3.1.1(a) ya permite el enlace externo; no crees una capacidad de perfil que no necesitas.
Por dónde empezar
Anota tu lista de tiendas, marca cada una como EE. UU., región con derecho, región con enlace de compra personalizado o ninguna, y luego implementa la condición una sola vez: comprueba canOpen (o eligibleURLs para varios enlaces), muestra el control solo cuando devuelva true y deja la compra dentro de la app como ruta predeterminada para todos los demás. La gestión de tokens en tu servidor es lo que decide si la función sigue cumpliendo las políticas después del lanzamiento.
¿Gestionas cuentas de desarrollador a escala? Nosotros nos encargamos de la parte operativa.
Hemos recibido tu mensaje y responderemos en un plazo de 24 horas.
← Volver a editar