كيف تضيف مدفوعات العملات الرقمية إلى متجر إلكتروني

قرر أولًا

أربعة قرارات توفر إعادة العمل لاحقًا.

1. أي أصول وشبكات. ابدأ صغيرًا: USDT وUSDC تغطيان معظم العملاء. تدعم Qvard عملات USDT وUSDC وBTC وLTC وTRX وBNB وETH على شبكات TRC20 وERC20 وBEP20 وBitcoin وLitecoin.
2. السعر بالدولار. أبقِ أسعارك كما هي. تُنشأ الدفعة بالدولار الأمريكي ويظهر المبلغ الدقيق بالعملة الرقمية في صفحة الدفع، مع سعر صرف ثابت لمدة ساعة.
3. ما الذي يطلقه الطلب المدفوع. الشحن، مفتاح ترخيص، الوصول إلى محتوى. قرر ما يحدث لحظة اكتمال الدفعة.
4. ماذا تفعل عندما يسوء شيء ما. دفعات ناقصة، مردودات، عميل دفع عبر شبكة خاطئة. اكتب القاعدة الآن.

خطوات التكامل

ليس لدى Qvard إضافات جاهزة للمتاجر بعد، لذا يتكامل المتجر عبر الـ API. وهذا قطعتان من كود الخادم.

1. أنشئ دفعة عندما يختار العميل العملات الرقمية. طلب POST إلى https://api.qvard.com/api/v1/payment برقم طلبك كـ id وإجمالي الطلب بالدولار الأمريكي كـ price، مع المصادقة بمفتاح API الخاص بك. تحتوي الاستجابة على redirectUrl؛ وجّه العميل إليه.
2. استقبل النتيجة. احفظ عنوان callback في لوحة التحكم. عند اكتمال الدفعة ترسل Qvard طلب POST يحمل رقم طلبك والحالة. ضع علامة «مدفوع» على الطلب وابدأ التنفيذ. أجب بـ HTTP 200 بالضبط.
3. اجعل المعالج آمنًا. قد يُسلَّم أكثر من مرة، لذا يجب ألا يغيّر التكرار شيئًا.

النسخ التفصيلية: كيف تقبل مدفوعات العملات الرقمية على موقع للتدفق العام، وWordPress وWooCommerce لتلك المنصات، وواجهة API لمدفوعات العملات الرقمية للمطورين كمرجع.

اربط الحالات بحالات طلبك

للدفعة أربع حالات: wait وpartial وcompleted وrejected. يحتاج طلبك إلى حالات مقابلة، ولا يصل webhook إلا مع completed.

• طلب منشأ وغير مدفوع يقابل wait.
• الدفعة الناقصة تقابل partial: أبقِ الطلب معلّقًا واطلب من العميل الفرق.
• الطلب المدفوع يقابل completed: نفّذه.
• rejected: اعتبر الدفعة فاشلة ودع العميل يعيد المحاولة.

الربط الكامل مع الكود موجود في مدفوعات العملات الرقمية للتجارة الإلكترونية.

الصياغة في صفحة الدفع

معظم تذاكر الدعم عن العملات الرقمية تأتي من صياغة غير واضحة. في خطوة الدفع:

• اذكر العملات والشبكات المقبولة؛
• قل إن المبلغ يجب أن يُرسَل كاملًا وعبر الشبكة الظاهرة في صفحة الدفع؛
• اذكر أن سعر الصرف ثابت لمدة ساعة؛
• اشرح كيف تعمل المردودات وأين يُطلب العون.

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

الاختبار والإطلاق

لا توجد بيئة sandbox بعد، لذا اختبر بمبالغ حقيقية صغيرة.

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

بعد الإطلاق حافظ على روتين قصير؛ القائمة في قائمة فحص تشغيلية لمدفوعات العملات الرقمية. التكلفة: لا رسوم اشتراك، والعمولة، وهي فردية لمشروعك، تبدأ من 1% ويمكن أن تنخفض إلى 0.1% بحسب صفحة الأسعار.

FAQ