Quick start
Accept your first USDT payment in five minutes.
This guide takes you from a new account to a confirmed test payment.
1. Create a store
In the dashboard open Stores → New store. Choose a payment mode:
- xPub mode (recommended) – paste your account-level extended public key. A fresh address is derived for every invoice.
- Static address mode – paste one receiving address. Each invoice gets a unique amount (for example 25.000317) so payments can be told apart.
Never paste a private key or seed phrase. The platform is non-custodial and will refuse them.
2. Create an API key
Open API keys, create a test key and copy the secret (it is shown only once).
3. Create an invoice
curl -X POST https://pay-test.qanawat.store/api/v1/invoices \
-H "Authorization: Bearer sk_test_your_secret_key" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-1001" \
-d '{
"amount": "25.00",
"currency": "USDT",
"network": "trc20",
"order_id": "1001",
"description": "Order #1001",
"success_url": "https://shop.example.com/thanks",
"cancel_url": "https://shop.example.com/cart",
"metadata": {"customer_id": "42"},
"lang": "en"
}'<?php
require 'PaymentGateway.php';
$gateway = new PaymentGateway('sk_test_your_secret_key', 'https://pay-test.qanawat.store');
$invoice = $gateway->createInvoice([
'amount' => '25.00',
'currency' => 'USDT',
'network' => 'trc20',
'order_id' => '1001',
'success_url' => 'https://shop.example.com/thanks',
'cancel_url' => 'https://shop.example.com/cart',
], 'order-1001');
header('Location: ' . $invoice['checkout_url']);const res = await fetch('https://pay-test.qanawat.store/api/v1/invoices', {
method: 'POST',
headers: {
'Authorization': 'Bearer sk_test_your_secret_key',
'Content-Type': 'application/json',
'Idempotency-Key': 'order-1001',
},
body: JSON.stringify({
amount: '25.00',
currency: 'USDT',
network: 'trc20',
order_id: '1001',
success_url: 'https://shop.example.com/thanks',
}),
});
const invoice = await res.json();
console.log(invoice.checkout_url);Redirect your customer to checkout_url. The hosted checkout shows the amount, address, QR code and a live status.
4. Receive the webhook
Add a webhook endpoint to your store. When the payment is confirmed you receive an invoice.confirmed event signed with your webhook secret. See Webhooks.
5. Go live
Switch to a live API key. Nothing else changes.
Need help? Contact us
Last updated: Nov 17, 2026