معاينة: الدفع عبر CrypCash لم يُفتح بعد، وقد تتغير الباقات والمزايا قبل الإطلاق.

كل الأدلة

اقبل USDT في المواقع المبنية بأدوات الذكاء الاصطناعي

لصفحات الهبوط والمتاجر المبنية بـ Framer وWebflow وv0 وLovable وBolt وأمثالها. اختر الطريقة التي تناسب كيف بُني موقعك.

قبل الإطلاق: تصف هذه الأدلة كيف سيجري التثبيت. لوحة CrypCash وإضافة WooCommerce وصفحة الدفع لم تُفتح بعد.

ما تحتاجه

  • متجرك في CrypCash ومعه محفظة (انظر «قبل أن تبدأ»)
  • للطريقة 3: موقع له شيفرة خادم، تكتبها لك أدوات مثل v0 وLovable وBolt

أي طريقة تناسب موقعك

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

الطريقة 2، شيفرة تُلصق: للأدوات التي تسمح بلصق HTML. يُفتح الدفع فوق صفحتك بدل نافذة جديدة.

الطريقة 3، نص للأداة: للأدوات التي تكتب الشيفرة، حين يكون في موقعك سلة أو أسعار تتغير. يُنشئ موقعك حينها كل فاتورة على خادمه.

الطريقة 1: رابط دفع على زر

أي أداة، دون شيفرة.

  1. أنشئ رابط دفع

    أعطِ الرابط اسمًا وسعرًا بعملتك، واختر الشبكات، واحفظ. كل عميل يفتح الرابط تُفتح له فاتورة خاصة به، محوَّلة إلى USDT بسعر السوق لحظة فتحها.

    لوحة CrypCash

    1. المتاجر
    2. متجرك
    3. روابط الدفع
    4. رابط جديد
    الاسم
    ما يراه العميل، كاسم منتجك
    السعر
    سعر ثابت بعملتك لا يستطيع العميل تغييره
    الشبكات
    TRON أو BNB Smart Chain أو كلاهما
    طلب البريد الإلكتروني
    اختياري، إن كنت تسلّم الطلب بالبريد
    بعد الدفع، انتقل إلى
    اختياري: صفحة الشكر في موقعك
  2. ضع الرابط على زر

    في أداتك، اختر زرًّا واجعل رابطه رابط الدفع. يدفع العميل في صفحة CrypCash، ثم يعود إلى صفحة الشكر إن حددتها.

    شكل رابط الدفع
    https://crypcash.io/l/lnk_…

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

الطريقة 2: شيفرة تفتح الدفع فوق صفحتك

للأدوات التي تقبل HTML، مثل Embed في Framer وCode Embed في Webflow.

  1. أنشئ رابط دفع

    أنشئه كما في الطريقة 1. تحتاج معرّفه، وهو جزء الرابط الذي يبدأ بـ lnk_.

  2. الصق الشيفرة

    أضف عنصر HTML حيث تريد الزر والصق الشيفرة. ضع معرّف رابطك مكان lnk_…، ونص زرك مكان نص الزر.

    عنصر HTML
    <script src="https://crypcash.io/v1/crypcash.js" defer></script>
    <button type="button" data-crypcash-link="lnk_…">Pay with Crypto (USDT)</button>

    السعر محفوظ في رابط الدفع لا في صفحتك، فلا يدفع أحد أقل بتعديل الصفحة في متصفحه.

الطريقة 3: نص للأدوات التي تكتب الشيفرة

