الأساسيات
الدفع
يدفع العملاء على صفحات تستضيفها Crypto Merchant. لا تحتاج إلى موقع إلكتروني: شارك صفحة الدفع الخاصة بك أو رابط دفع. وإذا كان لديك موقع، فأنشئ الفواتير باستخدام API ووجّه العملاء إلى صفحة الفاتورة.
صفحة الدفع الخاصة بك
يحصل كل متجر على صفحة دفع خاصة به على /pay/<store>، حيث <store> هو الاسم المختصر لمتجرك. يمكن للعملاء إدخال مبلغ هناك، أو اختيار أحد روابط الدفع الخاصة بك. شاركها في أي مكان تتواصل فيه مع العملاء: موقعك الإلكتروني، أو حساباتك على وسائل التواصل الاجتماعي، أو المحادثات، أو البريد الإلكتروني.
ستجد الرابط في البوابة ضمن صفحة الدفع الخاصة بك.
صفحة الفاتورة
لكل فاتورة صفحة خاصة بها على /pay/i/<invoice_id>. تُعيد API هذا الرابط باسم checkout_url. وفيها، العميل:
- يختار عملة وشبكة من بين التي تقبلها؛
- يرى عنوان إيداع مُنشأ لهذه الفاتورة، مع رمز QR، والمبلغ الدقيق المطلوب إرساله، بسعر صرف مثبّت في تلك اللحظة؛
- يمكنه التبديل إلى عملة أخرى حتى يتم رصد دفعة؛
- يتابع تغيّر الحالة مباشرة، من الانتظار إلى التأكيد إلى الدفع.
تبقى كل فاتورة مفتوحة لفترة محدودة، تُعرض كعدّاد تنازلي. إذا انتهى الوقت قبل رصد أي دفعة، تنتهي صلاحية الفاتورة. إذا حددت redirect_url، يمكن للعميل العودة إلى موقعك بعد الدفع.
إذا دفع العميل لكن الدفعة لم تظهر قبل انتهاء صلاحية الفاتورة، فيمكنه الإبلاغ عن ذلك من صفحة الفاتورة. عندها يُسحب العنوان من التداول ويبقى قيد المراقبة، ويتحقق فريق الدعم لدينا من الدفعة.
روابط الدفع
رابط الدفع هو رابط قابل لإعادة الاستخدام لمنتج أو خدمة أو تبرع واحد، على /pay/l/<link_id>. امنحه عنوانًا وإما مبلغًا ثابتًا، أو اترك المبلغ فارغًا ليُدخله العميل. كل دفعة تتم عبر رابط تصبح فاتورة مستقلة.
أنشئ الروابط في البوابة ضمن روابط الدفع، أو باستخدام API.
معاينات المشاركة
عندما تشارك رابط دفع أو صفحة الدفع الخاصة بك في WhatsApp أو Telegram أو Instagram أو X أو تطبيقات مشابهة، يعرض التطبيق بطاقة معاينة. وتتضمن اسم متجرك، ونطاقك الموثّق إن كان لديك واحد، والعملات التي تقبلها. وفي رابط الدفع، تعرض أيضًا المنتج وسعره.
روابط الدفع غير مدرجة في محركات البحث، لذا لا يصل الرابط إلا إلى الأشخاص الذين تشاركه معهم.
النطاق الموثّق
إذا وثّقت نطاق موقعك الإلكتروني، تعرضه صفحة الدفع الخاصة بك وروابط الدفع وصفحات الفواتير وصفحات الاسترداد بجانب اسم متجرك، على سبيل المثال shop.com · موثّق. وهذا يُخبر العملاء بأن المتجر الظاهر على الصفحة يتحكم في DNS ذلك النطاق. راجع كيفية توثيق نطاقك.
أسعار الصرف
تُسعّر الفواتير بعملة مثل الدولار الأمريكي. عندما يختار العميل عملة، يُحسب المبلغ بتلك العملة من الأسعار الحالية ويُثبّت. تُحتسب العملات المستقرة مثل USDT وUSDC بدولار أمريكي واحد لكل منها. إذا رُصدت الدفعة لأول مرة بينما لا تزال الفاتورة مفتوحة، يُطبّق السعر المثبّت.
العملاء الذين يدفعون من منصة تداول
عادةً ما تخصم منصات التداول رسوم السحب من المبلغ الذي يكتبه العميل، فيصل أقل مما أُرسل. وهذا هو السبب الأكثر شيوعًا للفواتير المدفوعة دفعًا ناقصًا. تتضمن صفحة الفاتورة ملاحظة بعنوان هل تدفع من منصة تداول؟ تطلب من العميل التأكد من وصول المبلغ كاملًا.
عندما تتوفر رسوم السحب لدى Binance لتلك العملة والشبكة، تعرض الملاحظة أيضًا الرسوم والإجمالي الذي يجب إدخاله على Binance. أما منصات التداول الأخرى فتفرض رسومها الخاصة، وعلى العميل التحقق منها في شاشة السحب.
عملة خاطئة أو شبكة خاطئة
يدفع العملاء أحيانًا بعملة غير التي طلبتها الفاتورة، أو على شبكة مختلفة. تراقب Crypto Merchant كل عنوان فاتورة بحثًا عن كل عملة مدعومة، على كل شبكة مدعومة تستخدم ذلك العنوان، لذا تُرصد هذه المدفوعات.
عنوان EVM واحد يعمل على Ethereum وBNB Smart Chain وPolygon وBase وArbitrum One، ونحن نحتفظ بمفتاحه عليها جميعًا. لذا فإن USDC المرسلة على Base إلى فاتورة طلبت USDC على Ethereum تصل رغم ذلك إلى عنوان نتحكم فيه. أما Tron وBitcoin وLitecoin وSolana وTON وXRP Ledger فلكلٍّ منها نوع عناوين خاص بها. وعلى تلك الشبكات، يشمل ذلك عملة مختلفة على الشبكة نفسها، مثل TRX المرسلة إلى فاتورة بعملة USDT على Tron.
متى تُحتسب تلقائيًا
تُحتسب الدفعة للفاتورة تلقائيًا عندما يتحقق الشرطان التاليان معًا:
- لم يُدفع أي شيء آخر على الفاتورة بعد؛
- تغطي العملات مبلغ الفاتورة، ضمن هامش التسامح للدفع الناقص الخاص بك.
عندئذٍ تتحول الفاتورة إلى العملة التي أُرسلت فعلًا. وتُخبر صفحة الفاتورة العميل بالعملة التي دفع بها بدلًا من العملة المطلوبة. وترى أنت العملة المطلوبة على الدفعة وفي رسالة البريد الإلكتروني الخاصة بالدفعة. وفي API، يكون coin هو ما دُفع، وrequested_coin هو ما طلبته الفاتورة.
تُقيَّم العملات على النحو التالي:
- العملات المستقرة مثل USDT وUSDC تُحتسب كل منها بدولار أمريكي واحد؛
- العملة نفسها على شبكة أخرى، مثل ETH على Base لفاتورة بعملة ETH على Ethereum، تحتفظ بالسعر الذي عُرض على العميل؛
- أي عملة أخرى تُقيَّم بسعر السوق وقت وصولها.
ويعمل هذا مع المدفوعات المتأخرة أيضًا: عندما تكون الفاتورة قد انتهت صلاحيتها لكن عنوانها لا يزال قيد المراقبة، وذلك لمدة 24 ساعة على الأقل.
المبالغ الأصغر والرموز المميزة العشوائية
أي شيء آخر لا يغيّر الفاتورة أبدًا: دفعة جزئية بعملة أخرى، أو عملة ثانية على فاتورة لديها دفعة بالفعل، أو رمز مميز عشوائي. يُضاف إلى رصيدك مثل دفعة بلا فاتورة، بعد خصم رسوم 1%، وتُبلغك تذكرة دعم بذلك، لتتمكن من تسويته مع العميل. ولا يمكن لرمز مميز ضئيل يُرسل إلى العنوان أن يستحوذ على فاتورة.
وتُعالج الدفعة المتأخرة إلى فاتورة ملغاة أو مستردة بالطريقة نفسها: تُضاف إلى رصيدك، وتتلقى تذكرة.
ما الذي قد يضيع رغم ذلك
العملات على شبكة أو بعملة لا تدعمها Crypto Merchant، والعملات المرسلة إلى أي عنوان غير عنوان الفاتورة، لا يمكن احتسابها وقد تضيع إلى الأبد. لذا يجب على العملاء مع ذلك إرسال العملة المعروضة، على الشبكة المعروضة.
الفواتير المدفوعة دفعًا ناقصًا
تحدد هامش تسامح للدفع الناقص في إعداداتك؛ ونوصي بـ 1 US$ على الأقل. إذا كان النقص في دفعة مؤكدة لا يتجاوز هامش التسامح، تُعدّ الفاتورة مدفوعة.
إذا كان النقص أكبر من ذلك، تصبح حالة الفاتورة دفع ناقص. ويُحتفظ بما أُرسل لصالح العميل، الذي يمكنه إما إرسال الباقي إلى العنوان نفسه أو استرداد ما أرسله إلى عنوان يُدخله. تُخصم رسوم الشبكة للاسترداد من مبلغ الاسترداد.
الفواتير المدفوعة دفعًا زائدًا
إذا أرسل العميل أكثر مما تطلبه الفاتورة، تُعدّ الفاتورة مدفوعة رغم ذلك. ويعتمد مصير المبلغ الزائد على قيمته:
- تُعدّ الفاتورة مدفوعة، ويُحتفظ بالمبلغ الزائد لصالح العميل. ويمكنه سحبه إلى محفظته الخاصة من صفحة الفاتورة، مخصومًا منه رسوم الشبكة لإرساله.
- وإلى أن يفعل ذلك، تحتفظ به Crypto Merchant لصالحه. ولا يُضاف إلى رصيد النشاط التجاري، ولا يُؤخذ أبدًا كرسوم.
الاسترداد بعد الدفع
يمكنك إعادة الأموال على دفعة مدفوعة، مثلًا عند إرجاع منتج أو إلغاء طلب. افتح الدفعة في البوابة واستخدم استرداد هذه الدفعة. لا يمكن القيام بذلك إلا للمسؤولين، وعليهم أولًا تأكيد هويتهم برمز جديد من بريدهم الإلكتروني أو تطبيق المصادقة.
- يمكنك استرداد أي مبلغ حتى ما احتفظت به من تلك الدفعة: ما أُضيف إليك بعد رسوم 1%، مطروحًا منه الاستردادات السابقة وروابط الاسترداد التي لا تزال مفتوحة. ورسوم 1% لا تُسترد.
- يُحجز المبلغ من رصيدك فورًا، حتى لا يُصرف عن طريق الخطأ في الأثناء.
- إذا كانت الدفعة تتضمن البريد الإلكتروني للعميل، فسيتلقى رسالة بريد إلكتروني تحتوي على رابط خاص. ويمكنك أيضًا نسخ الرابط وإرساله بنفسك.
- يفتح العميل الرابط، ويُدخل عنوانه الخاص لتلك العملة والشبكة، ويحدد خانة التأكيد ثم يرسل. يُرسل الاسترداد من محفظة المجمّع الخاصة بك، وتُخصم رسوم الشبكة من مبلغ الاسترداد.
- يبقى الرابط مفتوحًا لمدة 14 يومًا. إذا لم يطالب به العميل في الوقت المحدد، أو ألغيته أنت، يعود المبلغ إلى رصيدك تلقائيًا. ويمكن المطالبة بكل رابط مرة واحدة.
الاسترداد الجزئي يُبقي الدفعة مدفوعة ويعرض المبلغ المسترد. واسترداد كل ما احتفظت به يجعلها مستردة. كل مطالبة ترسل Webhook باسم invoice.refunded، ويعرض كائن الفاتورة الإجمالي في refunded_amount.
لأن العميل يكتب العنوان في صفحة الاسترداد، لا يحتاج أحد إلى تبادل العناوين في محادثة، حيث قد يؤدي خطأ مطبعي أو منتحل إلى إرسال العملات إلى المكان الخطأ. تحويلات العملات المشفرة لا يمكن عكسها، لذا يجب على العميل إدخال عنوان يتحكم فيه، على الشبكة المعروضة.
لا تزال الفواتير المدفوعة دفعًا ناقصًا تتيح للعميل خيار الاسترداد الخاص بها في صفحة الفاتورة، ولا يزال بإمكان العملاء سحب الدفعة الزائدة من هناك، كما هو موضح أعلاه. والحصص المحجوزة بالفعل لشركاء تقاسم الإيرادات لا تُستعاد عند الاسترداد.
الرسوم
تُخصم 1% من كل فاتورة مدفوعة عند إضافة الدفعة إلى رصيدك. الفواتير المنتهية الصلاحية والملغاة لا تكلّف شيئًا.
لا توجد رسوم إضافية عندما تُحتسب دفعة بعد وصولها بعملة أخرى أو على شبكة أخرى. عندما تسترد دفعة، لا تُعاد رسوم 1%، وتُخصم رسوم الشبكة الخاصة بالاسترداد من مبلغ الاسترداد.
يشمل المبلغ المستحق أيضًا رسوم غاز لنقل تلك الدفعة إلى محفظة المجمّع الخاصة بك، ولا تتجاوز أبدًا 5 US$. وعلى معظم الشبكات تبلغ بضعة سنتات. أما USDT على Tron فتكلفته أعلى، لأن Tron تحرق الطاقة مع كل تحويل لرمز مميز. تعرض صفحة الدفع الرسوم بجانب السعر، وتُعيدها API باسم network_fee_amount وnetwork_fee_usd. وهي تغطي تجميع تلك الدفعة، وليست من إيراداتك، ولا تُخصم منها أي رسوم دفع.