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

كل الأدلة

اقبل USDT في متجر Shopify

يختار عميلك Pay with Crypto (USDT) عند إتمام الطلب ويرسل طلبه، ثم يدفع من رابط في صفحة تأكيد الطلب وفي رسالة التأكيد. لا تطبيق يُثبَّت.

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

ما تحتاجه

  • متجر Shopify بعملة يحوّلها CrypCash، كالروبية أو اليورو أو الدولار: يصير مجموع الطلب USDT بسعر السوق لحظة فتح الفاتورة
  • متجرك في CrypCash ومعه محفظة (انظر «قبل أن تبدأ»)
  • صلاحية تعديل إعدادات المدفوعات والإشعارات في لوحة Shopify

أسماء القوائم مكتوبة كما تظهر في اللوحة الإنجليزية. إن كانت لوحتك بلغة أخرى فهي في المواضع نفسها.

لماذا يأتي الدفع بعد الطلب

لا تعرض Shopify داخل صفحة الدفع الخاصة بها إلا طرق شركاء المدفوعات الذين وافقت عليهم. وCrypCash ليس منهم، فيستعمل ما تتيحه Shopify لكل متجر: طريقة دفع يدوية.

يُنشأ الطلب بحالة Payment pending. يدفع عميلك في صفحة CrypCash، وحين يصير التحويل نهائيًّا يبلغك CrypCash، فتعلّم الطلب مدفوعًا.

  1. اربط Shopify في CrypCash

    اختر Shopify منصةً لمتجرك، واكتب اسم طريقة الدفع كما ستُنشئها في Shopify حرفًا بحرف. يستعمل هذا الدليل الاسم Pay with Crypto (USDT).

    يعرض لك CrypCash بعدها عنوان صفحة الدفع الخاصة بمتجرك، وعنوان الإشعارات الذي تصل إليه طلباتك، وشيفرة الرسالة في الخطوة 4 ومعها معرّف متجرك. أبقِ هذه الصفحة مفتوحة.

    لوحة CrypCash

    1. المتاجر
    2. متجرك
    3. المنصة
    4. Shopify
  2. أضف طريقة الدفع في Shopify

    في لوحة Shopify، أنشئ طريقة دفع مخصصة واملأ حقولها الثلاثة، ثم انقر Activate.

    لوحة Shopify

    1. Settings
    2. Payments
    3. Manual payment methods
    4. Create custom payment method
    Custom payment method name
    Pay with Crypto (USDT)، وهو الاسم نفسه الذي أعطيته CrypCash
    Additional details
    يظهر بجانب الطريقة عند إتمام الطلب. مثلًا: «ادفع بـ USDT على TRON أو BNB Smart Chain بعد إرسال طلبك مباشرة.»
    Payment instructions
    يظهر في صفحة تأكيد الطلب. مثلًا: «للدفع افتح crypcash.io/s/your-store واكتب رقم طلبك. الرابط أيضًا في رسالة تأكيد الطلب.» استعمل عنوان صفحة الدفع الخاص بك من الخطوة 1.
  3. أرسل طلباتك إلى CrypCash

    أنشئ إشعار طلبات (webhook) كي يعلم CrypCash بكل طلب جديد ويفتح له فاتورة. لا يقرأ CrypCash إلا الطلبات المرسلة بـ Pay with Crypto (USDT)، ويتجاهل غيرها.

    بعد الحفظ تعرض Shopify تحت قائمة الإشعارات المفتاح الذي تُوقَّع به. الصقه في CrypCash في صفحة الخطوة 1، كي يميّز CrypCash طلباتك الحقيقية من المزوّرة.

    لوحة Shopify

    1. Settings
    2. Notifications
    3. Webhooks
    4. Create webhook
    Event
    Order creation. لا يمكن تغييره بعد ذلك.
    Format
    JSON
    URL
    عنوان الإشعارات الذي عرضه لك CrypCash في الخطوة 1
    Webhook API version
    أحدث إصدار مستقر في القائمة
  4. ضع زر الدفع في رسالة تأكيد الطلب

    افتح قالب رسالة تأكيد الطلب، والصق الشيفرة حيث تريد أن يظهر الزر، وفوق ملخص الطلب موضع مناسب. راجعه بـ Preview، ثم انقر Save.

    لا يظهر الزر إلا في الطلبات المرسلة بـ Pay with Crypto (USDT). إن غيّرت اسم الطريقة فغيّره في الشيفرة أيضًا، فيجب أن يطابقه تمامًا. ويمكنك أن تكتب نص الزر بلغة متجرك.

    لوحة Shopify

    1. Settings
    2. Notifications
    3. Customer notifications
    4. Order confirmation
    5. Edit code
    رسالة تأكيد الطلب (Liquid). STORE_ID هو معرّف متجرك من الخطوة 1.
    {% for transaction in transactions %}
      {% if transaction.gateway == 'Pay with Crypto (USDT)' %}
        <p style="margin:24px 0">
          <a href="https://crypcash.io/s/STORE_ID/{{ order_name | url_encode }}"
             style="display:inline-block; padding:14px 24px; border-radius:999px;
                    background:#ad1d52; color:#ffffff; font-weight:bold; text-decoration:none">
            Pay {{ total_price | money }} in USDT
          </a>
        </p>
        {% break %}
      {% endif %}
    {% endfor %}

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

    المبلغ ليس في الرابط: يأخذه CrypCash من الطلب الذي أرسلته Shopify، وتسأل صفحة الدفع عن البريد المكتوب في الطلب قبل أن تعرض شيئًا.

  5. علّم الطلب مدفوعًا حين يؤكده CrypCash

    حين يصير التحويل نهائيًّا يرسل إليك CrypCash بريدًا، وتظهر الفاتورة مدفوعة في لوحتك. افتح الطلب في Shopify وانقر Mark as paid، ثم Mark payment as received. لا تغيّر Shopify حالة الدفع اليدوي من نفسها.

    إن أرسل العميل أقل من المجموع أبقى CrypCash الفاتورة مفتوحة لبقية المبلغ، وعرض ما وصل. لا تعلّم الطلب مدفوعًا إلا حين يقول CrypCash مدفوعة.

    لوحة Shopify

    1. Orders
    2. #1001
    3. Mark as paid
  6. جرّبه بدفعة حقيقية

    أنشئ منتجًا بسعر ⁦$1⁩، واطلبه بـ Pay with Crypto (USDT)، وادفع ⁦1 USDT⁩ من محفظة ثانية لك. يصل المال إلى عنوانك أنت، فلا تكلّفك التجربة إلا رسوم الشبكة.

    تحقق من ثلاثة أشياء: الزر موجود في رسالة التأكيد، وصفحة الدفع تعرض الطلب، وCrypCash يرسل إليك بريدًا حين تصير الفاتورة مدفوعة.

إن لم يعمل شيء

الزر لا يظهر في الرسالة.

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

لم يفتح CrypCash فاتورة لطلب ما.

راجع الإشعار: الحدث Order creation، والصيغة JSON، والعنوان من CrypCash. ثم تحقق أن مفتاح التوقيع في CrypCash هو الذي تعرضه Shopify الآن، وأن اسم طريقة الدفع في CrypCash يطابق اسمها في Shopify.

دفع العميل، وما زالت Shopify تقول Payment pending.

هذا متوقع: Shopify لا تحدّث الدفع اليدوي من نفسها. علّم الطلب مدفوعًا حين يؤكده CrypCash.

مبلغ USDT ليس الرقم نفسه الذي في مجموع الطلب.

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

هل يمكن أن يظهر الخيار داخل صفحة دفع Shopify نفسها، كالدفع بالبطاقة؟

لا يضيف طريقةً هناك إلا شركاء المدفوعات الذين وافقت عليهم Shopify. وCrypCash ليس منهم اليوم، فيستعمل هذا الدليل طريقة الدفع اليدوية الموجودة في كل متجر Shopify.

الدليل التاليWooCommerceإضافة CrypCash Gateway ومفتاح واحد

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