كل الأدلة
اقبل USDT في متجر Shopify
يختار عميلك Pay with Crypto (USDT) عند إتمام الطلب ويرسل طلبه، ثم يدفع من رابط في صفحة تأكيد الطلب وفي رسالة التأكيد. لا تطبيق يُثبَّت.
قبل الإطلاق: تصف هذه الأدلة كيف سيجري التثبيت. لوحة CrypCash وإضافة WooCommerce وصفحة الدفع لم تُفتح بعد.
ما تحتاجه
- متجر Shopify بعملة يحوّلها CrypCash، كالروبية أو اليورو أو الدولار: يصير مجموع الطلب USDT بسعر السوق لحظة فتح الفاتورة
- متجرك في CrypCash ومعه محفظة (انظر «قبل أن تبدأ»)
- صلاحية تعديل إعدادات المدفوعات والإشعارات في لوحة Shopify
أسماء القوائم مكتوبة كما تظهر في اللوحة الإنجليزية. إن كانت لوحتك بلغة أخرى فهي في المواضع نفسها.
لماذا يأتي الدفع بعد الطلب
لا تعرض Shopify داخل صفحة الدفع الخاصة بها إلا طرق شركاء المدفوعات الذين وافقت عليهم. وCrypCash ليس منهم، فيستعمل ما تتيحه Shopify لكل متجر: طريقة دفع يدوية.
يُنشأ الطلب بحالة Payment pending. يدفع عميلك في صفحة CrypCash، وحين يصير التحويل نهائيًّا يبلغك CrypCash، فتعلّم الطلب مدفوعًا.
اربط Shopify في CrypCash
اختر Shopify منصةً لمتجرك، واكتب اسم طريقة الدفع كما ستُنشئها في Shopify حرفًا بحرف. يستعمل هذا الدليل الاسم Pay with Crypto (USDT).
يعرض لك CrypCash بعدها عنوان صفحة الدفع الخاصة بمتجرك، وعنوان الإشعارات الذي تصل إليه طلباتك، وشيفرة الرسالة في الخطوة 4 ومعها معرّف متجرك. أبقِ هذه الصفحة مفتوحة.
لوحة CrypCash
- المتاجر
- متجرك
- المنصة
- Shopify
أضف طريقة الدفع في Shopify
في لوحة Shopify، أنشئ طريقة دفع مخصصة واملأ حقولها الثلاثة، ثم انقر Activate.
لوحة Shopify
- Settings
- Payments
- Manual payment methods
- 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.
أرسل طلباتك إلى CrypCash
أنشئ إشعار طلبات (webhook) كي يعلم CrypCash بكل طلب جديد ويفتح له فاتورة. لا يقرأ CrypCash إلا الطلبات المرسلة بـ Pay with Crypto (USDT)، ويتجاهل غيرها.
بعد الحفظ تعرض Shopify تحت قائمة الإشعارات المفتاح الذي تُوقَّع به. الصقه في CrypCash في صفحة الخطوة 1، كي يميّز CrypCash طلباتك الحقيقية من المزوّرة.
لوحة Shopify
- Settings
- Notifications
- Webhooks
- Create webhook
- Event
- Order creation. لا يمكن تغييره بعد ذلك.
- Format
- JSON
- URL
- عنوان الإشعارات الذي عرضه لك CrypCash في الخطوة 1
- Webhook API version
- أحدث إصدار مستقر في القائمة
ضع زر الدفع في رسالة تأكيد الطلب
افتح قالب رسالة تأكيد الطلب، والصق الشيفرة حيث تريد أن يظهر الزر، وفوق ملخص الطلب موضع مناسب. راجعه بـ Preview، ثم انقر Save.
لا يظهر الزر إلا في الطلبات المرسلة بـ Pay with Crypto (USDT). إن غيّرت اسم الطريقة فغيّره في الشيفرة أيضًا، فيجب أن يطابقه تمامًا. ويمكنك أن تكتب نص الزر بلغة متجرك.
لوحة Shopify
- Settings
- Notifications
- Customer notifications
- Order confirmation
- 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، وتسأل صفحة الدفع عن البريد المكتوب في الطلب قبل أن تعرض شيئًا.
علّم الطلب مدفوعًا حين يؤكده CrypCash
حين يصير التحويل نهائيًّا يرسل إليك CrypCash بريدًا، وتظهر الفاتورة مدفوعة في لوحتك. افتح الطلب في Shopify وانقر Mark as paid، ثم Mark payment as received. لا تغيّر Shopify حالة الدفع اليدوي من نفسها.
إن أرسل العميل أقل من المجموع أبقى CrypCash الفاتورة مفتوحة لبقية المبلغ، وعرض ما وصل. لا تعلّم الطلب مدفوعًا إلا حين يقول CrypCash مدفوعة.
لوحة Shopify
- Orders
- #1001
- Mark as paid
جرّبه بدفعة حقيقية
أنشئ منتجًا بسعر $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.
Shopify وWooCommerce وWordPress وFramer وWebflow وv0 وLovable وBolt وTrustpilot علامات تجارية لأصحابها، ولا صلة لـ CrypCash بهم.