حاسبة تقسيم الدفع بين بطاقة هدية والنقد
توضح حاسبة الدفع ببطاقة هدية والنقد بدقة كيفية تقسيم قيمة الشراء عندما يغطي رصيد البطاقة جزءاً من الإجمالي أو يغطيه كله أو يزيد عليه.
شغّل الأداة مجانًا
أدخلوا قيمة المشتريات والرصيد المتاح حالياً في البطاقة. تستخدم الحاسبة أكبر قدر ممكن من ذلك الرصيد، ثم تعرض المبلغ المتبقي للدفع نقداً وما سيبقى في بطاقة الهدية بعد العملية. تفيد هذه النتيجة عند الدفع، أو عند التخطيط لعملية شراء، أو عند شرح تفاصيل دفعة مقسمة لشخص آخر.
أدخلوا قيمة الشراء والرصيد المتاح
ابدؤوا بإدخال القيمة الكاملة للمشتريات قبل تطبيق أي مبلغ من بطاقة الهدية، ثم أدخلوا الرصيد المتاح فعلياً لهذه العملية. يجب أن يكون الرقمان بالعملة نفسها، لأن الحاسبة تقسم المبالغ ولا تحول العملات. استخدموا قيماً نقدية عادية لا تتجاوز منزلتين عشريتين، مثل 42 أو 42.50 أو 19.99. يجب أن تكون قيمة الشراء أكبر من الصفر، أما رصيد بطاقة الهدية فيجوز أن يكون صفراً، وعندئذ تسدد قيمة الشراء كلها نقداً. إذا سبق استخدام البطاقة، فأدخلوا رصيدها الحالي المتاح لا قيمتها الأصلية. ينبغي أن تشمل قيمة الشراء الضرائب ورسوم التوصيل والخصومات والإكراميات متى كانت جزءاً من الإجمالي المطلوب عند الدفع. لا تقرر الحاسبة ما إذا كان المتجر يقبل الجمع بين وسيلتي دفع، ولا ما إذا كان رسم معين قابلاً للسداد ببطاقة هدية. إنها تجيب عن المسألة الحسابية بعد معرفة الإجمالي المستحق والرصيد الذي يمكن استخدامه.
تعرفوا على طريقة حساب التقسيم
تطبق الحاسبة بطاقة الهدية أولاً، في حدود القيمة الأصغر من مبلغ الشراء والرصيد المتاح. فإذا كانت المشتريات بقيمة 80 وكان في البطاقة 30، كان الجزء المدفوع بالبطاقة 30 والجزء النقدي 50. وإذا اقترنت المشتريات نفسها برصيد قدره 100، غطت البطاقة مبلغ 80 كاملاً، ولم يلزم دفع نقدي، وبقي فيها 20. تمنع هذه القاعدة مبلغ البطاقة المستخدم أو المبلغ النقدي المتبقي من أن يصبح سالباً. تحسب النتائج بوحدات العملة الصغرى الصحيحة لتجنب آثار الفاصلة العائمة المألوفة، مثل ظهور 0.30000000000000004. ويظهر مبلغ الشراء أيضاً مرجعاً إلى جانب القيم الثلاث المحسوبة. وللتحقق، يساوي مجموع المبلغ المستخدم من البطاقة والمبلغ النقدي قيمة الشراء دائماً. كما يساوي مجموع المبلغ المستخدم والرصيد المتبقي في البطاقة رصيد البداية دائماً. تسهّل هاتان العلاقتان مراجعة النتيجة أو إدراجها في معاينة للدفع.
استخدموا النتيجة عند الدفع أو في سير العمل
تعاملوا مع النتيجة بوصفها خطة للدفع لا موافقة من المتجر على العملية. يمثل مبلغ بطاقة الهدية المستخدم القيمة المطلوب خصمها من البطاقة. ويمثل المبلغ النقدي ما يجب سداده نقداً أو ببطاقة خصم أو بطاقة ائتمان أو وسيلة أخرى مقبولة. أما الرصيد المتبقي فهو ما يفترض أن يظل متاحاً في بطاقة الهدية بعد نجاح العملية، ما لم توجد حجوزات أو رسوم أو قيود خاصة بالمتجر. قبل الدفع، تأكدوا من أن المتجر يسمح بجمع بطاقة الهدية مع وسيلة دفع أخرى، وأن نظامه يطبق البطاقة بالترتيب المتوقع. للاستخدام الآلي، أرسلوا الحقلين الرقميين نفسيهما إلى API واحفظوا المبالغ الأربعة المعادة مع عرض سعر أو سلة مشتريات أو رد للدعم. تبلغ تكلفة كل طلب $0.002؛ ويمكن استخدام نسخة المتصفح مجاناً. ولأن الحساب حتمي ولا يعتمد على خدمة شبكية، تعطي المدخلات المتطابقة نتائج متطابقة، وهذا مفيد لتخطيط المشتريات وإنشاء حالات اختبار قابلة للتكرار.
حالات الاستخدام
خططوا للشراء قبل الدفع
اعرفوا مقدار النقد أو المبلغ المدفوع ببطاقة أخرى الذي سيبقى مطلوباً بعد استخدام رصيد بطاقة الهدية المتاح.
اشرحوا دفعة مقسمة
قدموا لعميل أو فرد من الأسرة تفصيلاً واضحاً لحصة بطاقة الهدية والحصة النقدية والرصيد المتبقي.
عاينوا منطق الدفع
استخدموا نتيجة API عند اختبار سلة أو عرض سعر أو أداة استرداد أو سير دعم يطبق بطاقات الهدايا أولاً.
الأسئلة الشائعة
كيف تحدد الحاسبة المبلغ المستخدم من بطاقة الهدية؟
تستخدم القيمة الأصغر من مبلغ الشراء والرصيد المتاح، فلا تطبق أكثر من ثمن المشتريات ولا أكثر مما تحتويه البطاقة.
ماذا يحدث إذا كان رصيد البطاقة أكبر من قيمة الشراء؟
تغطي بطاقة الهدية قيمة الشراء كاملة، ويصبح المبلغ النقدي صفراً، وتظهر القيمة غير المستخدمة بوصفها الرصيد المتبقي.
ماذا يحدث إذا لم يكن في بطاقة الهدية رصيد؟
يُقبل الرصيد الصفري. يكون المبلغ المستخدم من البطاقة صفراً، وتخصص قيمة الشراء كلها للدفع النقدي.
هل يمكن إدخال عملتين مختلفتين للمبلغين؟
لا. يجب أن يكون المبلغان بالعملة نفسها. تقسم هذه الحاسبة دفعة واحدة ولا تحول العملات.
هل يضمن ذلك قبول المتجر للدفع المقسم؟
لا. تختلف القواعد بين المتاجر. تحققوا من السماح بجمع بطاقة الهدية مع النقد أو وسيلة دفع أخرى.
ما تكلفة استخدام API؟
تبلغ تكلفة كل طلب API مقدار $0.002. ويمكن أيضاً استخدام الحاسبة مجاناً في المتصفح.
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/life/gift-card-split \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"purchase_amount":86.4,"gift_card_balance":50}'const res = await fetch("https://api.kit.forhosting.com/life/gift-card-split", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"purchase_amount": 86.4,
"gift_card_balance": 50
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/life/gift-card-split",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"purchase_amount": 86.4,
"gift_card_balance": 50
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/life/gift-card-split", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"purchase_amount":86.4,"gift_card_balance":50}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"purchase_amount":86.4,"gift_card_balance":50}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/life/gift-card-split", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"purchase_amount": 86.4,
"gift_card_balance": 50
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "life.gift_card_split",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |