Publicar
Del borrador al catálogo de la app: estados, lista de requisitos, revisión, conversación con QvaPay y límites.
Estados
| Estado | Quién la ve | Puedes editarla |
|---|---|---|
| Borrador | Solo tú (simulador y vista previa en tu móvil) | Sí |
| En revisión | Solo tú | No. Retírala de la revisión para volver a borrador |
| Publicada | Todos los usuarios de la app | No. Los cambios se piden en la conversación |
| Suspendida | Nadie | No. El motivo aparece en la conversación |
Todo se gestiona desde tu App en el panel de desarrollador, sección Mini-app.
Lista para publicar
El botón Enviar a revisión se activa cuando todo está en verde:
- Tu cuenta tiene el KYC aprobado y no tiene restricciones.
- La App está activa y habilitada.
- La mini-app tiene slug, nombre y URL de entrada.
- Tiene icono (cuadrado, 256 px o más) y descripción corta.
- La App tiene un callback https para el webhook de pago. Si el punto sigue en rojo con una URL que parece correcta, la que guardaste tiene espacios al principio o al final: edítala en los datos de la App y guárdala de nuevo (al guardar se limpia).
Portada (opcional)
Las mini-apps destacadas salen arriba del catálogo en una tarjeta grande. Si tu mini-app tiene portada, esa imagen es el fondo de la tarjeta. Si no, la tarjeta usa el color de su categoría.
- Horizontal, 16:9, de 1280 × 720 px o más. JPG, PNG o WebP (SVG no).
- La parte de abajo lleva un velo oscuro con tu icono, el nombre y la descripción encima. Deja lo importante de la imagen en la mitad de arriba y no metas texto en ella.
- También puede ser la imagen del anuncio en el canal de Telegram de QvaPay cuando la publiquemos.
- No cuenta para la lista de publicación. Destacar una mini-app lo decide QvaPay, pero la portada puedes dejarla puesta desde el primer día.
Qué revisamos
- Que funcione en un móvil real: carga, login y un cobro de prueba.
- Que pida solo los datos que necesita y explique para qué.
- Que se integre con la app: usa la barra superior de QvaPay (subtítulo y acciones) en vez de pintar una propia que la duplique.
- Que confirme los pagos con el webhook, no con el frontend.
- Que el contenido y la actividad cumplan los términos de uso de QvaPay. No se aceptan juegos de azar con dinero, rifas o loterías pagadas, ni actividades que requieran licencias que no tengas. (QvaPay puede operar productos propios aprobados por su área de cumplimiento, como QvaPulso, un mercado de predicciones sobre eventos sin sorteo; esa excepción no aplica a mini-apps de terceros.)
- Que no se haga pasar por QvaPay. Los dominios de QvaPay no se aceptan como origen.
Al enviarla puedes dejar una nota para la revisión: qué cambiaste desde la última vez o qué necesitamos para probarla.
Verás el resultado en tu panel: Publicada, o de vuelta en Borrador si hay que cambiar algo. En ese caso el motivo aparece en la sección Mini-app de tu App y te llega también por notificación, por Telegram y por correo. Al publicarla recibes un correo con todo lo que tu mini-app puede hacer desde ese momento. Corrígela y vuelve a enviarla.
La identidad de revisión
Para probarla, QvaPay abre tu mini-app en un emulador con el mismo puente que el simulador (sdk-sim.js). Si tu página lo carga, el login funciona allí y tu servidor recibe un init_data real, firmado con el secret de tu App, pero con una identidad de revisión:
{ "uuid": "<uuid aleatorio, sin cuenta en QvaPay>", "username": "revision_qvapay", "name": "Revisión", "lastname": "QvaPay" }Trátala como a cualquier usuario. En la revisión solo se pagan facturas de prueba: una factura real se enseña, pero no se cobra.
Conversación con QvaPay
La pestaña Conversación de la sección Mini-app guarda todo lo que pasa con tu mini-app: lo que decidimos (publicarla, pedir cambios, suspenderla), lo que hiciste tú (enviarla a revisión, retirarla) y los mensajes de los dos lados.
- Nosotros te escribimos ahí cuando necesitamos algo sin decidir todavía: una pregunta sobre cómo funciona, una cuenta de prueba, un cambio en una mini-app ya publicada. El estado no cambia. Te avisamos por notificación, por Telegram y por correo.
- Tú respondes ahí, en cualquier estado: a un rechazo, a una suspensión o para pedir un cambio en tu mini-app publicada. Le llega al equipo que revisa.
- Mensajes de hasta 1.000 caracteres, y como mucho 5 seguidos cada 10 minutos.
También por API, con tu token de usuario (Authorization: Bearer, el de tu cuenta, no las credenciales de la App): GET https://api.qvapay.com/app/{uuid}/miniapp devuelve la conversación en thread (del más antiguo al más reciente) y waiting_on: "developer" cuando esperamos tu respuesta. Para responder:
POST https://api.qvapay.com/app/{uuid}/miniapp/messages
Authorization: Bearer <tu token>
Content-Type: application/json
{ "message": "Listo: el login ya usa el SDK de QvaPay." }Responde 201 con el mensaje guardado, 400 si va vacío y 429 si envías demasiados seguidos.
Una vez publicada
- Tu enlace. Tu mini-app tiene página pública en
https://www.qvapay.com/apps/<slug>: ficha, enlace de descarga y apertura directa dentro de la app. Es lo que comparten los usuarios desde la app y lo que puedes compartir tú conQvaPay.share(). - Anuncio en el canal. Cuando publicamos tu mini-app, podemos anunciarla en el canal de Telegram de QvaPay (@qvapay) con su nombre, su descripción corta, el enlace a su página pública y una imagen: tu portada, si la tienes, o una ilustración. Lo revisa una persona del equipo antes de salir. Si la mini-app se suspende, el anuncio se retira del canal.
- El slug es permanente. Una vez publicada, el slug no se puede cambiar: es su URL pública.
- Límites de cobro. Hay un máximo por pago y un máximo por usuario en 24 horas para los pagos desde mini-apps. Si tu caso necesita más, escríbenos.
- Controles de cumplimiento. Cada cobro pasa los mismos controles que una transferencia entre usuarios (sanciones, Travel Rule, certificación OFAC cuando aplica). Un rechazo llega a tu frontend como
FAILED. - Tu cuenta debe seguir en regla. Si tu cuenta pierde el KYC o queda restringida, tus cobros se rechazan (
FAILED) hasta resolverlo. - Cambios. Para cambiar la URL, los orígenes o los datos que pides de una mini-app publicada, pídelo en la Conversación de tu mini-app.
- Suspensión. QvaPay puede suspender una mini-app que incumpla las reglas o ponga en riesgo a los usuarios.