حالات الاستخدام

اقبل مدفوعات العملات المشفرة لخدمة SaaS أو اشتراك

تقبل خدمة SaaS العملات المشفرة مع Crypto Merchant بإنشاء فاتورة لكل فترة فوترة وتمديد الحساب عند وصول Webhook invoice.paid الموقّع. لا يمكن الخصم من محافظ العملات المشفرة تلقائيًا، لذا فالتجديد هو فاتورة يدفعها العميل، مع تذكير عند انتهاء صلاحية إحداها. وللرصيد المدفوع مسبقًا، تمنح المحافظ الثابتة كل عميل عنوان إيداع دائمًا يُضاف إلى رصيده عند deposit.confirmed. الرسوم هي 1‎%‎ لكل فاتورة مدفوعة، بلا رسوم شهرية.

آخر تحديث 6 نوفمبر 2026

كل ما في هذه الصفحة يصف كيف تعمل Crypto Merchant اليوم، كما هو موضح في مرجع API وتوثيق صفحة الدفع والأسعار. لا شيء هنا يُعدّ ادعاءً بشأن بوابات دفع أخرى.

نظرة سريعة

الموضوع	كيف يعمل
كيف يدفع العملاء	صفحة فاتورة لكل فترة فوترة، مرتبطة من شاشة الفوترة لديك أو من بريد التجديد. وللأرصدة المدفوعة مسبقًا، عنوان إيداع دائم خاص بهم، واحد لكل شبكة.
ما الذي تبنيه	مهمة تنشئ فاتورة عند انتهاء الفترة، مع `metadata` تحدد الحساب والفترة، ونقطة نهاية Webhook تمدد الحساب. أو `POST /sticky-wallets` لكل حساب.
الرسوم المتكررة	ليست تلقائية. لا يمكن الخصم من محفظة العملات المشفرة، لذا فكل تجديد هو فاتورة جديدة يدفعها العميل. يخبرك حدث `invoice.expired` بموعد إرسال تذكير.
التسعير والاحتفاظ	سعّر الخطط بالدولار أو بعملة مدعومة أخرى؛ تُحتسب العملات المستقرة بدولار أمريكي واحد لكل منها. بادِل كل ما تستلمه إلى USDT أو USDC حتى لا تتحرك إيراداتك مع السوق.
سجلات العملاء	أرسل `customer_email` وستُجمَّع المدفوعات حسب العميل في البوابة؛ ويعود `order_id` و`metadata` في كل Webhook.
وثائق التسجيل	لا شيء. لا تحتاج إلى شركة مسجلة لفتح حساب؛ الشروط تظل سارية.

كيف يعمل، خطوة بخطوة؟

خطة شهرية، من نهاية فترة إلى بداية التالية:

1
أنشئ فاتورة عند انتهاء الفترة
تستدعي مهمة مجدولة POST /invoices مع سعر الخطة، وorder_id مثل معرّف الاشتراك مع الفترة، والبريد الإلكتروني للعميل، وredirect_url يعود إلى صفحة الفوترة لديك، وmetadata تحدد الحساب والفترة.
2
أظهر للعميل أين يدفع
ضع checkout_url خلف زر «الدفع بالعملات المشفرة» في صفحة الفوترة وفي بريد التجديد. يختار العميل عملة، ويُثبَّت السعر، وتبقى الفاتورة مفتوحة للمدة التي تحددها، 30 دقيقة افتراضيًا.
3
مدّد الحساب عند invoice.paid
تحقق من التوقيع، واحفظ الحدث، وردّ بـ 2xx، ثم مدّد الحساب المحدد في metadata فترة واحدة. استخدم id الحدث حتى لا يمدده التسليم المتكرر مرتين.
4
ذكّر عند invoice.expired
إذا انتهت صلاحية الفاتورة دون دفع، فأنشئ واحدة جديدة وأرسلها بالبريد. الفاتورة المنتهية لا تحتفظ بشيء: كان السعر مثبّتًا فقط أثناء كونها مفتوحة.
5
الرصيد المدفوع مسبقًا: امنح كل عميل عنوانًا دائمًا
مع المحافظ الثابتة، يُعيد POST /sticky-wallets مع معرّفك الخاص للعميل العناوين نفسها كل مرة. اعرضها في صفحة لشحن الرصيد؛ وعند deposit.confirmed، أضف المبلغ إلى رصيد العميل المحدد في sticky_wallet.reference.

