Guía para Comercios

Integra pagos con QTApp en tu sitio web

Requisitos Previos

Antes de aceptar pagos con QTApp en tu sitio web, completa los siguientes pasos:

1Descarga la App QTApp

iOS

App Store → Buscar "QTApp"

Android

Play Store → Buscar "QTApp"

2Crea tu cuenta y verifica tu identidad

  • Regístrate con tu correo electrónico
  • Completa el proceso de verificación KYC

3Actualiza a nivel Platino

El nivel Platino es requerido para comercios.

Para obtenerlo:

  1. Abre la app QTApp
  2. Ve a Perfil → Nivel de cuenta
  3. Selecciona Actualizar a Platino
  4. Genera una factura de $50 MXN (nos facturas a nosotros)
  5. Una vez procesada, tu cuenta se actualiza a Platino

Crear Botones de Pago (desde la App)

Una vez que eres usuario Platino:

  1. Abre la app QTApp
  2. Ve a Negocio → Botones de Pago Web
  3. Toca + Crear Botón
  4. Configura:
    • Monto: Precio del producto/servicio
    • Descripción: Nombre del producto
    • Referencia: (Opcional) Tu código interno
    • URL de éxito: A dónde redirigir después del pago
  5. Toca Crear
  6. Se genera un código QR y un código de integración

Integración en tu Sitio Web

RECOMENDADOOpción 1: Widget Automático

Copia y pega este código donde quieras mostrar el QR de pago:

<!-- Widget de Pago QTApp -->
<div data-qtapp-payment="TU_CODIGO_AQUI"></div>
<script src="https://js.qtapp.ai/v1/payment-qr.js"></script>

El widget:

  • Muestra el código QR automáticamente
  • Detecta cuando el cliente paga
  • Redirige a tu URL de éxito

Opción 2: Solo Imagen QR

Si prefieres diseño personalizado:

<img src="https://api.qtapp.ai/qtapp/payment-buttons/TU_CODIGO/qr.png"
     alt="Pagar con QTApp">

<!-- Opcional: Polling manual para detectar pago -->
<script>
async function checkPaymentStatus() {
    const response = await fetch(
        'https://api.qtapp.ai/qtapp/payment-buttons/TU_CODIGO/status'
    );
    const data = await response.json();

    if (data.status === 'completed') {
        window.location.href = '/gracias';
    } else {
        setTimeout(checkPaymentStatus, 2000); // Revisar cada 2 segundos
    }
}
checkPaymentStatus();
</script>

Opción 3: Integración Server-Side

Para tiendas con backend propio:

// Crear botón de pago dinámicamente
const response = await fetch('https://api.qtapp.ai/qtapp/payment-buttons', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'X-QTApp-User-Id': 'TU_QTAPP_USER_ID'
    },
    body: JSON.stringify({
        amount: 150.00,
        description: 'Producto XYZ',
        reference: 'ORDER-12345',
        success_redirect_url: 'https://tutienda.com/gracias'
    })
});

const button = await response.json();
// Mostrar button.qr_image_url en tu página

Administrar Pagos Recibidos

Desde la app QTApp:

  1. Ve a Negocio → Historial de Pagos
  2. Verás todos los pagos recibidos via botones web
  3. Filtra por fecha, monto, o referencia
  4. Exporta a CSV si necesitas

Preguntas Frecuentes

¿Cuánto cuesta usar QTApp para pagos?

El comercio no paga comisión. El cliente (pagador) paga $3.99 + IVA = $4.63 MXN por transacción.

¿Cuándo recibo el dinero?

El pago se acredita en tu cuenta QTApp de manera inmediata. Es una transferencia interna entre usuarios QTApp.

¿Los clientes necesitan tener QTApp?

Sí, ambos (comercio y cliente) deben ser usuarios QTApp.

¿Puedo tener múltiples botones de pago?

Sí, puedes crear tantos como necesites (uno por producto, por ejemplo).

¿Los botones expiran?

Por defecto no. Puedes configurar fecha de expiración o límite de usos al crear el botón.

¿Necesitas ayuda?

Nuestro equipo de soporte está disponible para ayudarte con la integración.

Contactar Soporte