البدء السريع

استقبل أول دفعة USDT خلال خمس دقائق.

يأخذك هذا الدليل من إنشاء الحساب وحتى إتمام دفعة تجريبية مؤكدة.

1. أنشئ متجراً

من لوحة التحكم افتح المتاجر ← متجر جديد واختر طريقة الدفع:

  • وضع xPub (موصى به) – الصق المفتاح العام الموسّع على مستوى الحساب. يتم توليد عنوان جديد لكل فاتورة.
  • وضع العنوان الثابت – الصق عنوان استلام واحد، وتحصل كل فاتورة على مبلغ فريد (مثل 25.000317) لتمييز المدفوعات.

لا تلصق أبداً مفتاحاً خاصاً أو عبارة استرداد. المنصة غير احتجازية وسترفضها.

2. أنشئ مفتاح API

افتح مفاتيح API، وأنشئ مفتاح اختبار وانسخ المفتاح السري (يظهر مرة واحدة فقط).

3. أنشئ فاتورة

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);

وجّه عميلك إلى checkout_url. تعرض صفحة الدفع المستضافة المبلغ والعنوان ورمز QR وحالة مباشرة.

4. استقبل الـ Webhook

أضف نقطة Webhook لمتجرك، وعند تأكيد الدفع ستصلك رسالة invoice.confirmed موقّعة بالسر الخاص بك. راجع Webhooks.

5. الانتقال للتشغيل الفعلي

استخدم مفتاح API حقيقي (live) بدلاً من مفتاح الاختبار، ولا شيء آخر يتغير.

تحتاج مساعدة؟ تواصل معنا آخر تحديث: 17 نوفمبر 2026 م