ما هي بوابة الدفع بالعملات المشفرة وكيف تعمل

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

ماذا تفعل بوابة الدفع بالعملات المشفرة

قبول العملات المشفرة دون بوابة يعني أن تعطي كل عميل عنوان محفظة وأن تراقب البلوكشين بنفسك وتطابق التحويلات الواردة مع الطلبات وتعالج كل حالة خاصة يدويًا. تتولى البوابة أربع مهام:

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

البوابة ليست محفظة تملك أنت مفاتيحها وليست بورصة. إنها بنية تحتية للدفع: الجزء من الدفع بالبطاقة الذي يخفيه عنك البنك والمعالج عادةً، معاد بناؤه للبلوكشين.

كيف تمر الدفعة عبر البوابة

تعمل كل بوابة بشكل مختلف قليلًا، لكن مسار الدفعة الواحدة يبدو هكذا:

ينشئ خادمك دفعة: رقم الطلب والمبلغ، عادةً بالدولار.
يفتح العميل صفحة الدفع ويختار أصلًا وشبكة، مثل USDT على TRON. ويمكن للتاجر أيضًا اختيار الطريقة مسبقًا.
تثبّت البوابة سعر الصرف لمدة محدودة، فلا يتغير المبلغ المطلوب إرساله أثناء الدفع. في Qvard يُثبَّت السعر لمدة ساعة.
يرسل العميل المبلغ الدقيق من محفظته إلى العنوان المعروض لتلك الدفعة.
تراقب البوابة الشبكة وتنتظر التأكيدات وتضع علامة «مدفوع» على الدفعة.
تُبلغ خادمك. تضع شيفرتك علامة «مدفوع» على الطلب وتسلّم البضاعة.
يظهر المال في رصيد التاجر لديك. تسحبه إلى محفظتك يدويًا أو بقاعدة تحددها.

لا تسير المدفوعات الحقيقية دائمًا على نحو مثالي: يرسل العملاء أقل أو أكثر أو بعد انتهاء صلاحية السعر. للبوابة الجيدة حالة محددة لكل وضع بدل أن تترك لك المطابقة اليدوية. في Qvard حالات الدفعة هي wait وpartial وcompleted وrejected.

البوابة والمحفظة والبورصة والمعالج: ما الفرق

كثيرًا ما تختلط هذه المصطلحات:

المحفظة. تحفظ المفاتيح وتتيح الإرسال والاستلام. لا تطابق المدفوعات مع الطلبات ولا تبلغ متجرك.
البورصة. تبدّل أصلًا بآخر. بعضها يقدم أدوات للتجار، لكن وظيفتها الرئيسية التداول.
بوابة الدفع. تنشئ المدفوعات لطلباتك وتتتبعها وتبلغ بحالتها. هذا موضوع هذا الدليل.
المعالج أو الجهة المستحوِذة. في مدفوعات البطاقات، الشركة التي تنقل المال بين البنوك. وفي العملات المشفرة تُستخدم كلمة «acquiring» بتساهل للخدمة كلها؛ راجع الـ acquiring للعملات المشفرة مقابل بوابة الدفع لفهم الفرق.

الحفظ لدى المزود أم الحفظ الذاتي

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

في البوابة ذات الحفظ لدى المزود (custodial) تذهب المدفوعات الواردة إلى عناوين يتحكم بها المزود وتُقيَّد في رصيد التاجر لديك. بعد ذلك تسحبها. هذا يبسّط المطابقة ويتيح ميزات مثل السحب التلقائي، لكنك تعتمد على المزود حتى تسحب، لذلك تهمّ شروط السحب لديه.

في النموذج ذي الحفظ الذاتي (non-custodial) تذهب المدفوعات مباشرة إلى محفظتك. تحتفظ أنت بالمفاتيح ويتتبع المزود الدفعة فقط. هذا يقلل مخاطر الطرف المقابل وينقل إدارة المفاتيح إليك.

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

العملات المستقرة والشبكات: لماذا تهمّ الشبكة

قد يوجد الأصل نفسه على عدة بلوكشينات. فمثلًا USDT موجود على TRON (TRC-20) وEthereum (ERC-20) وBNB Smart Chain (BEP-20). لا يصح التحويل إلا على الشبكة التي طلبتها صفحة الدفع، وتختلف الرسوم والسرعة من شبكة إلى أخرى.

لهذا تعرض البوابة الأصل والشبكة معًا، ويجب أن يكون اختيار العميل صريحًا. وبالنسبة للتاجر فالنتائج العملية هي:

حدّد الشبكات التي تريد قبولها وتأكد أن البوابة تدعمها؛
توقّع أن تعتمد رسوم الشبكة على السلسلة ودرجة ازدحامها لا على البوابة؛
فضّل العملات المستقرة للتسعير بالدولار، لأن الدفع بأصل متقلب قد تقل قيمته كثيرًا عند السحب.

يقبل Qvard حاليًا USDT وUSDC على الشبكات الرئيسية، إضافة إلى BTC وLTC الأصليتين؛ وTON قريبًا. القائمة الكاملة في صفحة العملات والشبكات المدعومة.

ما الذي تتحقق منه قبل اختيار بوابة

قائمة قصيرة تفرّق بين بوابة صالحة وأخرى محفوفة بالمخاطر:

