مرجع API · الشحن المباشر

قراءة منتج الشحن المباشر

GET/v1/wallets/{walletId}/direct-recharge-products/{productId}

اقرأ المنتج وحقول بيانات المستلم التي تحتاج إلى جمعها قبل طلب عملية الشحن المباشر. منتجات الفواتير (billing) غير متاحة بعد.

الصلاحيةdirect_recharges:read

المصادقةقراءة موقَّعة

ردّ أنيسغير موقَّع

حدود الموظفين التي يُحتسب ضمنهاكل الاستدعاءات

حزمة SDK لـ ‎.NETanis.DirectRechargeProducts.GetAsync(walletId, productId)

المعاملات

الاسم	الموضع	النوع	ملاحظات
`walletId`إلزامي	`path`	UUID	معرّف UUID بأحرف صغيرة مع الشرطات.
`productId`إلزامي	`path`	UUID	معرّف UUID بأحرف صغيرة مع الشرطات.

الاستدعاء

موقَّعة بمفتاحك. بلا محتوى وبلا رقم استخدام لمرة واحدة (nonce).

الترويسات: Signature-Input، Signature، X-Anis-Date، Accept-Language (اختياري). تضبطها حزم SDK كلها نيابةً عنك.

المحتوى: لا يوجد.

الردود

الحالة	المعنى	المحتوى
200	نجاح.	DirectRechargeProduct
400	مرفوض: الاستدعاء الموقّع غير سليم البنية.	مشكلة
401	مرفوض: لم تتم المصادقة.	مشكلة
403	مرفوض: غير مسموح.	مشكلة
404	مرفوض: غير موجود، أو ليس لك.	مشكلة
422	مرفوض: الاستدعاء يخالف قاعدة.	مشكلة
429	مرفوض: بلغتَ حدًا.	مشكلة
503	لا قرار: خدمة مطلوبة غير متاحة.	مشكلة

ردود هذا الاستدعاء غير موقَّعة — لا ترويسة Signature ولا Signature-Input، سواء في النجاح أو الرفض. لا شيء تتحقق منه؛ فحماية TLS تكفيها. وتبقى Content-Digest و X-Request-Id موجودتين.

حالات الرفض

رفض هذا الاستدعاء مشكلةٌ بلا توقيع. ابنِ منطقك على رمزها code؛ وكلٌّ منها يرتبط بصفحة تشرح معناه وما عليك فعله.

الخطأ	الرمز	الحالة
بيانات اعتماد غير صالحة	`invalid_credentials`	401
استدعاء موقّع غير سليم البنية	`malformed_signed_request`	400
صلاحية غير كافية	`insufficient_scope`	403
عنوان المصدر غير مسموح	`source_ip_not_allowed`	403
تجاوزت حدّ الاستدعاءات	`rate_limited`	429
فشل التحقق	`validation_failed`	422
الخدمة غير متاحة	`dependency_unavailable`	503
انتهت مهلة الاستدعاء	`request_timeout`	504
خطأ داخلي	`internal_error`	500
الحساب غير مخوَّل	`binding_not_authorized`	403
الحساب غير فعّال	`account_inactive`	403
المحفظة غير ممنوحة	`wallet_not_granted`	404
غير موجود	`resource_not_found`	404
العملة غير مدعومة	`currency_not_supported`	422

الأنواع

DirectRechargeProduct

الحقل	النوع	ملاحظات
`id`موجود دائمًا	UUID	معرّف هذا المنتج أو الفئة أو الموقع.
`title`موجود دائمًا	string	نص منتج الشحن المباشر المعروض.
`description`	string	نص منتج الشحن المباشر المعروض.
`type`موجود دائمًا	string	تكون `external` أو `billing` كما وردت. منتجات الفواتير (`billing`) غير متاحة بعد. القيم: `external`, `billing`
`category`	DirectRechargeCategory	فئة منتج الشحن المباشر.
`payoutCurrency`موجود دائمًا	DirectRechargeCurrency	عملة التسليم باسمها؛ ولا يُخترع لها رمز ISO.
`available`موجود دائمًا	boolean	هل تستطيع المحفظة شراء المنتج. غياب الشريحة أو اقتصار السعر على فزّاعة يعني عدم الإتاحة.
`limits`	DirectRechargeLimits	حدود المبالغ لشريحة المحفظة عند وجود شريحة مطابقة.
`recipientFields`موجود دائمًا	list of DirectRechargeRecipientField	الحقول المتغيرة المرتبة لعرضها والتحقق منها لهذا المنتج.

DirectRechargeCategory

الحقل	النوع	ملاحظات
`id`موجود دائمًا	UUID	معرّف هذا المنتج أو الفئة أو الموقع.
`name`موجود دائمًا	string	اسم العرض الوارد لهذا العنصر.
`icon`	string	عنوان صورة الفئة إن ورد.

DirectRechargeCurrency

الحقل	النوع	ملاحظات
`name`موجود دائمًا	string	اسم العرض الوارد لهذا العنصر.

DirectRechargeLimits

الحقل	النوع	ملاحظات
`minimumTotal`	Money	الحدّ الأدنى أو الأعلى المسموح لإجمالي المحفظة بالدينار الليبي.
`maximumTotal`	Money	الحدّ الأدنى أو الأعلى المسموح لإجمالي المحفظة بالدينار الليبي.
`minimumPayout`	string	نص الحدّ الأدنى أو الأعلى لمبلغ التسليم بعملة المنتج المسماة.
`maximumPayout`	string	نص الحدّ الأدنى أو الأعلى لمبلغ التسليم بعملة المنتج المسماة.

Money

الحقل	النوع	ملاحظات
`amount`موجود دائمًا	string	نص عشري، وليس عدد JSON. قد يكون رصيد المحفظة سالبًا عند استخدام الدين المسموح. تتبع الأسعار والإجماليات قواعد المبلغ لكل مسار.
`currency`موجود دائمًا	string	رمز عملة من ثلاثة أحرف كبيرة، مثل `LYD`. اقرأ عملة المحفظة من `balance.currency`.
`asOf`	string (date-time)	وقت قراءة هذا السعر أو الرصيد.

DirectRechargeRecipientField

الحقل	النوع	ملاحظات
`key`موجود دائمًا	string	مفتاح الحقل كما ورد في تعريف المنتج.
`name`	LocalizedText	تسميات العرض بالعربية والإنجليزية مع حذف اللغة الفارغة.
`kind`موجود دائمًا	string	تكون `text` أو `list` أو `note`؛ اعرض الإدخال أو الإرشاد المناسب. القيم: `text`, `list`, `note`
`for`موجود دائمًا	string	تكون `recipient` أو `sender` حسب تعريف المنتج. القيم: `recipient`, `sender`
`order`موجود دائمًا	integer	ترتيب عرض الحقل.
`validation`	string	تعبير التحقق إن ورد.
`validationMessage`	LocalizedText	رسالة التحقق باللغات المتاحة إن وردت.

LocalizedText

الحقل	النوع	ملاحظات
`ar`	string	النص العربي؛ يُحذف حين يكون فارغًا.
`en`	string	النص الإنجليزي؛ يُحذف حين يكون فارغًا.