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 | Tema claro u oscuro, botón principal, botón atrás, 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 existen dentro de las apps móviles de QvaPay (Android e iOS). En qvapay.com no aparecen en ningún catálogo. Para desarrollar tienes el simulador del panel de desarrollador, que reproduce la app en tu navegador.
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.