كيفية دمج بوابة دفع بالعملات الرقمية بنظام White Label مع OxaPay

إن دمج بوابة دفع بالعملات الرقمية بنظام White Label لا يقتصر على الاتصال بـ API. بل يعني إضافة تدفق دفع كامل بالعملات الرقمية إلى موقعك الإلكتروني أو تطبيقك مع الحفاظ على التحكم في تجربة العميل.

مع OxaPay White Label، يمكن لشركتك عرض عنوان الدفع ورمز QR والمبلغ والشبكة وحالة الدفع داخل واجهتها الخاصة. وفي الوقت نفسه، تتولى OxaPay إدارة البنية التحتية الأساسية للدفع، بما في ذلك إنشاء الدفعات و مراقبة البلوكشينوتحديثات المعاملات.

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

في هذا الدليل نشرح كيفية دمج بوابة OxaPay White Label، وما الذي تحتاج إليه شركتك قبل البدء، وما حالات الدفع التي ينبغي أخذها في الاعتبار قبل الإطلاق.

هل White Label مناسب لشركتك؟

قبل بدء الدمج، من المهم تحديد ما إذا كان حل White Label هو الخيار المناسب لتدفق الدفع لديك.

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

يكون White Label أكثر ملاءمة عندما تكون تجربة الدفع جزءًا مهمًا من منتجك أو رحلة العميل. فبدلًا من إعادة توجيه العملاء إلى صفحة دفع خارجية، تعرض معلومات الدفع داخل موقعك أو تطبيقك أو منصتك أو صفحة الدفع الخاصة بك.

هذا الحل مفيد بشكل خاص للشركات التي تريد:

• الحفاظ على اتساق العلامة التجارية طوال عملية الدفع
• إبقاء العملاء داخل منصتها
• التحكم في كيفية عرض تعليمات الدفع وحالاته
• ربط مدفوعات العملات الرقمية بعملية الطلب الحالية
• تجنب بناء بنية تحتية لمدفوعات البلوكشين من الصفر

الفرق الرئيسي هو مستوى التحكم. تدير شركتك التجربة التي يراها العميل، بينما تدير OxaPay البنية التحتية للدفع في الخلفية.

ما الذي تحتاج إليه قبل البدء

يتطلب دمج White Label بعض التحضير، لكن شركتك لا تحتاج إلى تشغيل عقد بلوكشين أو بناء نظام خاص بها لمراقبة المعاملات.

يجب أن يحتوي موقعك أو تطبيقك على backend يمكنه التواصل بأمان مع API الخاصة بـ OxaPayوتخزين معلومات الدفع وربط كل دفعة بالطلب الصحيح.

تحتاج أيضًا إلى callback endpoint يمكنه استقبال تحديثات الدفع من OxaPay. تسمح هذه التحديثات لنظامك بمعرفة متى بدأ العميل في الدفع ومتى اكتمل الدفع.

وأخيرًا، ينبغي أن تكون واجهة الدفع قادرة على عرض التفاصيل الأساسية مثل:

• مبلغ الدفع
• العملة الرقمية المحددة
• شبكة البلوكشين
• عنوان الدفع
• رمز QR
• الوقت المتبقي للدفع
• أحدث حالة للدفع

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

دمج بوابة دفع بالعملات الرقمية White Label مع OxaPay

1. إنشاء حساب Merchant على OxaPay

الخطوة الأولى هي إنشاء حساب OxaPay والدخول إلى لوحة تحكم Merchant.

من لوحة التحكم يمكنك إدارة Merchant API Key وإعدادات الدفع والعملات المدعومة وسجلات المعاملات وأدوات Merchant الأخرى.

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

2. إنشاء Merchant API Key

بعد ذلك أنشئ Merchant API Key من حسابك على OxaPay.

تسمح هذه المفتاح لنظامك بمصادقة طلبات الدفع المرسلة إلى API الخاصة بـ OxaPay. ويجب دائمًا تخزينها بأمان على خادم backend لديك.

يجب عدم وضع Merchant API Key في كود frontend أو المستودعات العامة أو سكربتات المتصفح أو أي مكان آخر يمكن للعملاء الوصول إليه.

يجب أن يستخدم backend المفتاح عند إنشاء طلبات دفع White Label. أما frontend فيجب أن يستقبل فقط معلومات الدفع اللازمة لعرضها للعميل.

3. إنشاء طلب دفع White Label

