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

عرض عمليات الشحن المباشر الخاصة بي

GET/v1/wallets/{walletId}/direct-recharges

ابحث عن عمليات تطبيقك في محفظة مصرّح بها حسب الحالة والتاريخ.

الصلاحيةdirect_recharges:read

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

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

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

حزمة SDK لـ ‎.NETanis.DirectRecharges.GetDirectRechargesAsync(walletId, query)

تظهر عمليات تطبيقك وحده في هذه المحفظة المصرّح بها، من الأحدث إلى الأقدم. تُطبّق المرشّحات معًا: status بالقيم awaitingPayment|paymentFailed|pending|inProgress|suspendedDataError|completed|rejectedAwaitingRefund|rejectedWithRefund وproductId بصيغة UUID وfrom وto بتوقيت UTC، وcursor بحد أقصى 2048 حرفًا، وpageSize الاختياري بقيمة افتراضية 50 وحدود 1–100. اطلب فترة لا تتجاوز 31 يومًا؛ وترك التاريخين يعرض آخر 31 يومًا. أعد nextCursor كما هو مع المرشّحات وحجم الصفحة نفسيهما حتى يصبح null. صحّح المرشّحات أو المؤشّر عند validation_failed بالحالة 422؛ ولا تكرر الشراء لاستعادة القائمة.
الحالات مطابقة للتفاصيل الموقّعة؛ ويبيّن hasPartialRefund وجود إعادة جزئية دون حالة جديدة. بيانات المستلم والإثبات في القراءة التفصيلية الموقّعة فقط. لا تعيد القائمة ردّ معالجة بالحالة 202.

المعاملات

الاسم	الموضع	النوع	ملاحظات
`walletId`إلزامي	`path`	UUID	معرّف UUID بأحرف صغيرة مع الشرطات.
`status`اختياري	`query`	DirectRechargeStatus	حالة مدمجة اختيارية: `awaitingPayment` أو `paymentFailed` أو `pending` أو `inProgress` أو `suspendedDataError` أو `completed` أو `rejectedAwaitingRefund` أو `rejectedWithRefund`.
`productId`اختياري	`query`	UUID	مرشّح اختياري بمعرّف UUID لمنتج الشحن المباشر.
`from`اختياري	`query`	string	حدّ اختياري مشمول للفترة بتوقيت UTC؛ اطلب مدة لا تتجاوز `31` يومًا. ترك الحدّين يعرض آخر `31` يومًا.
`to`اختياري	`query`	string	حدّ اختياري مشمول للفترة بتوقيت UTC؛ اطلب مدة لا تتجاوز `31` يومًا. ترك الحدّين يعرض آخر `31` يومًا.
`cursor`اختياري	`query`	string	قيمة `nextCursor` من الصفحة السابقة، تُعاد كما استُلمت بالضبط. اتركها للصفحة الأولى.
`pageSize`اختياري	`query`	integer	حجم صفحة اختياري من `1` إلى `100`؛ والقيمة الافتراضية `50`.

الاستدعاء

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

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

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

الردود

الحالة	المعنى	المحتوى
200	نجاح.	DirectRechargeCollection
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

الأنواع

DirectRechargeCollection

الحقل	النوع	ملاحظات
`items`موجود دائمًا	list of DirectRechargeSummary	السجلات الواردة في هذه الصفحة.
`nextCursor`موجود دائمًا	string	أعد هذه القيمة كما هي في `cursor`؛ وتعني `null` أنك وصلت إلى الصفحة الأخيرة.

DirectRechargeSummary

الحقل	النوع	ملاحظات
`operationId`موجود دائمًا	UUID	قيمة UUID نفسها المرسلة في `Idempotency-Key` لهذا الشراء.
`status`موجود دائمًا	DirectRechargeStatus	الحالة المدمجة المعروضة للعميل؛ تضيف الإعادة الجزئية مبالغ بدل حالة جديدة.
`number`موجود دائمًا	integer	رقم عملية الشحن المباشر المسجّل.
`product`موجود دائمًا	DirectRechargeProductReference	معرّف منتج الشحن المباشر المشترى وعنوانه.
`payout`موجود دائمًا	DirectRechargePayout	نص مبلغ التسليم وعملته المسماة؛ وليس بصيغة Money للدينار.
`total`موجود دائمًا	Money	إجمالي تكلفة المحفظة بصيغة Money وعملة LYD. فحص الرصيد دقيق حتى `999,999.999 LYD`.
`externalReference`	string	مرجعك الخاص؛ يظهر إن أرسلته.
`requestedAt`موجود دائمًا	string (date-time)	وقت طلب عملية الشحن المباشر بتوقيت UTC.
`completedAt`	string (date-time)	وقت الإكمال إن ورد، بتوقيت UTC.
`hasPartialRefund`موجود دائمًا	boolean	هل توجد إعادة جزئية مسوّاة، بما في ذلك القيمة `false`؛ ولا تضيف حالة جديدة.

DirectRechargeStatus

DirectRechargeProductReference

الحقل	النوع	ملاحظات
`id`موجود دائمًا	UUID	معرّف منتج الشحن المباشر المختار.
`title`موجود دائمًا	string	نص منتج الشحن المباشر المعروض.

DirectRechargePayout

الحقل	النوع	ملاحظات
`amount`موجود دائمًا	string	مبلغ التسليم كنص عشري.
`currency`موجود دائمًا	DirectRechargeCurrency	كائن اسم عرض عملة التسليم.

DirectRechargeCurrency

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

Money

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