لـ v0 وLovable وBolt وأمثالها، حين يكون في موقعك سلة أو أسعار عدة أو حسابات للعملاء.

  1. احصل على سرّيك

    الأول مفتاحك السري من «قبل أن تبدأ». وللثاني أضف في CrypCash عنوان الإشعارات في موقعك، مثل https://your-site.com/api/crypcash/webhook، وانسخ سرّ التوقيع الذي يعرضه.

    لوحة CrypCash

    1. المتاجر
    2. متجرك
    3. الإشعارات
    4. إضافة عنوان
  2. ضعهما في متغيرات البيئة لمشروعك

    في إعدادات متغيرات البيئة في أداتك أو في استضافتك، أضف CRYPCASH_SECRET_KEY وCRYPCASH_WEBHOOK_SECRET. لا تلصقهما أبدًا في المحادثة مع الأداة ولا في الصفحة نفسها.

  3. أعطِ أداتك هذا النص

    الصقه في محادثة الأداة كما هو. يطلب منها أن تُنشئ الفواتير على الخادم، وأن ترسل العملاء إلى صفحة CrypCash، وأن تتحقق من توقيع كل إشعار قبل أن تعلّم أي طلب مدفوعًا.

    النص بالإنجليزية كي تبقى الأسماء التقنية كما هي، وتستطيع الأداة أن تجيبك بلغتك.

    النص
    Add USDT checkout with CrypCash to this site.
    
    Secrets: read the CrypCash secret key from the environment variable CRYPCASH_SECRET_KEY and the webhook signing secret from CRYPCASH_WEBHOOK_SECRET. Use them only in server code. Never send them to the browser, log them or write them into a file.
    
    Checkout: when the customer confirms an order, create an invoice from the server.
    - POST https://api.crypcash.io/api/v1/invoices
    - Headers: Authorization: Bearer <CRYPCASH_SECRET_KEY>, Content-Type: application/json, Idempotency-Key: <order id>
    - JSON body: {"amount": "<order total as a string, like 49.99>", "currency": "<the store's currency code, like INR, EUR or USD>", "network": "TRON" or "BSC", "orderId": "<order id>", "successUrl": "<this site's thank-you page URL>"}
    - Compute the amount on the server from the order. Never take it from the browser. CrypCash converts it to USDT at the market rate.
    - Then redirect the customer to checkoutUrl from the JSON response.
    
    Webhook: add a POST endpoint at /api/crypcash/webhook.
    - Read the raw request body as text before parsing it.
    - The CrypCash-Signature header looks like t=<unix seconds>,v1=<hex>. Compute HMAC-SHA256 with CRYPCASH_WEBHOOK_SECRET over "<t>.<raw body>" and compare it with v1 in constant time. Answer 400 if it differs or if t is more than 300 seconds from now.
    - Parse the JSON. "type" is one of invoice.confirming, invoice.paid, invoice.overpaid, invoice.underpaid, invoice.expired. The order is data.invoice.orderId.
    - Mark the order paid only on invoice.paid or invoice.overpaid. On invoice.underpaid, flag the order for review. On invoice.expired, release it.
    - Save each event "id" and ignore an event you have already handled.
    - Answer 200 within 10 seconds.
    
    The thank-you page must not mark anything paid. Only the verified webhook does.
  4. راجع ما بنته

    اطلب من الأداة أن تريك أين تُنشأ الفاتورة وأين يُتحقق من التوقيع. يجب أن يأتي المبلغ من طلبك على الخادم لا من الصفحة، وألا يظهر السرّان إلا متغيرَي بيئة.

جرّب أي طريقة بدفعة حقيقية

حدد سعرًا قدره ⁦$1⁩، وادفع ⁦1 USDT⁩ من محفظة ثانية لك، وتحقق أن CrypCash يعرض الفاتورة مدفوعة. يصل المال إلى عنوانك أنت، فلا تكلّفك التجربة إلا رسوم الشبكة.

إن لم يعمل شيء

أداتي لا تسمح بلصق HTML.

استعمل الطريقة 1. الرابط على زر يعمل في كل أداة.

وضعت الأداة مفتاحي السري في شيفرة الصفحة.

ألغِ المفتاح في CrypCash في الحال وأنشئ غيره. احفظه متغيرَ بيئة فقط، واطلب من الأداة ألا تتصل بـ CrypCash إلا من شيفرة الخادم.

تُعلَّم الطلبات مدفوعة قبل وصول الدفع.

يجب أن ينتظر موقعك إشعار invoice.paid ويتحقق من توقيعه. العودة إلى صفحة الشكر لا تثبت شيئًا، فكل أحد يستطيع فتحها.

هل يبيع رابط واحد عدة منتجات؟

للرابط سعر واحد. أنشئ رابطًا لكل منتج، أو استعمل الطريقة 3 للسلة.

الدليل التاليشيفرتك الخاصةالواجهة البرمجية (REST) وإشعارات موقّعة

Shopify وWooCommerce وWordPress وFramer وWebflow وv0 وLovable وBolt وTrustpilot علامات تجارية لأصحابها، ولا صلة لـ CrypCash بهم.