Skip to Content
QvaPay API
Mini-apps

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.

Qué puedes hacer

Saber quién es el usuarioCon su permiso recibes su identidad firmada por QvaPay. Sin formularios de registro ni contraseñas. Identidad
CobrarEl 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 appUsa 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:

  1. 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.
  2. Tu servidor (backend). Guarda el app-secret de tu App. Verifica la identidad del usuario, crea las facturas y recibe el webhook de pago.
  3. 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-secret y 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://localhost en 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.

  1. Borrador. La configuras y la pruebas. Solo la ves tú: en el simulador y en tu móvil, como vista previa.
  2. En revisión. La envías desde el panel y QvaPay la revisa.
  3. Publicada. Aparece en el catálogo de mini-apps de la app para todos los usuarios.

Todos los detalles en Publicar.