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