كيف تستقبل الدفع بالعملات الرقمية في متجرك؟

لماذا بوابة دفع بالعملات الرقمية؟

• عملاء من داخل سوريا وخارجها يدفعون من أي محفظة (Binance، Trust Wallet وغيرها).
• عنوان خاص لكل فاتورة، فتُطابَق كل دفعة مع طلبها تلقائياً.
• صفحة دفع جاهزة برمز QR وعدّاد وقت وتعليمات واضحة لعميلك.
• إشعار Webhook فوري لموقعك لحظة تأكيد الدفعة.

العملات والشبكات المدعومة

• USDT وUSDC على شبكات BEP20 (BNB Smart Chain) وERC20 (Ethereum) وSolana.
• BTC وETH وBNB وLTC وSOL.

ننصح بشبكة BEP20 للمبالغ الصغيرة لأن رسومها منخفضة وتأكيدها سريع.

الخطوات

1. 1) أنشئ حساباً

   سجّل على إنشاء حساب وادخل إلى لوحة التحكم.

2. 2) أنشئ مفتاح تاجر

   من لوحة التحكم → العملات الرقمية → التاجر، أنشئ مفتاحاً واختر العملات والشبكات، وحدد رابط الـWebhook لموقعك.

3. 3) أنشئ فاتورة عند كل طلب

   عندما يضغط عميلك «ادفع»، يرسل موقعك طلباً واحداً لإنشاء فاتورة بالمبلغ.

4. 4) وجّه العميل إلى صفحة الدفع

   يعيد الطلب رابط payment_url؛ يفتحه العميل ويدفع من محفظته.

5. 5) استقبل التأكيد

   عند تأكيد الدفعة يصل إشعار Webhook موقّع إلى موقعك، فتغيّر حالة الطلب إلى «مدفوع» تلقائياً.

مثال: إنشاء فاتورة دفع

POST https://tsa-api.com/v1/payment/invoice
Header: merchant_api_key: YOUR_MERCHANT_KEY
Content-Type: application/json

{
  "amount": "25.00",
  "currency": "USDT",
  "order_id": "1042",
  "description": "طلب رقم 1042"
}

الرد:

{
  "track_id": "Iw-h2v...5wdV",
  "payment_url": "https://tsa-api.com/pay/Iw-h2v...5wdV",
  "amount": "25.00",
  "currency": "USDT",
  "lifetime": 60
}

مثال PHP

$ch = curl_init("https://tsa-api.com/v1/payment/invoice");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["merchant_api_key: YOUR_MERCHANT_KEY", "Content-Type: application/json"],
  CURLOPT_POSTFIELDS => json_encode(["amount" => "25.00", "currency" => "USDT", "order_id" => "1042"]),
]);
$invoice = json_decode(curl_exec($ch), true);
header("Location: " . $invoice["payment_url"]);

مثال Python

import requests

r = requests.post(
    "https://tsa-api.com/v1/payment/invoice",
    headers={"merchant_api_key": "YOUR_MERCHANT_KEY"},
    json={"amount": "25.00", "currency": "USDT", "order_id": "1042"},
)
print(r.json()["payment_url"])

أسئلة شائعة

كم يستغرق تأكيد الدفع؟

يعتمد على الشبكة: على BEP20 وSolana عادة خلال دقيقة، وعلى Bitcoin قد يستغرق وقتاً أطول.

ماذا يحدث إذا دفع العميل مبلغاً ناقصاً؟

تبقى الفاتورة بحالة «مبلغ ناقص» وتعرض صفحة الدفع المبلغ المتبقي. ويمكنك ضبط نسبة سماحية للنقص من إعدادات المفتاح.

من يتحمّل العمولة؟

أنت تختار من إعدادات المفتاح: يتحمّلها التاجر، أو تُضاف إلى مبلغ العميل.

أين تصل الأموال؟

إلى رصيدك في المنصة، أو مباشرة إلى عنوان محفظتك الخارجية حسب إعدادات المفتاح.

نصائح مهمة

• لا تشارك مفتاح التاجر — احفظه على الخادم فقط وليس في صفحات الموقع.
• تحقّق دائماً من توقيع الـWebhook قبل تغيير حالة الطلب.
• تتوفر أيضاً ربط شام كاش وربط سيريتل كاش على نفس المنصة.