كيف يعمل تحويل العملات

اكتب الوحدات قبل الحساب

ابدأ بالمبلغ الذي لديك، والعملة التي تريدها، واتجاه السعر. في هذا المثال التوضيحي، المصدر هو EUR والهدف هو USD والسعر هو 1.08765 دولار أمريكي لكل يورو. هذا سعر مُختلق لشرح الحساب.

Source amount:       250.00 EUR
Rate:                1.08765 USD/EUR
Unrounded result:    271.91250 USD
Two-decimal result:  271.91 USD

إذا كان السعر يشير إلى الاتجاه الآخر، فاقسم

إذا كان لديك USD 250 وكان السعر الوحيد المتاح هو 1.25 دولار أمريكي لكل يورو، فاقسم 250 على 1.25 لتحصل على EUR 200. أما الضرب فسيجيب عن سؤال مختلف.

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

اطلب تحويلًا من Narwhal

تأخذ نقطة نهاية التحويل from وto ومبلغًا عشريًا موجبًا. ويجب أن تختلف العملتان. وتعيد المبلغ المُدخل وسعر الصرف المحدد والمبلغ المحوّل والطابع الزمني وحالة التقادم وجلسة التداول. وتعتمد الاستجابة الفعلية على المشاهدة المقبولة وقت الطلب.

curl --request GET \
  --url "https://api.narwhalapi.com/v1/fx/convert?from=USD&to=JPY&amount=100.00" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

افصل بين مبالغ الحساب والدفع

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

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

Source balance:             100.00 USD
Fee deducted before FX:        2.00 USD
Amount actually converted:    98.00 USD
Provider rate:                 0.90 EUR/USD
Recipient amount:             88.20 EUR

قرّب النتيجة مرة واحدة

تستخدم مواصفات التحويل لدى Narwhal الحساب العشري والتقريب إلى الأقرب مع ترجيح العدد الزوجي عند التعادل، وفق الوحدة الصغرى للعملة المستهدفة في ISO 4217. ولدقة سعر الصرف ودقة مبلغ العملة غرضان مختلفان؛ فلا تختصر سعر الصرف أولًا إلى عدد المنازل العشرية المستخدمة للمبالغ النقدية.

احتفظ بسعر الصرف المُعاد والمبلغ المحوّل معًا. فقد تؤدي إعادة الحساب باستخدام سعر مقرب لأغراض العرض إلى فرق ظاهر عن نتيجة API.

تحقق من الإدخال واحفظ سياق النتيجة

قبل عرض تحويل على أنه حالي، تحقق من الطابع الزمني المُعاد وعلامة التقادم. فالطلب الناجح لا يعني أن السعر لوحظ في اللحظة التي نقرت فيها.

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