البدء السريع

احصل على أول دفعة عملات مشفرة في أقل من 5 دقائق.

المتطلبات الأساسية

• حساب QuantaPay علىcloud.quantapay.app
• عنوان محفظة عملات مشفرة واحد على الأقل (مثل عنوان Bitcoin أو Ethereum)

الخطوة 1: الاشتراك وتسجيل الدخول

1. اذهب إلىcloud.quantapay.appوأنشئ حسابك.
2. بعد تسجيل الدخول، سترىHub— لوحة التحكم الخاصة بك لإدارة المدفوعات.

الخطوة 2: إضافة عناوين محفظتك

انتقل إلىSettings → Payments. سترى قسمCryptocurrency Addressesفي الأعلى.

أدخل عناوين المحفظة التي تريد تلقي المدفوعات فيها. ستظهر فقط العملات المشفرة التي لها عنوان مُكوَّن كخيارات دفع لعملائك.

الإعداد الأكثر شيوعًا:

• Bitcoin (BTC)—bc1...أو1...أو3...صيغة
• USDT (TRC-20)—T...صيغة (رسوم منخفضة، شائعة لمدفوعات العملات المستقرة)
• Ethereum (ETH)—0x...صيغة

يمكنك إضافة المزيد من العملات المشفرة لاحقًا. راجعCryptocurrency Addressesللحصول على القائمة الكاملة.

الخطوة 3: تكوين Webhook (اختياري ولكن يوصى به)

لا تزال فيSettings → Payments، قم بالتمرير لأسفل إلى قسمWebhook.

1. أدخلWebhook URL الخاص بك— هذا هو نقطة النهاية على خادمك التي ستتلقى إشعارات الدفع.
2. أمفتاح سري للـ Webhookيتم إنشاؤه تلقائيًا. حافظ عليه آمنًا - ستستخدمه للتحقق من الـ webhooks الواردة عن طريق فحص حقل الـkeyفي حمولة JSON.

Webhook URL: https://yoursite.com/webhook/quantapay
Webhook Secret: (auto-generated alphanumeric string)

بدون webhook، لا يزال بإمكانك التحقق من حالة الدفع عبر API، ولكن webhooks توفر إشعارات في الوقت الفعلي.

الخطوة 4: احصل على مفتاح API الخاص بك

اذهب إلىالإعدادات ← الحساب. يتم عرضمفتاح APIالخاص بك هنا. انسخه - ستحتاج إليه لجميع استدعاءات API.

الخطوة 5: أنشئ دفعتك الأولى

قم بإجراء استدعاء API بسيط لإنشاء جلسة دفع:

curl -X POST https://cloud.quantapay.app/api.php \
  -d "function=create-checkout-session" \
  -d "api-key=YOUR_API_KEY" \
  -d "price=10.00" \
  -d "currency=USD"

الاستجابة:

{
  "success": true,
  "response": {
    "session_id": "cs_a1b2c3d4e5f6a1b2c3d4",
    "payment_url": "https://cloud.quantapay.app/pay.php?session=cs_a1b2c3d4e5f6a1b2c3d4",
    "expires_at": "2026-03-08T11:00:00+00:00"
  }
}

أعد توجيه عميلك إلىpayment_url. سوف يقومون بـ:

1. رؤية العملات المشفرة المتاحة
2. تحديد عملتهم المفضلة
3. مسح رمز QR أو نسخ العنوان
4. إرسال الدفعة
5. انتظار تأكيد البلوك تشين

الخطوة 6: تلقي إشعار الدفع

عند تأكيد الدفع على البلوك تشين، ستقوم QuantaPay بـ:

1. إرسال webhookإلى عنوان URL الذي قمت بتكوينه (إذا تم إعداده)
2. تحديث حالة المعاملةفي لوحة التحكم الخاصة بك
3. إعادة توجيه العميلإلى عنوان URL الخاص بالنجاح (إذا تم تكوينه)

يمكنك أيضًا التحقق من الحالة برمجيًا:

curl -X POST https://cloud.quantapay.app/api.php \
  -d "function=get-checkout-session" \
  -d "api-key=YOUR_API_KEY" \
  -d "session_id=cs_a1b2c3d4e5f6a1b2c3d4"

ما التالي؟

• [عناوين العملات المشفرة](/docs/getting-started/payment-settings/cryptocurrency-addresses/)— إضافة المزيد من العملات
• [تكوين Webhook](../02-payment-settings/02-webhook-configuration.md)— إعداد إشعارات الدفع
• [مرجع API: المعاملات](..//docs/api-reference/transactions-api/)— وثائق API كاملة
• [WordPress / WooCommerce](..//docs/integrations/wordpress-plugin/)— استخدم إضافة WordPress الخاصة بنا

آلية العمل: نموذج غير احتجازي

QuantaPay هيغير احتجازية— نحن لا نحتفظ بأموالك أبدًا. عندما يدفع العميل:

1. يرسل العميل العملة المشفرةمباشرةً إلى عنوان محفظتك
2. تراقب QuantaPay البلوك تشين للمعاملة الواردة
3. بمجرد التأكيد، تُعلمك QuantaPay عبر webhook

تذهب أموالك مباشرة إلى محفظتك. لا وسطاء، ولا تأخير في السحب.