Crea apps de subscripció més ràpidament
Aquesta guia està pensada per a equips que han de posar en marxa compres integrades i subscripcions sense haver de gestionar directament cada detall de StoreKit o Google Play Billing.
La idea central és separar el treball de producte —definir què es ven i qui hi té accés— del treball de plataforma —obtenir ofertes, cobrar i comprovar drets— i fer-ho amb eines pensades per depurar i mantenir en producció.
Com funciona, pas a pas
Abans de tocar codi, convé deixar clar el mapa de decisions. Primer, els productes de la botiga s'associen a ofertes i paquets visibles per a l'usuari. Després, l'aplicació connecta l'SDK de compres i demana l'oferta vigent. Finalment, després de la compra, es desbloqueja el contingut només si el dret corresponent és actiu. Aquesta separació evita barrejar preus de botiga, presentació de paquets i lògica d'accés.
Tres accions, tres comprovacions
La integració es presenta com un SDK de compres anomenat Purchases, amb suport per a les plataformes i frameworks principals. A la pràctica, el flux es divideix en tres comprovacions: obtenir les ofertes disponibles, executar la compra d'un paquet i consultar la informació del client per saber si un dret concret és actiu. Els tres exemples de codi protegits que acompanyen aquesta pàgina —code0001 per obtenir ofertes, code0002 per fer compres i code0003 per comprovar l'estat de la subscripció— corresponen exactament a aquestes tres accions i s'han de consultar en el seu context original abans d'adoptar-los.
Depurar sense anar a cegues
Quan una compra falla, la pregunta útil no és només si hi ha hagut un error, sinó en quin pas s'ha aturat el flux. Per això la proposta inclou proves en entorns de proves, registres detallats i eines de depuració en temps real: permeten seguir què passa amb una compra o una subscripció en cada etapa. Una llista de comprovació mínima abans de publicar seria: verificar que l'oferta actual es carrega en un entorn de proves, confirmar que la compra retorna informació del client, comprovar que el dret esperat apareix com a actiu i revisar els registres si alguna d'aquestes passes no es compleix.
Quan cal el servidor: API i webhooks
Per a fluxos de backend, la peça complementària és una API REST amb accés complet a les dades de subscripció i webhooks per a esdeveniments en temps real. Això permet construir integracions personalitzades i automatitzacions sense dependre només del que es veu a l'aplicació. La distinció és important: l'SDK respon a la pregunta «aquest usuari té accés ara?», mentre que l'API i els webhooks responen a «què ha passat i què haig de fer al meu servidor?».
Ajuda, comunitat i novetats
A més de la documentació tècnica, hi ha tres vies de suport diferenciades: un fòrum per fer preguntes i trobar respostes, una comunitat per compartir idees amb altres desenvolupadors i una secció de novetats per seguir funcions i actualitzacions. Convén triar-les segons el tipus de problema: dubte d'integració, discussió de disseny o canvi recent en una funció.
Per on començar
El punt de partida proposat és començar gratis i llegir la documentació abans d'integrar res. Si l'objectiu és avaluar l'encaix, el primer experiment útil és reduït: configurar un producte, connectar l'SDK en un entorn de proves i comprovar un dret actiu després d'una compra simulada. Només quan aquest recorregut funciona té sentit ampliar a API, webhooks i automatitzacions.
| Pregunta | Eina adequada | Què confirma |
|---|---|---|
| Quines ofertes veu l'usuari? | SDK: obtenir ofertes (code0001) | Paquets disponibles de l'oferta actual |
| S'ha completat la compra? | SDK: fer compres (code0002) | Transacció i informació del client |
| L'usuari té accés al contingut pro? | SDK: comprovar estat (code0003) | Si el dret concret és actiu |
| Què ha passat al backend? | API REST i webhooks | Esdeveniments de subscripció en temps real |
| Per què ha fallat una compra? | Entorns de proves i registres | Pas exacte del flux on s'ha aturat |
Mapa orientatiu a partir de les funcions descrites en el contingut d'origen; no substitueix la documentació oficial.