اقبل مدفوعات العملات المشفرة في متجر إلكتروني، دون إضافة

نظرة سريعة

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

من لحظة اختيار العميل «الدفع بالعملات المشفرة» إلى خروج الطلب من مخزنك:

1. 1

   أنشئ الفاتورة عند الدفع

   عندما يختار العميل العملات المشفرة، يستدعي خادمك POST /invoices مع إجمالي الطلب، وorder_id الخاص بك، والبريد الإلكتروني للعميل، وredirect_url يعود إلى صفحة الشكر لديك، وأي metadata تريد إعادتها إليك. الرد هو الفاتورة مع checkout_url.

2. 2

   وجّه العميل إلى صفحة الفاتورة

   أعد التوجيه إلى checkout_url. تعرض الصفحة العملات التي تقبلها؛ وعندما يختار العميل واحدة، يُحسب المبلغ بتلك العملة من الأسعار الحالية ويُثبَّت، ويُعرض عنوان إيداع مُنشأ لهذه الفاتورة مع رمز QR. تبقى الفاتورة مفتوحة للمدة التي تحددها، 30 دقيقة افتراضيًا.

3. 3

   استلم Webhooks الموقّعة

   تتلقى نقطة النهاية لديك invoice.confirming عند رصد الدفعة على السلسلة وinvoice.paid بعد حصولها على تأكيدات كافية. تحقق من ترويسة CM-Signature، واحفظ الحدث، وردّ بـ 2xx في غضون 10 ثوانٍ، ثم أطلق الطلب من نسختك المحفوظة. قد تصل الأحداث مرتين: استخدم id الحدث للشحن مرة واحدة.

4. 4

   تعامل مع الحالات الحدّية الثلاث

   invoice.expired: لم تصل أي دفعة في الوقت المحدد، فاعرض فاتورة جديدة. invoice.underpaid: يمكن للعميل إرسال الباقي إلى العنوان نفسه أو الحصول على استرداد من صفحة الفاتورة. الفاتورة المدفوعة دفعًا زائدًا تظل مدفوعة؛ ويُحتفظ بالزيادة للعميل، الذي يمكنه سحبها من صفحة الفاتورة.

5. 5

   اصرف أموالك

   تُضاف المدفوعات المؤكدة إلى رصيدك بعد خصم 1‎%‎ وتُجمَّع في محفظة المجمّع الخاصة بنشاطك التجاري. اصرف في أي وقت إلى عناوينك الخاصة، كل عملة كما هي أو كل شيء مبادلًا إلى عملة احتفاظ واحدة.

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

curl https://cryptomerchant.online/api/v1/invoices \
  -H "Authorization: Bearer $CM_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "64.00",
    "currency": "USD",
    "order_id": "ORD-20931",
    "description": "Order ORD-20931",
    "customer_email": "[email protected]",
    "redirect_url": "https://yourstore.example/orders/20931/thanks",
    "metadata": { "cart": "20931" }
  }'

# 201 → { "id": "inv_…", "status": "open", "checkout_url": "https://cryptomerchant.online/pay/i/inv_…", … }
# Send the customer to checkout_url. Ship on the "invoice.paid" webhook.

ما التكلفة؟

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

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

• لا إضافة لمنصات المتاجر. لا توجد وحدة لـ WooCommerce أو Shopify أو Magento أو PrestaShop أو OpenCart. تضيف استدعاء API بنفسك، أو تشارك صفحة الدفع وروابط الدفع الخاصة بك.
• لا استرداد تلقائي، ولا استدعاء للاسترداد في API. الدفعة المؤكدة بالعملات المشفرة نهائية، لذا فالاسترداد تحويل جديد. عند إرجاع منتج، ينشئ أحد المسؤولين رابط استرداد خاصًا من الدفعة المدفوعة في البوابة؛ يُدخل العميل عنوانه بنفسه، وتُخصم رسوم الشبكة من المبلغ المسترد، ولا تُعاد رسوم 1‎%‎.
• بنظام الحفظ، وبالعملات المشفرة فقط. تحتفظ Crypto Merchant بالمفاتيح حتى تصرف، وتذهب عمليات الصرف إلى عناوين محفظتك الخاصة، لا إلى حساب بنكي.

لمن هذا؟

• المتاجر التي تدير صفحة الدفع الخاصة بها بالفعل ويمكنها إضافة استدعاء API واحد وWebhook.
• المتاجر التي تبيع لعملاء في دول يصعب فيها الحصول على بطاقات أو تضرّها عمليات رد المدفوعات (chargebacks).
• المتاجر التي تسعّر بالدولار وتريد التسوية بعملة USDT أو USDC.

صفحات ذات صلة

• قبول العملات الرقمية على Shopify بدون إضافة
• قبول العملات الرقمية على WooCommerce بدون إضافة
• مرجع API
• Webhooks
• المدفوعات الناقصة والزائدة
• أفضل بوابات دفع العملات المشفرة
• الأسعار والرسوم

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

• SaaS والاشتراكات
• المستقلون
• المنتجات الرقمية
• التبرعات

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