Devoria
Guideline 3.1.1: quan és obligatòria la compra integrada
Per Mehdi Azizi
Publicat el , 9 min
Guideline 3.1.1: tot contingut o funció digital que es desbloqueja a l'app passa per la compra integrada d'Apple. Excepcions, regles UE i EUA, solucions.
La guideline 3.1.1 imposa la compra integrada d'Apple tan bon punt la teva app desbloqueja contingut o una funció digital: subscripció, versió completa, moneda de joc, contingut prèmium. Un rebuig 3.1.1 vol dir que Apple ha trobat una altra porta d'entrada cap a aquest contingut: pagament al teu web, clau de llicència, codi propi, botó cap a una pàgina de pagament. La solució passa per la compra integrada, tret que el teu cas entri en una excepció o en una regla regional.
Publico les meves pròpies apps iOS, i les que tenen subscripció la venen amb la compra integrada d'Apple. No he rebut mai un rebuig 3.1.1, i no et diré el contrari. Aquesta guia es basa en el text oficial, en la versió del 8 de juny de 2026 llegida el 15 d'octubre de 2026, i en les condicions regionals publicades per Apple. El cas proper de les subscripcions, amb dos rebuigs reals, és a la guia sobre la guideline 3.1.2.
Què diu la guideline 3.1.1?
La 3.1.1, «In-App Purchase», obre l'apartat 3.1 «Payments» de les App Review Guidelines. D'aquí ve l'assumpte del correu: «Guideline 3.1.1 - Business - Payments - In-App Purchase». La primera frase diu l'essencial: per desbloquejar funcions a la teva app, «you must use in-app purchase», has de fer servir la compra integrada. Apple cita les subscripcions, les monedes de joc, els nivells, el contingut prèmium i la versió completa.
La frase següent apunta a les dreceres. Una app no pot fer servir el seu propi mecanisme per desbloquejar contingut: Apple esmenta les claus de llicència, els marcadors de realitat augmentada, els codis QR, les criptomonedes i els moneders cripto.
La mateixa regla afegeix obligacions que sovint s'obliden:
- els crèdits i les monedes comprats amb compra integrada no caduquen, i tota compra restaurable té un mecanisme de restauració;
- un cofre o un sorteig de pagament («loot box») mostra les probabilitats d'obtenir cada tipus d'objecte abans de la compra;
- una targeta regal, un val o un cupó digital es ven a l'app amb compra integrada; una targeta física enviada per correu pot passar per un altre mitjà;
- una app sense subscripció pot oferir una prova limitada en el temps, en forma de compra integrada gratuïta anomenada «XX-day Trial», que anuncia abans de començar la durada, què es perdrà i què caldrà pagar;
- les propines al desenvolupador són possibles, amb compra integrada.
Les situacions que provoquen un rebuig 3.1.1
| Què fa l'app | Per què Apple ho rebutja | La solució |
|---|---|---|
| Desbloqueja un contingut comprat al teu web | No hi ha compra integrada equivalent | Vendre'l també amb compra integrada |
| Mostra «Paga al nostre web» | Remet a un altre pagament | Treure el botó, tret d'excepció |
| Demana una clau de llicència o un codi propi | Mecanisme de desbloqueig prohibit | Codis d'oferta d'Apple |
| Desbloqueja a canvi d'una criptomoneda | Mecanisme de desbloqueig prohibit | Compra integrada |
| Ven crèdits que caduquen | Obligació de la 3.1.1 | Crèdits permanents i restauració |
| Ven un cofre sense probabilitats | Probabilitats no mostrades | Probabilitats visibles abans de comprar |
La primera fila és la que menys s'entén. En un rebuig publicat als fòrums d'Apple, el missatge diu que l'app «accesses digital content purchased outside the app», accedeix a un contingut comprat en un altre lloc, «but that content isn't available to purchase using in-app purchase». Apple no et retreu tenir un web que ven: et retreu que l'app no ofereixi la mateixa compra a través d'Apple.
Per oferir accés gratuït o un descompte, Apple té el seu propi sistema, els codis d'oferta. Segons la documentació de StoreKit, funcionen per a tots els tipus de compres integrades: subscripcions, consumibles i no consumibles. Els crees a App Store Connect, i l'usuari els introdueix a l'App Store o a la teva app.
Les excepcions: quan no s'exigeix la compra integrada
La regla 3.1.3 enumera les apps que poden fer servir un altre mitjà de pagament. Aquesta és la graella que faig servir per saber on encaixa un projecte.
| El teu cas | S'exigeix compra integrada? | Regla |
|---|---|---|
| Subscripció, versió completa, contingut digital | Sí | 3.1.1 |
| Producte físic, servei consumit fora de l'app | No, altre mitjà obligatori | 3.1.3(e) |
| Classe o consulta en directe, entre dues persones | No | 3.1.3(d) |
| Classe en directe amb diverses persones | Sí | 3.1.3(d) |
| Premsa, llibres, música, vídeo comprats fora | No per accedir-hi | 3.1.3(a) |
| Servei multiplataforma comprat al teu web | Accés permès si també en compra integrada | 3.1.3(b) |
| Eina venuda a una empresa per als seus treballadors | No | 3.1.3(c) |
| App gratuïta complementària d'una eina web, sense compra | No | 3.1.3(f) |
Dos límits. Una app que es beneficia d'una excepció no pot, dins l'app, empènyer cap a un altre mitjà de pagament, fora de la botiga dels Estats Units i dels casos previstos per Apple. En canvi, Apple precisa que «Developers can send communications outside of the app»: pots escriure als teus usuaris fora de l'app, per correu electrònic per exemple.
Les regles per regió a l'octubre de 2026
Aquí els textos canvien de pressa. El que segueix es basa en els d'Apple llegits el 15 d'octubre de 2026: torna-los a llegir abans de programar un pagament extern.
| Regió | Què es permet a més de la compra integrada |
|---|---|
| Estats Units | Botons i enllaços cap a un altre pagament, sense entitlement |
| Unió Europea | Pagament alternatiu a l'app i ofertes fora de l'app, regulats |
| Japó, Brasil, Corea del Sud | Programes propis, amb sol·licitud d'entitlement |
| Altres països | Cap botó, enllaç ni crida cap a un altre pagament |
Estats Units
La regla 3.1.1(a) precisa que els entitlements «are not required for developers to include buttons, external links, or other calls to action in their United States storefront apps». A la botiga dels Estats Units, doncs, es permet un botó cap al teu web. El teu binari és el mateix a tot arreu: si afegeixes aquest botó, l'app ha de saber en quina botiga és l'usuari. StoreKit t'ho dona amb Storefront.
Unió Europea
Des de l'1 d'octubre de 2026 s'apliquen noves condicions, segons la pàgina d'Apple sobre les opcions de pagament a la UE. Pots quedar-te només amb la compra integrada, sense canviar res. També pots oferir un proveïdor de pagament dins l'app, o ofertes fora de l'app, cap al teu web per exemple. En aquest cas, Apple imposa, entre altres coses:
- l'entitlement «StoreKit External Purchases or Offers» i, per a un enllaç o un pagament dins l'app, la finestra d'informació del sistema;
- la compra integrada almenys tan visible com l'altra opció, quan totes dues són a la pantalla;
- cap esment d'aquests pagaments a la teva fitxa de l'App Store;
- un control parental per als menors, i cap oferta fora de l'app abans dels 13 anys, o més segons el país;
- la mateixa elecció a totes les botigues de la UE durant 12 mesos.
S'apliquen comissions segons l'opció triada. Llegeix-ne la secció a la mateixa pàgina abans de decidir.
Els altres països
A la resta, la regla continua sent estricta: «apps and their metadata may not include buttons, external links, or other calls to action» cap a un altre mitjà de pagament. La paraula «metadata» és important: una descripció que anuncia «més barat al nostre web» també cau dins la regla. Alguns països, entre ells el Japó, el Brasil i Corea del Sud, tenen programes propis, recollits a la documentació External Purchase.
Corregir un rebuig 3.1.1 i respondre a Apple
- Localitza la porta d'entrada. El missatge cita el contingut o la pantalla en qüestió: contingut comprat fora, botó, codi, enllaç.
- Tanca-la o duplica-la. O treus el botó o el codi, o vens el mateix contingut amb compra integrada.
- Invoca una excepció només si és real. Cita l'apartat de la 3.1.3 i explica en dues frases per què el teu cas hi encaixa.
- Dona al revisor amb què provar-ho. Un compte de demo i el camí fins al paywall, a les notes de revisió, com explico a la guia sobre la guideline 2.1.
Respons a la secció App Review d'App Store Connect, seguint el procediment per respondre a App Review. Aquí tens una plantilla per al cas més habitual, un contingut comprat al web. És un exemple: substitueix el build, el producte i el recorregut pels teus.
Hello,
Thank you for your review.
Issue: the app gave access to premium content purchased on our
website, without offering the same purchase in the app.
Fix in build X:
- Premium access is now available as an auto-renewable
subscription through in-app purchase, on the paywall.
- The "Subscribe on our website" button has been removed.
- A "Restore Purchases" button is available on the paywall.
How to verify: launch the app and open any premium screen.
The paywall shows the in-app purchase options.
Best regards,
El botó i el paywall són al codi: cal un build nou. Si continues convençut que el teu cas és una excepció, Apple també permet apel·lar a l'App Review Board.
Connectar la compra integrada sense reescriure-ho tot
Per a un principiant, el camí més senzill és crear els productes a App Store Connect i després connectar-los a l'app amb RevenueCat: la recepta és a RevenueCat: configurar una subscripció in-app. Si dubtes entre els dos models, llegeix subscripció o compra única. Si construeixes amb una eina sense codi, comprova que sap gestionar la compra integrada: és un dels punts de crear una aplicació sense programar.
Tan bon punt la teva compra integrada és una subscripció, s'hi afegeix la 3.1.2: import facturat ben visible, durada, renovació, enllaços. Els errors de pantalla més freqüents són a paywall iOS: 7 errors de principiant.
La checklist 3.1.1 abans d'enviar
- Tot el que es desbloqueja a l'app (funció, contingut, nivell, moneda) es compra amb compra integrada.
- Cap botó, enllaç ni text remet a un pagament extern, tret de la botiga dels Estats Units o d'un programa regional obtingut.
- La descripció de la teva fitxa no esmenta cap altre mitjà de pagament.
- Un contingut venut al teu web també es ven amb compra integrada dins l'app.
- Cap clau de llicència, codi QR, codi propi o cripto desbloqueja res.
- Per oferir accés, fas servir els codis d'oferta d'Apple.
- Els crèdits comprats no caduquen, i un botó «Restore Purchases» funciona.
- Cada cofre o sorteig de pagament mostra les probabilitats abans de la compra.
- Un producte físic o un servei fora de l'app passa per Apple Pay o una targeta, no per la compra integrada.
- Les teves notes de revisió diuen on trobar les compres i, si invoques una excepció, quina.
Revisar la teva app abans d'enviar-la
Si la teva app acaba de ser rebutjada per la 3.1.1, l'Apple Review Kit t'ajuda a trobar la regla citada, què demana, i un exemple de correcció i de resposta. Les seves notes per al revisor cobreixen la compra integrada. Si vols una mirada humana, reserva una hora amb mi: llegim el missatge d'Apple i busquem la porta d'entrada que ha vist. El procés complet és a la pàgina aplicació rebutjada per Apple, i la configuració de la compra a la pàgina subscripció in-app iOS.
Si prepares el teu primer llançament, fes el teu diagnòstic gratuït: posa els passos en ordre i t'envia la meva checklist antirebuig d'Apple. Per crear una aplicació mòbil que vengui amb compra integrada des del primer dia, l'iOS Kit parteix d'un codi on el paywall i les subscripcions ja estan fets.
Ningú no pot garantir que Apple acceptarà la teva app. El que sí que puc fer és ajudar-te a triar el mitjà de pagament adequat abans d'escriure el codi.
Preguntes freqüents
Què vol dir «Guideline 3.1.1 - Business - Payments - In-App Purchase»?
És el títol complet de la regla sobre la compra integrada al missatge d'Apple. Indica que la teva app dona accés a un contingut o a una funció digital per un camí que no és la compra integrada: pagament en un web, codi, clau de llicència o enllaç cap a una pàgina de pagament.
Puc posar un enllaç al meu web per pagar menys?
A la botiga dels Estats Units, sí: la regla permet botons i enllaços sense entitlement. A la Unió Europea, és possible amb l'entitlement d'Apple i les seves condicions. A la resta, tret d'un programa regional, ni l'app ni la seva fitxa poden remetre a un altre mitjà de pagament.
Puc desbloquejar la meva app amb un codi promocional?
No amb un codi propi: la 3.1.1 prohibeix els mecanismes de desbloqueig propis de l'app, com les claus de llicència. Fes servir els codis d'oferta d'Apple, creats a App Store Connect. Funcionen per a les subscripcions i per als altres tipus de compres integrades.
Cal la compra integrada per vendre un producte físic o un servei?
No. Un producte físic o un servei consumit fora de l'app, com un àpat a domicili o un trajecte, ha de passar per un altre mitjà de pagament, Apple Pay o targeta bancària. Una classe en directe entre dues persones també se'n pot estalviar, però no una classe en directe amb diverses persones.
Un client subscrit al meu web pot iniciar sessió a l'app?
Sí per a un servei multiplataforma, sempre que el mateix accés també es vengui amb compra integrada dins l'app. És la regla 3.1.3(b). Sense aquesta oferta a l'app, tornes al rebuig 3.1.1 típic: un contingut comprat fora i impossible de comprar a través d'Apple.
N'hi ha prou amb RevenueCat per complir la 3.1.1?
RevenueCat es basa en la compra integrada d'Apple, així que no crea cap problema 3.1.1. Però no treu un botó de pagament extern o un codi propi que la teva app pugui contenir. El compliment s'ha de revisar pantalla per pantalla, i també a la teva fitxa.
