E-Commerce Guide

Integrate QTApp payments on your website

Prerequisites

Before accepting QTApp payments on your website, complete the following steps:

1Download the QTApp App

iOS

App Store → Search "QTApp"

Android

Play Store → Search "QTApp"

2Create your account and verify your identity

  • Sign up with your email
  • Complete the KYC verification process

3Upgrade to Platinum level

Platinum level is required for merchants.

To get it:

  1. Open the QTApp app
  2. Go to Profile → Account level
  3. Select Upgrade to Platinum
  4. Issue a $50 MXN invoice to us
  5. Once processed, your account becomes Platinum

Create Payment Buttons (from the App)

Once you are a Platinum user:

  1. Open the QTApp app
  2. Go to Business → Web Payment Buttons
  3. Tap + Create Button
  4. Configure:
    • Amount: Product/service price
    • Description: Product name
    • Reference: (Optional) Your internal code
    • Success URL: Where to redirect after payment
  5. Tap Create
  6. A QR code and integration snippet are generated

Integration on your Website

RECOMMENDEDOption 1: Automatic Widget

Copy and paste this code wherever you want to show the payment QR:

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

The widget:

  • Shows the QR code automatically
  • Detects when the customer pays
  • Redirects to your success URL

Option 2: QR Image Only

If you prefer a custom design:

<img src="https://api.qtapp.ai/qtapp/payment-buttons/YOUR_CODE/qr.png"
     alt="Pay with QTApp">

<!-- Optional: manual polling to detect payment -->
<script>
async function checkPaymentStatus() {
    const response = await fetch(
        'https://api.qtapp.ai/qtapp/payment-buttons/YOUR_CODE/status'
    );
    const data = await response.json();

    if (data.status === 'completed') {
        window.location.href = '/thanks';
    } else {
        setTimeout(checkPaymentStatus, 2000); // Check every 2 seconds
    }
}
checkPaymentStatus();
</script>

Option 3: Server-Side Integration

For stores with their own backend:

// Create a payment button dynamically
const response = await fetch('https://api.qtapp.ai/qtapp/payment-buttons', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'X-QTApp-User-Id': 'YOUR_QTAPP_USER_ID'
    },
    body: JSON.stringify({
        amount: 150.00,
        description: 'Product XYZ',
        reference: 'ORDER-12345',
        success_redirect_url: 'https://yourstore.com/thanks'
    })
});

const button = await response.json();
// Render button.qr_image_url on your page

Manage Received Payments

From the QTApp app:

  1. Go to Business → Payment History
  2. You'll see all payments received via web buttons
  3. Filter by date, amount, or reference
  4. Export to CSV if needed

Frequently Asked Questions

How much does it cost to use QTApp for payments?

The merchant pays no commission. The customer (payer) pays $3.99 + VAT = $4.63 MXN per transaction.

When do I receive the money?

The payment is credited to your QTApp account immediately. It's an internal transfer between QTApp users.

Do customers need to have QTApp?

Yes, both (merchant and customer) must be QTApp users.

Can I have multiple payment buttons?

Yes, you can create as many as you need (one per product, for example).

Do buttons expire?

By default, no. You can set an expiration date or usage limit when creating the button.

Need help?

Our support team is available to help you with the integration.

Contact Support