استدعاء API الوحيد الذي يحتاجه الأمر

أصدر فاتورة لفترة فوترة واحدة

curl https://cryptomerchant.online/api/v1/invoices \
  -H "Authorization: Bearer $CM_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "29.00",
    "currency": "USD",
    "order_id": "sub_8f3a-2026-11",
    "description": "Pro plan, November 2026",
    "customer_email": "[email protected]",
    "redirect_url": "https://app.example/billing?paid=1",
    "metadata": { "account": "8f3a", "period": "2026-11" }
  }'

# On "invoice.paid": extend account 8f3a by one month (metadata is echoed back).
# On "invoice.expired": send a reminder with a fresh invoice.

ما التكلفة؟

1‎%‎ من كل فاتورة مدفوعة، تُخصم عند إضافة الدفعة إلى رصيدك. لا رسوم إعداد ولا رسوم شهرية ولا أي دفعة للتفعيل؛ والفواتير المنتهية والملغاة لا تكلف شيئًا. نقل العملات (التجميع والمبادلة والصرف) يترتب عليه رسوم غاز، تُخصم من رصيد الغاز الخاص بك إن أضفت واحدًا، وإلا فمن العملات التي يتم نقلها. يدفع العملاء أيضًا رسوم غاز على كل فاتورة: تُضاف إلى المبلغ الذي يرسلونه، وتظهر في صفحة الدفع، ولا تتجاوز أبدًا ‏5 US$. تتضمن أسعار المبادلة هامش خدمة قدره 1‎%‎. كل التكاليف في جدول واحد على صفحة الأسعار.

ما لا تقوم به Crypto Merchant هنا

لا تجديدات تلقائية. لا توجد بطاقة محفوظة للخصم منها ولا كائن اشتراك. مهمتك تنشئ فاتورة كل فترة، والعميل يدفعها.
لا محرك ضرائب أو متابعة للمتأخرات. تنشئ Crypto Merchant الفواتير، وتتلقى المدفوعات، وتخبر خادمك؛ أما ضريبة القيمة المضافة والإيصالات ورسائل التذكير فعليك بناؤها.
بنظام الحفظ، وبالعملات المشفرة فقط. تبقى الأرصدة في محفظة مجمّع تحتفظ بها Crypto Merchant حتى تصرف إلى عناوينك الخاصة. لا توجد تسوية بنكية.

لمن هذا؟

أدوات المطورين وواجهات API والبرمجيات التي تُباع لعملاء في دول كثيرة.
المنتجات التي يملك عملاؤها عملات مستقرة بالفعل ويفضلون الدفع بها.
الفرق التي ليس لديها شركة مسجلة ولا تستطيع فتح حساب تاجر تقليدي.

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

هل يمكن لـ Crypto Merchant الخصم من عملائي تلقائيًا كل شهر؟

لا. لا يمكن للتاجر الخصم من محافظ العملات المشفرة. كل تجديد هو فاتورة يدفعها العميل؛ تنشئها عبر API عند انتهاء الفترة وتذكّرهم إذا انتهت صلاحيتها.

كيف أعرف الحساب الذي تعود إليه الدفعة؟

أرسل معرّف الحساب في order_id أو metadata عند إنشاء الفاتورة. يعود كلاهما دون تغيير في كائن الفاتورة وفي كل Webhook يتعلق بها.

هل يمكنني تسعير خططي بعملة USDT؟

تُسعَّر الفواتير بعملة مثل الدولار الأمريكي، وتُحتسب العملات المستقرة بدولار واحد لكل منها، فخطة بسعر 29 دولارًا تكلف 29 USDT بالإضافة إلى أي رسوم غاز تظهر في صفحة الدفع. ويظل بإمكان العميل الدفع بأي عملة تقبلها، ويمكنك مبادلة كل ما تستلمه إلى USDT أو USDC.

ما فائدة المحافظ الثابتة؟

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

حالات استخدام أخرى

كل حالات الاستخدام

ابدأ قبول العملات المشفرة اليوم

إعداد مجاني، بلا وثائق مطلوبة للتسجيل، 1‎%‎ لكل فاتورة مدفوعة، وصرف متى شئت.

أنشئ حسابك اقرأ التوثيق