لإنشاء دفعة White Label، يرسل نظامك طلبًا إلى الـ endpoint التالي:

POST https://api.oxapay.com/v1/payment/white-label

حقلا الدفع الإلزاميان هما:

• المبلغ: قيمة الدفع
• pay_currency: العملة الرقمية المستخدمة للدفع

يمكن إضافة حقول أخرى بحسب تدفق الدفع لديك.

على سبيل المثال:

• currency يحدد العملة المستخدمة لتسعير الطلب، مثل USD.
• الشبكة يحدد شبكة البلوكشين عندما تكون العملة الرقمية متاحة على عدة شبكات.
• order_id يربط الدفعة بطلب في نظامك.
• callback_url يخبر OxaPay بمكان إرسال تحديثات الدفع.
• lifetime يحدد المدة التي تبقى خلالها الدفعة صالحة.
• under_paid_coverage يحدد الفرق المقبول بين المبلغ المطلوب والمبلغ المستلم.

دليل currency, الشبكة, order_id، و callback_url اختيارية في API. ومع ذلك، يوصى بشدة باستخدام order ID وcallback URL للشركات التي تحتاج إلى تتبع موثوق للطلبات.

عندما ينجح الطلب، تنشئ OxaPay جلسة دفع وتعيد المعلومات التي يحتاج إليها نظامك لعرض عملية الدفع.

4. استلام معلومات الدفع وعرضها

بعد إنشاء طلب الدفع، تعيد OxaPay معلومات دفع منظمة.

وقد تتضمن:

• معرّفًا فريدًا track_id
• مبلغ الدفع الدقيق
• العملة الرقمية المستخدمة للدفع
• شبكة البلوكشين
• عنوان الدفع
• رمز QR
• وقت انتهاء الصلاحية

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

بعد ذلك يمكن للـ frontend استخدام المعلومات المعادة لإنشاء صفحة دفع تحمل علامتك التجارية.

يجب أن يتمكن العميل من:

• مسح رمز QR
• نسخ عنوان الدفع
• نسخ المبلغ الدقيق
• رؤية العملة الرقمية والشبكة المطلوبتين
• معرفة الوقت المتبقي
• متابعة الحالة الحالية للدفع

هذه هي الميزة الأساسية لنموذج White Label. يكمل العميل الدفع داخل تجربة صممتها شركتك وتحمل علامتها التجارية.

يجب أن تحذر صفحة الدفع العملاء أيضًا من إرسال أموال بعد انتهاء صلاحية الدفع. ووفقًا لوثائق OxaPay، تكون عناوين White Label التي تم إنشاؤها صالحة فقط خلال lifetime المحددة للدفع.

5. تتبع حالة الدفع

بعد أن يرسل العميل العملة الرقمية، تراقب OxaPay الدفعة وتبلغ عن تقدمها.

حالات الدفع في OxaPay قد تشمل حالات مثل:

• في انتظار الدفع
• الدفع قيد التنفيذ
• paid
• underpaid
• expired
• مقبول يدويًا
• refunded

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

النقطة المهمة هي ألا يكمل نظامك الطلب مبكرًا جدًا.

ترسل OxaPay تحديثًا paying عند اكتشاف نشاط دفع. ويجب على نظامك عادةً انتظار الحالة النهائية paid قبل تسليم المنتج أو تفعيل الخدمة أو وضع علامة أن الطلب مكتمل.

6. استقبال تحديثات الدفع والتحقق منها

ترسل OxaPay تحديثات الدفع إلى callback_url المضمّن في طلب الدفع.

تسمح هذه الإشعارات لنظامك بما يلي:

• تحديد الدفعة المرتبطة
• تحديث حالة الطلب الداخلية
• إبلاغ العميل بالتقدم
• إكمال الطلب بعد نجاح الدفع

نظرًا إلى أن callback endpoint متاح للعامة، يجب على نظامك التحقق من الإشعارات الواردة قبل اتخاذ أي إجراء.

توفر OxaPay توقيعًا أمنيًا مع callbacks الخاصة بها. يجب على فريقك التقني التحقق من هذا التوقيع والتأكد من أن معلومات الدفع تطابق تفاصيل الطلب المخزنة.

لا يلزم أن يكون ذلك ظاهرًا للعميل، لكنه جزء مهم من حماية عملية الدفع.

يجب أن يكون نظامك مستعدًا أيضًا لاستقبال التحديث نفسه أكثر من مرة. يجب ألا يؤدي callback مكرر إلى تسليم المنتج مرتين أو إضافة الرصيد مرتين أو تأكيد الطلب عدة مرات.

