HyoNovaالتوثيق

التعامل مع المال

كيف يمثّل HyoNova المال ويحوّله — أعداد صحيحة بوحدات العملة الصغرى مع رمز ISO 4217، وحساب نصّي لمبالغ المزوّدين العشرية، وقواعد التقريب، ودون تحويل بين العملات.

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

لا تظهر طريقة الدفع إلا بعد أن يُعدّ HyoNova مزوّد الدفع الخاص بها.

لا يقرر عددٌ عشري ثنائي أبداً كم يدفع العميل. فكل مبلغ في HyoNova Commerce عدد صحيح من الوحدات الصغرى للعملة مع رمز العملة وفق ISO 4217.

التمثيل#

أينالشكل
قاعدة البياناتbigint بالوحدات الصغرى وعملة من ثلاثة أحرف
داخل الخادمbigint
الواجهة البرمجيةسلسلة عشرية بالوحدات الصغرى مع العملة، مثل { "amount": "1495", "currency": "USD" } = 14.95 دولاراً

منازل العملات العشرية#

لمعظم العملات منزلتان عشريتان. ويذكر HyoNova الاستثناءات صراحةً:

المنازلالعملات
0BIF، CLP، DJF، GNF، ISK، JPY، KMF، KRW، PYG، RWF، UGX، UYI، VND، VUV، XAF، XOF، XPF
3BHD، IQD، JOD، KWD، LYD، OMR، TND
4CLF، UYW
2كل رمز صالح آخر

ويُرفض الرمز الذي ليس ثلاثة أحرف كبيرة (CURRENCY_UNSUPPORTED).

تحويل مبالغ المزوّدين#

يرسل بعض المزوّدين مبالغ عشرية (FastSpring 14.95، Triple-A 10). ويحوّلها HyoNova بالحساب النصّي فقط:

  • يُقرأ رقم JSON عبر أقصر صيغة عشرية دقيقة له، لا عبر قيمته الثنائية.
  • "14.95" دولاراً ← 1495؛ و1000 ين ← 1000.
  • المبلغ الذي فيه منازل عشرية أكثر مما تسمح به العملة يُرفض ولا يُقرَّب.
  • تُنسَّق المبالغ المرسلة إلى المزوّد من الوحدات الصغرى بالطريقة نفسها (1495 ← "14.95").

التقريب#

  • النسب المئوية (الخصومات) بنقاط الأساس (2500 = 25%) وتُقرَّب نصفاً بعيداً عن الصفر.
  • المبالغ المتناسبة مع الزمن تُقرَّب نصفاً بعيداً عن الصفر ولا تُستخدم إلا حيث تنص السياسة؛ ولا يخترع HyoNova أي خصم لدى المزوّد. ويحتسب المزوّد الاحتساب النسبي لتغييرات خطط البطاقة.
  • مجاميع الفواتير تحقق دائماً الإجمالي = المجموع الفرعي − الخصم + الضريبة؛ وتفرض قاعدة البيانات ذلك، وتفرض ألا يتجاوز المدفوع الإجمالي.

لا تحويل بين العملات#

لا يحوّل HyoNova بين العملات أبداً. فالأسعار موجودة لكل عملة، وتحمل الفواتير والمدفوعات عملتها، ويجب أن تطابق الدفعة عملة فاتورتها، ويُعرض كل رقم إيرادات لكل عملة على حدة. والرسوم التي لم يبلّغ عنها المزوّد في التسوية تبقى مجهولة — ولا تُعرض صفراً أبداً.

↑↓ للتنقل · Enter للفتح · Esc للإغلاق