العودة للمرجع
GET/wallets/{walletId}/balance
Wallets

رصيد المحفظة

يعيد الأرصدة المخزنة والمحجوزة والمعلقة والمتاحة مع وقت التحقق.

مستوى الوصولcustomer_or_businessالحد60/minمنع التكرارnoneالمصادقةBearerAuth
المصدرLuxApi/app/Http/Controllers/Api/WalletApiController.php::balanceLuxPayProjects @ 146e98baa44e

المعاملات

X-Request-IDheader
stringاختياري

Client correlation identifier. LuxPay may generate one when omitted.

Example: req_01J...
walletIdpath
integerإلزامي

Numeric wallet identifier.

Example: 42

أمثلة الكود

العنوان المعروض Sandbox Placeholder حتى يتم تزويد النطاق الرسمي. لا تلصق رمز Production في متصفح عام.
curl --request GET \
  --url 'https://sandbox-api.luxpay.example/v1/wallets/42/balance' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <token>'

الاستجابات

200Successful response.
status
boolean
Example: true
data
WalletBalance
{
  "status": true,
  "data": {
    "wallet_id": 42,
    "account_number": "C-YER-00000042",
    "currency_code": "YER",
    "available_balance": 4500,
    "cached_balance": 5000,
    "held_balance": 500,
    "pending_balance": 0,
    "balance_verified_at": "2026-07-16T12:00:00Z"
  }
}
400
401
403
404
409
422
429
500
OpenAPI JSONOpenAPI YAMLPostman collection