Tu tienda dentro de QvaPay: crea tu App y tu Mini-app paso a paso

Mucha gente en Cuba ya tiene saldo en QvaPay y lo usa todos los días. Si tu negocio cobra por ahí, tiene sentido que el cliente pueda pagarte sin salir de QvaPay y que el dinero llegue directo a tu cuenta.

Para eso, en KonectaAI cada negocio tiene dos piezas propias: su App y su Mini-app de QvaPay. Suenan técnicas, pero la idea es sencilla. Aquí te explicamos qué es cada una, por qué son obligatorias y cómo crearlas paso a paso.

Qué es cada cosa

Tu App de QvaPay es como una «caja registradora» conectada a tu cuenta. Le permite a tu tienda crear cobros (facturas) a tu nombre y recibir un aviso automático cuando el cliente paga. El dinero entra en tu cuenta de QvaPay, no en la de nadie más.

Tu Mini-app es tu tienda abierta dentro de la aplicación de QvaPay. El cliente entra desde QvaPay, mira tus productos y paga con su saldo en un toque, sin copiar números de cuenta ni mandar capturas.

KonectaAI también tiene su propia mini-app, A Konectar: un directorio donde los clientes encuentran tiendas de negocios cubanos. Tu Mini-app es la puerta directa a tu tienda; A Konectar es el escaparate donde también te pueden descubrir.

Por qué tu App es obligatoria

Porque así el dinero es tuyo desde el primer segundo:

• Pagos con saldo QvaPay: directo a tu cuenta. La factura se crea con tu App y el cobro entra en tu cuenta de QvaPay. KonectaAI no toca ese dinero ni cobra comisión por él.
• Sin tu App conectada, tu tienda no ofrece pago con saldo QvaPay. Es la forma de asegurar que nadie cobra en tu nombre.
• PayPal y tarjeta van por otro camino. Esos pagos pasan por la App de KonectaAI, que los recibe y te liquida el neto en tu cuenta de QvaPay. Ahí sí se aplica la comisión de tu plan (los planes altos la eliminan), además de la comisión que cobra QvaPay por PayPal y tarjeta. Te lo explicamos en Cobrar en Cuba sin enredos.

Antes de empezar

Ten esto listo para no quedarte a mitad de camino:

• Cuenta de QvaPay verificada (KYC aprobado) y sin restricciones. QvaPay lo exige para crear aplicaciones.
• Tu tienda publicada en KonectaAI. Su enlace tiene la forma https://tu-negocio.konectaai.com.
• Tu logo cuadrado de al menos 512 px, en PNG o JPG, con fondo sólido.
• Para la Mini-app, una portada horizontal (16:9) de al menos 1280 × 720 px.
• Una descripción corta de tu negocio. Ojo con los límites: la de la App admite hasta 191 caracteres y la de la Mini-app hasta 140.

Paso a paso: crea tu App

1. Entra en el panel de desarrolladores de QvaPay: qvapay.com/dev/app y pulsa «Crear aplicación».
2. Nombre: el de tu negocio, tal como quieres que lo vean tus clientes.
3. URL: el enlace de tu tienda.
4. Logo: sube tu logo cuadrado.
5. Descripción: una frase clara de lo que vendes. Por ejemplo: «Ropa y accesorios en La Habana. Entregas a domicilio».
6. Webhook, URL de éxito y URL de cancelación: copia los valores exactos que te muestra KonectaAI en Ajustes → QvaPay. El webhook es la dirección donde QvaPay avisa a tu tienda de que un pago se completó.
7. Guarda la aplicación.

Al guardar, QvaPay te da dos datos: el identificador de la App (app-id) y la clave secreta (app-secret).

La clave secreta se muestra una sola vez. Cópiala en ese momento y pégala directamente en KonectaAI. No la mandes por chat ni la guardes en una nota del teléfono.

Los permisos avanzados: déjalos apagados

En la pestaña de permisos avanzados verás opciones como transferencias, compra y venta en el P2P o retiros. Para cobrar en tu tienda no necesitas ninguna. Déjalas todas desactivadas.

¿Por qué? Porque con esos permisos encendidos, quien tenga tu clave secreta podría mover tu dinero. Con todo apagado, la App solo sirve para lo que quieres: crear cobros y recibir avisos de pago.

Conecta la App con tu tienda

Vuelve a KonectaAI, entra en Ajustes → QvaPay y pega el app-id y la clave secreta. KonectaAI los guarda cifrados y comprueba que funcionan. Desde ese momento, cuando un cliente pague, el pedido se marca como pagado solo cuando llega el aviso firmado de QvaPay. Nadie puede «marcar pagado» un pedido con una captura falsa.

Haz una prueba con un importe pequeño antes de anunciarlo a tus clientes.

Paso a paso: crea tu Mini-app

Con la App ya funcionando, abre tu tienda dentro de QvaPay.

1. En el panel de tu App, entra en la pestaña Mini-app → Configuración.
2. Slug: el nombre corto de tu Mini-app, sin espacios (por ejemplo, labodegadeana). Piénsalo bien: no se puede cambiar después de publicarla.
3. Nombre y descripción corta: el nombre de tu negocio y una frase de hasta 140 caracteres.
4. Icono: cuadrado, de al menos 256 px, en una dirección https. Puedes usar el mismo logo que subiste a KonectaAI.
5. Portada: tu imagen 16:9.
6. Categoría: la que mejor encaje (por ejemplo, Compras).
7. URL de entrada y orígenes permitidos: copia los que te da KonectaAI en Ajustes → QvaPay. Son las direcciones de tu tienda en modo mini-app.
8. Datos que pedirás: marca solo Perfil. Con eso QvaPay le dice a tu tienda quién está comprando, sin pedir documentos extra.

Prueba y pide la revisión

Antes de publicar, QvaPay te da herramientas para probar:

• Simulador: abre tu tienda como si fueras un cliente y haz un pago de prueba pequeño.
• Testers: añade tu cuenta y la de alguien de confianza para probar desde teléfonos reales.
• Revisión: escribe un mensaje corto explicando qué vende tu tienda y cómo se compra. QvaPay revisa la Mini-app antes de que salga al público.

Mientras esperas la revisión, tu tienda online y los cobros con tu App siguen funcionando normal.

Errores comunes (y cómo evitarlos)

• Perder la clave secreta. Si no la copiaste, genera una nueva y vuelve a pegarla en KonectaAI.
• Logo que no carga. QvaPay rechaza iconos cuya dirección no responde. Comprueba que la imagen se ve antes de pegarla.
• Slug con prisa. Como no se puede cambiar, evita nombres temporales o con faltas de ortografía.
• Encender permisos «por si acaso». No hacen falta para vender. Apagados estás más seguro.
• No probar. Un pago de prueba de pocos centavos te ahorra un mal rato con un cliente real.

Resumen

1. Verifica tu cuenta de QvaPay y publica tu tienda en KonectaAI.
2. Crea tu App con los datos de Ajustes → QvaPay y deja los permisos avanzados apagados.
3. Pega el app-id y la clave secreta en KonectaAI y haz un pago de prueba.
4. Configura tu Mini-app, pruébala en el simulador y pide la revisión.

Con esto, el saldo QvaPay que te pagan entra directo en tu cuenta, el cliente paga en un toque y los pedidos se confirman solos cuando llega el pago. Tú solo te ocupas de preparar y entregar.