قد تعيد OxaPay محاولة إرسال callback إذا لم يؤكد نظامك بنجاح استلامه.

معالجة الدفع الناقص

قد يرسل العميل أحيانًا مبلغًا أقل من مبلغ الدفع المطلوب.

توفر OxaPay خيار تحمل الدفع الناقص، ما يسمح للـ Merchant بتحديد فرق مقبول بين المبلغ المتوقع والمبلغ المستلم.

إذا كان الفرق ضمن النطاق المقبول، يمكن أن تستمر الدفعة وفق السياسة المضبوطة. وإذا كان المبلغ دون الحد المقبول، فقد تتطلب الدفعة إجراءً آخر.

بحسب نموذج عملك، يمكنك:

• طلب إكمال المبلغ المتبقي من العميل
• مراجعة الدفعة يدويًا
• قبول الدفعة وفق سياسة داخلية
• إلغاء الطلب أو رد المبلغ عندما يكون ذلك مناسبًا

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

7. اختبار تدفق الدفع بالكامل

قبل إطلاق الدمج، اختبر رحلة العميل بالكامل من إنشاء الدفعة حتى إكمال الطلب.

يجب أن تشمل اختباراتك:

• إنشاء الدفعة بنجاح
• عرض العنوان ورمز QR بشكل صحيح
• دقة معلومات مبلغ الدفع والشبكة
• تحديثات حالة الدفع
• إكمال الطلب بنجاح
• المدفوعات منتهية الصلاحية
• حالات الدفع الناقص
• إشعارات الدفع المكررة
• تحديثات الدفع المتأخرة

يجب أيضًا التحقق من طريقة عمل صفحة الدفع على الأجهزة المحمولة. سيقوم كثير من العملاء بمسح رمز QR من جهاز آخر أو نسخ العنوان مباشرة إلى محفظة على الهاتف.

لا يكفي اختبار طلب API الأول فقط. يجب أن تعمل عملية الطلب كاملة، بما في ذلك تحديثات الدفع والتنفيذ، بشكل موثوق قبل إتاحة الدمج للعملاء.

اعتبارات مهمة للدمج

تعتمد تجربة دفع White Label الموثوقة على بعض التفاصيل العملية.

معالجة انتهاء الصلاحية

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

اختيار الشبكة الصحيحة

إذا كانت العملة الرقمية مدعومة على أكثر من شبكة، فاعرض الشبكة المحددة بوضوح.

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

تعليمات دفع واضحة

يجب أن يفهم العملاء فورًا:

• أي عملة رقمية يجب إرسالها
• أي شبكة يجب استخدامها
• المبلغ المطلوب إرساله
• إلى أين يرسلونه
• مدة بقاء الدفع صالحًا
• ما الذي يحدث بعد الدفع

تقلل صفحة الدفع الواضحة من الالتباس وتوفر تجربة checkout أكثر موثوقية.

تدفق دمج White Label

يمكن تلخيص العملية كاملة في سبع خطوات:

1. ينشئ نظامك طلبًا داخليًا.
2. يرسل backend طلب دفع White Label إلى OxaPay.
3. تعيد OxaPay تفاصيل الدفع.
4. يعرض موقعك أو تطبيقك الدفعة داخل واجهته الخاصة.
5. يرسل العميل العملة الرقمية المطلوبة.
6. تراقب OxaPay المعاملة وترسل تحديثات الدفع.
7. يؤكد نظامك الدفعة ويكمل الطلب.

الخلاصة

يتيح دمج بوابة OxaPay White Label للدفع بالعملات الرقمية للشركة التحكم في تجربة الدفع دون بناء البنية التحتية الأساسية للبلوكشين بنفسها.

تتولى OxaPay إنشاء الدفعات ومراقبة المعاملات وتحديثات الدفع. وتتحكم شركتك في العلامة التجارية وواجهة العميل وإدارة الطلبات والتنفيذ النهائي.

الفكرة بسيطة: شركتك تملك تجربة العميل، بينما توفر OxaPay البنية التحتية للدفع التي تعمل خلفها.

مع صفحة دفع واضحة وتتبع موثوق للحالة واختبارات مناسبة، يمكن لدمج White Label أن يوفر للعملاء تجربة دفع متسقة بالعملات الرقمية تظل متصلة بالكامل بموقعك أو تطبيقك.