الشبكات والأصول. هل تدعم ما يستخدمه عملاؤك فعلًا؟
الرسوم. ما الذي تتقاضاه البوابة، وما رسوم الشبكة المنفصلة؟ ومن يدفع كلًّا منهما؟
الأموال والسحب. من يحتفظ بالمال، وكيف يعمل السحب، وهل هناك حدود أو خيارات بالعملة الورقية قد تحتاجها؟
جودة واجهة API. هل يمكن إنشاء دفعة بأمان أكثر من مرة بنفس رقم الطلب؟ هل الأخطاء واضحة؟ هل يُعاد إرسال webhook إذا كان خادمك متوقفًا؟
المدفوعات غير المعتادة. كيف تُعالَج الدفعة الناقصة والزائدة والمنتهية الصلاحية؟
الاختبار. هل يمكن تجربة المسار دون تحريك مال حقيقي؟
الدعم والتوثيق. من يجيب حين تتعثر دفعة؟

كيف تختار مزود مدفوعات بالعملات المشفرة يستعرض هذه القائمة بمزيد من التفصيل.

كيف يبدو الحد الأدنى من التكامل

إنشاء دفعة هو طلب واحد. مع Qvard ترسل رقم طلبك الخاص والمبلغ بالدولار الأمريكي، فتتلقى معرّف الدفعة ورابطًا إلى صفحة الدفع المستضافة. وجّه العميل إليها؛ وكل ما يخص اختيار الأصل وإرسال التحويل يتم في تلك الصفحة.

المعرّف id الذي ترسله هو رقم طلبك: إعادة إرسال id نفسه لطريقة الدفع نفسها تُرجع الدفعة الموجودة بدل إنشاء نسخة مكررة، مما يجعل إعادة المحاولة آمنة. عندما يدفع العميل يرسل Qvard إلى خادمك webhook يحمل id نفسه وحالة الدفعة. المسار الكامل مع شيفرة لواجهتك الخلفية في كيف تقبل المدفوعات بالعملات المشفرة على موقع إلكتروني، والمرجع في صفحة المطورين.

curlPOST /api/v1/payment

curl -X POST https://api.qvard.com/api/v1/payment \
  -H "x-api-key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "id": "order_1024", "price": 149.99 }'

# 201 Created
{ "id": "8f3k2a1c", "redirectUrl": "https://my.qvard.com/pay/8f3k2a1c" }

أخطاء شائعة

الوثوق بإعادة التوجيه. عودة العميل إلى صفحة «شكرًا» لديك لا تثبت أنه دفع. ضع علامة «مدفوع» على الطلب فقط عندما تبلّغ البوابة بحالة نهائية.
تجاهل المدفوعات الجزئية. إذا أرسل العميل أقل من المبلغ فالطلب غير مدفوع. حدّد مسبقًا هل تطلب الفرق أم تردّ المال.
عدم اختبار إعادة محاولة webhook. إذا ردّ خادمك بخطأ على webhook فيجب إعادة إرسال الإشعار، ويجب أن يتعامل معالجك بسلاسة مع وصول الحدث نفسه مرتين.
التسعير بأصل متقلب. سعّر بالدولار ودع العميل يدفع بعملة مستقرة إذا لم تستطع تحمّل مخاطر السعر.
عدم اختبار مسار السحب. اسحب مبلغًا صغيرًا قبل أن تعتمد على البوابة لإيرادات حقيقية.

أين يندرج Qvard

Qvard بوابة دفع بالعملات المشفرة من نوع custodial للأعمال. اليوم تنشئ دفعة عبر واجهة API وتوجّه العميل إلى صفحة الدفع المستضافة وتتلقى الحالة النهائية عبر webhook وتسحب من رصيد التاجر إلى محفظة. أما الطرق الأخرى لقبول الدفع مثل روابط الدفع والنافذة المدمجة وSDK ونقطة البيع فهي قيد التطوير. يمكنك رؤية صفحة الدفع الحقيقية بـفاتورة تجريبية قبل إنشاء حساب، وتشرح صفحة الأسعار كيف تعمل الرسوم.

FAQ

هل بوابة الدفع بالعملات المشفرة هي نفسها محفظة العملات المشفرة؟

لا. المحفظة تحفظ المفاتيح وترسل التحويلات. أما البوابة فتنشئ دفعة لطلب محدد وتتتبعها على البلوكشين وتبلغ متجرك بحالتها وتحتفظ بالمال في رصيد التاجر حتى تسحبه.

هل يمكن التراجع عن دفعة بالعملات المشفرة؟

لا. التحويل المؤكد على البلوكشين نهائي. إذا احتجت إلى رد مبلغ لعميل فإنك ترسل تحويلًا جديدًا بنفسك، لذا حدّد سياسة الاسترداد قبل أن تبدأ قبول المدفوعات.

كم يستغرق تأكيد الدفعة؟

يعتمد ذلك على الشبكة وعلى عدد التأكيدات التي تنتظرها البوابة. بعض الشبكات تؤكد خلال ثوانٍ، بينما ينتج Bitcoin كتلة تقريبًا كل عشر دقائق. تعرض صفحة الدفع الحالة بينما ينتظر العميل.

هل أحتاج إلى بناء شيء من جهتي؟

تحتاج إلى إنشاء الدفعة من واجهتك الخلفية ومعالجة webhook الذي يبلّغ بحالتها. كل ما عدا ذلك، من صفحة الدفع إلى مراقبة البلوكشين، تتولاه البوابة.

ما هي بوابة الدفع بالعملات المشفرة؟