ملخص قصير لواجهة HissPay البرمجية للتجار. المرجع الكامل هو التوثيق الرسمي v1.13.0 (2026-10-27)، المنشور حاليًا باللغة الصينية المبسطة.
التوثيق الكامل والمحدّث للتكامل هو https://mch.hisspay.com/docs/ (v1.13.0 · 2026-10-27، يُحدَّث باستمرار). هذه الصفحة ملخص فقط، وعند أي اختلاف يُعتمد التوثيق الرسمي.
توفر HissPay واجهات التحصيل (من عملائك) والدفع (إلى حساب مستفيد) عبر HTTPS POST مع جسم JSON. بوابة الإنتاج: https://transaction.hisspay.com؛ بوابة بيئة الاختبار: https://sandbox-api.hisspay.com.
| العملية | المسار |
|---|---|
| إنشاء طلب تحصيل | POST /transaction/payin/v1/apply |
| الاستعلام عن طلب تحصيل | POST /transaction/payin/v1/query |
| إنشاء طلب دفع | POST /transaction/payout/v1/apply |
| الاستعلام عن طلب دفع | POST /transaction/payout/v1/query |
| الاستعلام عن الرصيد | POST /transaction/payout/v1/balance |
العملات في كتالوج المنتجات: AUD, EUR, GBP, INR, JPY, THB, USD, USDT. وجود المنتج في الكتالوج لا يعني تفعيله لحسابك: رموز المنتجات ونطاقات المبالغ والرسوم تُرسل في إشعار التفعيل.
قبل التكامل: أن يكون حساب التاجر معتمدًا؛ وأن تنشئ تطبيق API في بوابة التاجر (mch.hisspay.com ← مفاتيح التطبيق) وتحصل على appId وappSecret؛ وأن تتعاقد على منتجات التحصيل والدفع؛ وأن تُضاف عناوين IP العامة الصادرة لخادمك إلى القائمة البيضاء للدفع؛ وأن يتوفر عنوان HTTPS عام للإشعارات. اختبر كل شيء أولًا في بيئة الاختبار.
يحمل كل طلب الرؤوس appId وtimestamp (بالمللي ثانية، بفارق لا يتجاوز 30 ثانية عن وقت المنصة) وnonce (10 أحرف على الأقل، لا يُعاد استخدامه) وsign. قيمة sign هي SHA-256 بصيغة سداسية عشرية صغيرة لحقول الجسم مع appId وtimestamp وnonce، مرتبة بالاسم كأزواج key=value مفصولة بـ &، ثم يُلحق appSecret مباشرة في النهاية. ليست HMAC. لا ترسل قيم null، ولا تضع appSecret في متصفح أو تطبيق.
ينشئ POST /transaction/payin/v1/apply طلب تحصيل ويعيد payUrl للدافع. أكّد الدفع فقط من إشعار تم التحقق من توقيعه أو من الاستعلام، وليس من صفحة العودة في المتصفح.
يُعالَج POST /transaction/payout/v1/apply بشكل غير متزامن: code=0 يعني القبول وليس إتمام الدفع. انتهاء المهلة أو الرمز 500 يعني أن النتيجة غير مؤكدة: استعلم أولًا عن الطلب الأصلي واتبع قواعد المعالجة في التوثيق الكامل قبل إعادة إرسال أي طلب.
يستخدم تحصيل USDT القيمة currency=USDT ورمز منتج خاصًا بالشبكة تخصصه المنصة؛ المبالغ بحد أقصى 4 منازل عشرية. تُؤكَّد النتيجة بالإشعار أو الاستعلام.
تايلاند (THB): تحصيل عبر رمز PromptPay QR ودفع بالتحويل البنكي في تايلاند. رموز البنوك للتحصيل: SCB, KBANK, KTB, BAY, GSB, TTB؛ وللدفع: SCB, KBANK, KTB, BAY, GSB, TTB, BBL (البنوك المتاحة لحسابك مذكورة في إشعار التفعيل). النطاق الافتراضي لكل عملية: 500.00–49999.00 THB.
يقبل POST /transaction/payin/v1/query وPOST /transaction/payout/v1/query القيمة merchantOrderNo أو orderNo. الحد 5 استعلامات في الثانية لكل appId؛ استعلم كل 3–5 ثوانٍ مع التباطؤ التدريجي.
يعيد POST /transaction/payout/v1/balance لكل عملة balance (الدفتري) وbalanceActive (المتاح) وbalanceFreeze (المجمّد).
ترسل المنصة طلب POST بصيغة JSON إلى notifyUrl مع رؤوس التوقيع الأربعة نفسها. تحقّق من التوقيع، وعالج الطلب بشكل متكرر الأمان لكل طلب، ثم أجب بالقيمة SUCCESS أو OK حرفيًا. تُعاد الإشعارات غير المؤكدة عددًا محدودًا من المرات.
استخدم payStatus مع paymentStatus وisFinal. القيمة payStatus=0 في استعلام التحصيل لا تعني فشل الدفع.
code=0 يعني نجاح استدعاء الواجهة؛ أما نتيجة الدفع فهي حالة الطلب. جميع رموز الأخطاء وطريقة التعامل معها موجودة في التوثيق الكامل.
أنشئ تاجرًا في بيئة الاختبار، وشغّل حزمة quickstart والفحص الذاتي لمدة 5 دقائق من دليل بيئة الاختبار، ثم اتبع قائمة التحقق قبل الإطلاق.
افتح حسابك أونلاين لتحصل على بيانات اعتماد الاختبار ورموز المنتجات، وبعد التأكد من عملها في البيئة التجريبية يمكنك التبديل إلى الإنتاج بنقرة واحدة.
توفر HissPay خدمات تقنية لتكامل المدفوعات وإدارة الطلبات والإشعارات والمطابقة. تتولى مؤسسة الدفع المرخصة المتعاقد معها معالجة المدفوعات ومقاصة الأموال وتسويتها. لا تستلم HissPay أموال المعاملات أو تحتفظ بها أو تتعامل بها.
تتكون الأسعار المعروضة من رسوم معالجة مؤسسة الدفع المرخصة ورسوم الخدمة التقنية لـ HissPay، ولا تعود بالكامل إلى HissPay. يحدد تفصيل الرسوم وطريقة احتسابها وشروطها في اتفاقيات التاجر الموقعة وجدول الرسوم.