API del historial de compras In-App
Lea las compras In-App anteriores del usuario desde su aplicación web como JSON, perfecto para páginas de «Mis compras».
La API del historial de compras In-App devuelve la lista de compras anteriores del usuario realizadas mediante la API de compras In-App en este dispositivo y la inyecta en su aplicación web como window.purchaseHistory. Asegúrese de poseer una Extended License de WebViewGold si planea usar esta función en un producto final.
Cómo usarla:
<a href="getpurchasehistory://" onclick="setTimeout(renderHistory, 300)">Mis compras</a>
<script>
function renderHistory() {
const data = window.purchaseHistory;
if (!data) return;
data.purchases.forEach(function (p) {
console.log(p.productId, p.transactionId, p.purchaseDateMs);
});
}
</script>
Formato de los datos:
{
"purchases": [
{
"productId": "com.example.premium",
"transactionId": "2000000123456789",
"purchaseDateMs": "1721600000000"
}
]
}
purchaseDateMs es la marca de tiempo de la compra en milisegundos Unix (como cadena).
Casos de uso típicos:
- Mostrar una página «Mis suscripciones» o «Mis compras» dentro de su aplicación web.
- Desbloquear contenido premium en el cliente basándose en compras anteriores sin consultar su backend.
- Flujos de depuración y de atención al cliente.
Notas: La lista contiene las compras realizadas dentro de la aplicación en este dispositivo. Se almacena localmente, por lo que no se sincroniza entre dispositivos; para comprobar derechos entre dispositivos, valide los recibos en su servidor.
Notas de implementación estilo SDK
Trate esta función como una capacidad nativa expuesta a su capa web: mantenga su sitio web de producción o PWA como fuente de verdad y, a continuación, utilice los indicadores de configuración de WebViewGold, los comandos de URL y las llamadas del puente de JavaScript documentados para activar el comportamiento nativo de iOS solo donde aporte valor. Este enfoque mantiene su código fácil de mantener, porque la misma aplicación web puede servir a los navegadores, a WebViewGold para iOS y a las demás plataformas de WebViewGold con una lógica condicional mínima.
Para obtener resultados fiables, opte por puntos de conexión HTTPS, nombres de ruta estables, estados de éxito/error explícitos en su interfaz y pequeñas funciones auxiliares de JavaScript que envuelvan las llamadas nativas. Por ejemplo, una aplicación web creada con jQuery Mobile, Lovable, Base44, Bolt, WordPress, Bubble, una pila propia de React/Vue/Angular o HTML estático puede exponer un único botón o controlador de eventos que active la API nativa de WebViewGold y, aun así, muestre una alternativa elegante en el navegador.
- Patrón de integración recomendado: detecte el contexto de la app, llame a la API de WebViewGold y luego actualice su interfaz web tras la devolución de llamada nativa o el cambio de ruta.
- Lista de comprobación de pruebas: valide la función en un dispositivo real o en una compilación empaquetada, verifique los permisos y el texto de revisión de la tienda, y confirme que los usuarios que solo usan el navegador siguen recibiendo una alternativa útil.
- Ventaja para el SEO: mantenga las páginas de funciones, los títulos de ruta y el contenido estructurado indexables en su sitio web, mientras WebViewGold ofrece la carcasa nativa de la app para los usuarios de iOS.