Mini-apps
Tu web dentro de la app de QvaPay, con login del usuario y cobros con su saldo en un toque.
Una mini-app es tu propia web (tu dominio, tu servidor, tu código) que la app móvil de QvaPay abre a pantalla completa. Tus usuarios no instalan nada ni crean otra cuenta: entran con su cuenta de QvaPay y pagan con su saldo sin salir de tu mini-app.
Inicio rápido
Tu primera mini-app funcionando en el simulador en unos 15 minutos.
Probar sin dinero real
Simulador en el panel de desarrollador, facturas de prueba y vista previa en tu móvil.
Qué puedes hacer
| Saber quién es el usuario | Con su permiso recibes su identidad firmada por QvaPay. Sin formularios de registro ni contraseñas. Identidad |
| Cobrar | El usuario paga una factura de tu App con su saldo y confirma con su PIN. Tú te enteras por webhook. Cobros |
| Verse como parte de la app | Usa la barra superior de QvaPay en vez de una propia, con tu subtítulo y tus botones. Además: tema claro u oscuro, botón principal, botón atrás automático, vibración y avisos nativos. SDK |
Cómo funciona, en 30 segundos
Hay tres piezas y cada una tiene un trabajo:
- Tu web (frontend). Se abre dentro de la app. Usa el objeto
window.QvaPay, que la app inyecta, para pedir el login o un pago. - Tu servidor (backend). Guarda el
app-secretde tu App. Verifica la identidad del usuario, crea las facturas y recibe el webhook de pago. - QvaPay. Muestra las pantallas de permiso y de pago, cobra al usuario y te avisa.
Tu frontend solo sirve para la interfaz. Nunca entregues un producto porque el frontend dice "pagado": confírmalo en tu servidor con el webhook firmado. Y el app-secret vive solo en tu servidor, nunca en el JavaScript de la mini-app.
Antes de empezar
- Una cuenta de QvaPay con la verificación de identidad (KYC) aprobada. Es la cuenta que cobra.
- Una App creada en el panel de desarrollador. Cada mini-app pertenece a una App: usa su
app-secrety sus facturas. Si ya integraste la API de comercios, puedes usar esa misma App. - Un dominio con https para tu web. Mientras desarrollas te vale
http://localhosten el simulador.
Dónde se ven
Las mini-apps solo se usan dentro de las apps móviles de QvaPay (Android e iOS). En qvapay.com no hay catálogo, pero cada mini-app publicada tiene una página pública compartible en https://www.qvapay.com/apps/<slug> que la abre en la app (o lleva a descargarla). Para desarrollar tienes el simulador del panel de desarrollador, que reproduce la app en tu navegador. La app móvil arma su pantalla con la API del catálogo, que lista las publicadas con las destacadas primero.
Del código al catálogo
- Borrador. La configuras y la pruebas. Solo la ves tú: en el simulador y en tu móvil, como vista previa.
- En revisión. La envías desde el panel y QvaPay la revisa.
- Publicada. Aparece en el catálogo de mini-apps de la app para todos los usuarios.
Todos los detalles en Publicar.