حاسبة الاسترداد النقدي
أنفق 250 ببطاقة تمنح 2% فتسترد 5، وتصبح تكلفة الشراء الفعلية 245. أدخل ما أنفقته ونسبة المكافأة لتقارن البطاقات أو تراجع كشف الحساب أو تخطط لميزانيتك. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- الكمية
- 250
- النسبة المئوية
- 2
- المعدل (عشري)
- 0.02
- استرداد نقدي
- 5
- التكلفة الصافية
- 245
تحوّل مكافآت الاسترداد النقدي الإنفاق اليومي إلى قيد دائن في الكشف أو إلى إيداع: بطاقة ائتمان أو بطاقة متجر أو برنامج ولاء يعيد إليكم نقداً نسبة مما أنفقتموه. تأخذ حاسبة الاسترداد النقدي هذه المبلغ المنفق على عملية شراء أو مجموع كشف، ونسبة المكافأة لتلك الفئة أو البطاقة، وتضربهما ثم تعيد الاسترداد المكتسب حتى تقارنوا البطاقات أو تراجعوا كشفاً أو تُدرجوا الرقم في موازنة. أدخلوا الإنفاق والنسبة؛ تتلقون مبلغ الاسترداد والمعدل العشري والتكلفة الصافية بعد المكافأة. يُسمح بصفر بالمئة وينتج استرداداً صفرياً.
ما الاسترداد النقدي وكيف يُحسب
الاسترداد النقدي هو الجزء من عملية الشراء الذي تعيده إليك بطاقة ائتمان أو بطاقة متجر أو برنامج ولاء في صورة مال، عادةً كرصيد دائن في كشف الحساب أو إيداع، لا في صورة أميال أو سلع. والحساب بسيط: اضرب المبلغ المنفق في نسبة المكافأة واقسم على مئة. بطاقة بقالة تمنح 2% على مشتريات بقيمة 250 تعيد 5. أدخل النسبة كما تعلنها الجهة المصدرة، فالرقم 2 يعني اثنين بالمئة، وتعرض الحاسبة النسبة نفسها كسرًا عشريًا 0.02.
مقارنة البطاقات ومراجعة الكشوف
أدخل المبلغ نفسه مع كل بطاقة أو فئة تفكر فيها وقارن الاسترداد جنبًا إلى جنب. الفئة التي لا تمنح مكافأة تبقى ضمن المقارنة، لأن نسبة الصفر مقبولة وتعطي صفرًا لا خطأ. وتوضح التكلفة الصافية ما كلفته عملية الشراء حقًا بعد المكافأة. تُقرَّب المبالغ إلى منزلتين عشريتين لتطابق كشف الحساب، وتُرفض النسبة السالبة لأنها رسوم لا مكافأة.
الأسئلة الشائعة
ماذا يحدث إذا كانت نسبة المكافأة سالبة؟
نسبة المكافأة السالبة غير مسموحة في هذا العقد ولا تُفوتر. صفر بالمئة صالح وينتج استرداداً صفرياً.
هل يُدخل 2 أم 0.02 لبطاقة باثنين بالمئة؟
أدخلوا 2. percent نسبة مئوية لا كسر: اثنان يعني اثنين بالمئة.
هل يجوز أن يكون مبلغ الشراء صفراً؟
يُرفض amount السالب لأن إنفاق الشراء لا يجوز أن يكون سالباً.
كيف يُحسب الاسترداد النقدي؟
يُضرب المبلغ المنفق في نسبة المكافأة ثم يُقسم على مئة. إنفاق 250 ببطاقة تمنح 2% يعيد 5، وتُقرَّب النتيجة إلى منزلتين عشريتين كأي مبلغ مالي.
ما التكلفة الصافية بعد الاسترداد النقدي؟
هي المبلغ المنفق مطروحًا منه الاسترداد النقدي، أي ما تكلفه عملية الشراء فعلًا بعد إضافة المكافأة إلى كشف الحساب. في المثال، إنفاق 250 بنسبة 2% يترك تكلفة صافية قدرها 245.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/fin/cash-back \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"amount":250,"percent":2}'const res = await fetch("https://api.kit.forhosting.com/fin/cash-back", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"amount": 250,
"percent": 2
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/fin/cash-back",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"amount": 250,
"percent": 2
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/cash-back", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"amount":250,"percent":2}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"amount":250,"percent":2}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/cash-back", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"amount": 250,
"percent": 2
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "fin.cash_back",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
تُرفض نسبة المكافأة السالبة بـ invalid_input ولا تُفوتر.
كيف يحوّل الاسترداد النقدي الإنفاق ونسبة المكافأة إلى مال
الاسترداد النقدي هو حصة الشراء التي يعيدها برنامج المكافآت مالاً لا أميالاً ولا بضائع. بطاقة بقالة بنسبة اثنين بالمئة على إنفاق مئتين وخمسين تعيد خمسة؛ وفئة دوّارة بنسبة واحد ونصف بالمئة على مئة وثلاثة وعشرين دولاراً وخمسة وأربعين سنتاً تعيد دولاراً وخمسة وثمانين سنتاً بعد التقريب النقدي المعتاد. صفر بالمئة نتيجة مشروعة وتعيد استرداداً صفرياً بدل خطأ: فئة بلا مكافأة إضافية ما زالت تنتمي إلى المقارنة. لا يبحث هذا المسار في قوائم فئات جهة الإصدار، ولا يحوّل العملات، ولا يقسم سلة على سقوف دوّارة بخمسة بالمئة، ولا يوقّت قيد الرصيد. الهوية التي تستخدمها هذه الحاسبة هي cash_back يساوي amount في percent مقسوماً على مئة. amount هو إنفاق الشراء بعملة واحدة؛ وpercent هو معدل المكافأة المعلن، يُكتب كما تطبعه جهات الإصدار على صفحات التسويق، فالاثنان يعنيان اثنين بالمئة لا مئتين بالمئة. تُعاد الصيغة العشرية لذلك المعدل أيضاً باسم rate_decimal حتى تحتفظ ورقة الحساب بكسر إلى جانب النسبة التي يكتبها الناس. net_cost هو الإنفاق بعد طرح مبلغ الاسترداد: وهو ما تكلفه العملية فعلاً إذا قُيّدت المكافأة رصيداً في الكشف. نسبة المكافأة السالبة ليست حسماً في هذا العقد وتُرفض بـ invalid_input، لأن جدول مكافآت يطبع علامة ناقص هو في الغالب خطأ بيانات لا رسماً أردتم نمذجته. يُسمح بعرض مطابقة بمئة بالمئة وعندها يساوي cash_back قيمة amount ويصير net_cost صفراً.
عقد الإدخال وشكل الاستجابة وسلوك الخطأ
إذا كان percent سالباً يرفض المعالج برسالة واضحة بأن نسبة مكافأة سالبة غير مسموحة — وتلك الإخفاقات لا تُفوتر. أرسلوا عبر POST جسماً JSON برقمين منتهيين إلزاميين. amount هو إنفاق الشراء بوحدة نقدية واحدة؛ والأسماء المستعارة spent وpurchase وpurchase_amount وspend تشير إلى الحقل نفسه حتى يحتفظ تصدير الكشف بأسماء الأعمدة. percent هو معدل المكافأة كنسبة مئوية لا ككسر: اثنان يعني اثنين بالمئة، وخمسة يعني خمسة بالمئة؛ وتُقبل الأسماء المستعارة rate وreward_percent وcash_back_rate وreward_rate. قد يصل كل حقل رقمي عدداً في JSON أو سلسلة رقمية. الحقول الناقصة والسلاسل الفارغة والقيم غير المنتهية تفشل بـ invalid_input مع تسمية الحقل. إذا كان amount سالباً يرفض المعالج الطلب لأن إنفاق الشراء لا يجوز أن يكون سالباً؛ وتُسمح عيّنة مجانية قيمتها صفر فتنتج استرداداً صفرياً وnet_cost صفرياً. صفر بالمئة صالح ويعيد cash_back صفرياً. عند النجاح يردّ الجسم amount مقرّباً إلى منزلتين وpercent، ثم يبلّغ rate_decimal بوصفه percent مقسوماً على مئة، وcash_back بوصفه المكافأة المكتسبة مقرّبة إلى منزلتين، وnet_cost بوصفه amount ناقص cash_back، وسلسلة formula تعيد صياغة الهوية. مثال: مئتان وخمسون من الإنفاق باثنين بالمئة تنتج cash_back قدره خمسة وnet_cost قدره مئتان وخمسة وأربعون. اقرنوا JSON بقاعدتكم في أي المشتريات تشترك في معدل — بقالة أو وقود أو معدلاً ثابتاً لكل شيء — لأن هذا المسار يضرب الرقمين اللذين ترسلونهما؛ ولا يعيّن فئة تاجر، ولا يطبّق سقفاً ربع سنوي، ولا يحوّل العملات. أبقوا الطلبات صغيرة، وثبّتوا cash_back المقرّب في الاختبارات، فتحصلون على رقم مكافأة قابل لإعادة الإنتاج لأوراق العمل وإضافات LMS وعُقد الحافة دون إقامة محرك مكافآت بطاقات خاص بكم.
أين تثبت حاسبة الاسترداد النقدي جدواها
تستخدم الأسر التي تقارن بطاقة ثابتة باثنين بالمئة بفئة دوّارة بخمسة بالمئة حاسبة استرداد نقدي لتحويل إنفاق الشهر الماضي على البقالة أو الوقود إلى رقم دولاري واحد قابل للمقارنة قبل التقديم. يسعّر الاسترداد النقدي إنفاقاً واحداً مقابل نسبة مكافأة واحدة ويعيد مالاً. لا يستهلك التحقق الفاشل الرصيد. تبقى سقوف المكافأة الربعية ورسوم العمليات الخارجية والرسوم السنوية خارج هذه الهوية قصداً: اطووها في طبقتكم بعد أن تحوزوا دولارات الاسترداد الخام. يُدخل من يضع الموازنة مبلغ شراء مخططاً والنسبة المنشورة ثم يثبّت net_cost حتى يعكس بقية مغلف الشهر رصيد الكشف المتوقع. تربط فرق المنتجات العقد نفسه بصفحات العروض واختبارات الانضمام التي يجب أن تُظهر cash_back لسلة عيّنة دون استدعاء API لجهة إصدار. هذا بحث وعمل مختلفان عن ضريبة المبيعات، وعن استرداد قرض بقاعدة الثمانية والسبعين، وعن قيمة نقاط السفر: تلك الأدوات تضيف ضريبة على المجموع الفرعي، أو تردّ فائدة مدفوعة مقدماً على قرض أقساط، أو تحوّل أميال الجوائز إلى سنتات لكل نقطة. ولأن التنفيذ parse خالص من المستوى A، يكلف كل استدعاء ناجح السعر الأساسي المنشور $0.002 بلا رموز نموذج وبلا شبكة صادرة. أبقوا percent غير سالب، وثبّتوا cash_back المقرّب في الاختبارات، فتحصلون على مبلغ مكافأة قابل لإعادة الإنتاج للعروض التمهيدية ومراجعات الكشف وعُقد الحافة دون إقامة دفتر أستاذ للمكافآت خاص بكم.
حالات التكامل
مقارنة عروض البطاقات على إنفاق شهري نموذجي
حوّلوا مجموع البقالة أو الوقود للشهر الماضي والنسبة المنشورة لكل بطاقة إلى cash_back حتى يجلس معدل ثابت باثنين بالمئة ومكافأة دوّارة على المقياس النقدي نفسه.
مطابقة فئة كشف الحساب مع النسبة المعلنة
أدخلوا إنفاق الفئة من كشف ونسبة جهة الإصدار، ثم أكّدوا أن cash_back يطابق الرصيد الذي تتوقعونه قبل الاعتراض على مكافأة ناقصة.
وضع تكلفة الشراء الكبيرة الصافية في الموازنة
أدخلوا سعر التذكرة ونسبة المكافأة ثم ثبّتوا net_cost حتى يعكس بقية مغلف الشهر رصيد الكشف.
أسئلة تقنية
كيف يُحسب الاسترداد النقدي من الإنفاق ونسبة المكافأة؟
أرسلوا أرقاماً منتهية amount (إنفاق غير سالب) وpercent (معدل مكافأة غير سالب، حيث 2 تعني 2%). تعيد API القيمة cash_back = amount × (percent / 100) مقرّبة إلى منزلتين عشريتين، مع rate_decimal وnet_cost.
كم تكلفة حاسبة الاسترداد النقدي؟
أداة المتصفح مجانية. تستخدم طلبات API رصيداً مدفوعاً مسبقاً بسعر $0.002 لكل استدعاء ناجح؛ ولا تُفوتر المدخلات غير الصالحة.