المطورون

API مدفوعات كريبتو مصمم للمطورين

أنشئ فواتير الكريبتو عبر API، ووجّه العملاء إلى صفحة الدفع المستضافة عبر redirectUrl، واستلم الحالات النهائية عبر webhook.

ابدأ بهذا المسار إنشاء فاتورة تجريبية Chat on Telegram

SDK لكل من Node.js وPHPقريبًاإعادة محاولة webhook والسجلات

POST/api/v1/payment

x-api-key: sk_live_…

{
  "id": "order_1024",
  "price": 12499.00,
  "currency": "INR"
}

// 201 Created
{
  "data": {
    "id": "8f3k2a1c",
    "redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
  },
  "code": 201,
  "message": "success",
  "status": true
}

التكامل

API من Qvard للمطورين

أنشئ الفاتورة واستلم redirectUrl
تعامل مع حالة webhook النهائية
successUrl وfailUrl وreturnUrlقريبًا

أسعار العملات

POSTyour-webhook-url

x-api-key: sk_live_…

{
  "id": "order_1024",
  "status": "paid"
}

بداية سريعة

طلب واحد، تحويل واحد، webhook واحد

أنشئ دفعة، ووجّه العميل، وعالج webhook النهائي — التكامل كله في صفحة واحدة.

أنشئ الدفعة مع externalId والمبلغ والعملة والروابط.
وجّه العميل إلى data.redirectUrl.
استلم webhook الحالة النهائية: wait أو processing أو completed أو rejected.

العملات

استلم بعملتك، والحسابات بالدولار الأمريكي

حدّد المبلغ بأي عملة ISO-4217 عبر الحقل currency، مثل INR أو RUB أو EUR. وإن لم يُرسل الحقل فالمبلغ بالدولار الأمريكي كما كان.

يُثبَّت سعر صرف Qvard مرة واحدة عند إنشاء الدفعة. يرى الدافع المبلغ بعملتك والمبلغ بالرمز الذي يدفع به، وتُسجَّل الدفعة بالدولار الأمريكي.
تُفحص الحدود بالدولار الأمريكي بعد التحويل. إذا خرج المبلغ عن النطاق، يعرض نص الخطأ الحد بعملتك.
أسعار الصرف الحالية موجودة في صفحة الأسعار وفي الواجهة البرمجية: GET /api/v1/rates، دون مفتاح. ويمكنك في إعدادات متجرك تحديد سعر صرف خاص بك لكل عملة.
الأخطاء: 422 unsupported_currency للعملة غير المدعومة؛ 422 rate_unavailable عند غياب سعر الصرف؛ 422 invalid_amount_precision عند تجاوز عدد المنازل العشرية المسموح به للعملة (JPY 0، وKWD 3، ومعظم العملات 2).

GET/api/v1/rates

curl "https://api.qvard.com/api/v1/rates?currencies=EUR,INR"

// 200 OK
{ "data": { "base": "USD", "updatedAt": "…", "rates": { "EUR": 0.92, "INR": … } } }

أسعار العملات

تحقق من توقيعات webhook

يتم التوقيع على كل webhook من Qvard باستخدام HMAC-SHA256. تعرف على كيفية التحقق من التوقيع والحماية من التزييف باستخدام رمز جاهز لـ Node.js و PHP.

كيفية التحقق الدفع المدمج روابط الدفع مرجع API

FAQ

الأسئلة الشائعة

A quick overview of how Qvard handles payments, integration and merchant operations.

ما هو Qvard؟

Qvard هو بوابة دفع بالعملات الرقمية للشركات، توفر صفحة دفع مستضافة وفواتير ومدفوعات عبر API وأرصدة للتجار.

ما الأصول المدعومة؟

يدعم Qvard USDT وUSDC وBTC وLTC وTRX وBNB وETH. TON وUSDT على TON قريبًا.

هل هو مناسب للمطورين؟

نعم. يشمل Qvard مدفوعات API وredirectUrl وwebhooks وإعادة المحاولات وسجلات التسليم.

هل يمكنني تخصيص صفحة الدفع؟

تدعم صفحة الدفع شعار التاجر واسم المتجر ولون الزر والترجمة. روابط العودة المخصصة قريبًا.

ماذا أحتاج للبدء؟

أنشئ حساب تاجر وأكمل توثيق النشاط التجاري. بعد تجربة فاتورة تجريبية، اربط صفحة الدفع المستضافة أو API وابدأ باستقبال المدفوعات الحقيقية.

كيف تعمل السحوبات؟

تُتبع الأموال في أرصدة التاجر، منفصلة حسب الأصل والشبكة. يمكنك السحب يدويًا أو إعداد قواعد سحب للدفعات التلقائية.