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:
- Open the QTApp app
- Go to Profile → Account level
- Select Upgrade to Platinum
- Issue a $50 MXN invoice to us
- Once processed, your account becomes Platinum
Create Payment Buttons (from the App)
Once you are a Platinum user:
- Open the QTApp app
- Go to Business → Web Payment Buttons
- Tap + Create Button
- Configure:
- Amount: Product/service price
- Description: Product name
- Reference: (Optional) Your internal code
- Success URL: Where to redirect after payment
- Tap Create
- 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 pageManage Received Payments
From the QTApp app:
- Go to Business → Payment History
- You'll see all payments received via web buttons
- Filter by date, amount, or reference
- 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