POST
Holds/wallets/holdحجز مبلغ
ينشئ حجزًا مؤقتًا على أموال المحفظة.
مستوى الوصولbusiness_operatorالحد20/minمنع التكرارnoneالمصادقةBearerAuth
المصدر
LuxApi/app/Http/Controllers/Api/WalletApiController.php::holdLuxPayProjects @ 146e98baa44eالمعاملات
X-Request-IDheaderClient correlation identifier. LuxPay may generate one when omitted.
Example:req_01J...جسم الطلب
CreateHoldRequestإلزامي
wallet_idinteger
amountnumber
currency_codestring
reasonstring | null
expiry_minutesinteger | null
JSON example
{
"wallet_id": 1,
"amount": 1,
"currency_code": "string",
"reason": "string",
"expiry_minutes": 1
}أمثلة الكود
العنوان المعروض Sandbox Placeholder حتى يتم تزويد النطاق الرسمي. لا تلصق رمز Production في متصفح عام.
curl --request POST \
--url 'https://sandbox-api.luxpay.example/v1/wallets/hold' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"wallet_id": 1,
"amount": 1,
"currency_code": "string",
"reason": "string",
"expiry_minutes": 1
}'الاستجابات
200Successful response.
statusboolean
Example:
truemessagestring | null
dataHold
{
"status": true,
"message": "string",
"data": {
"uuid": "00000000-0000-4000-8000-000000000001",
"wallet_id": 1,
"amount": 1,
"currency_code": "string",
"status": "active",
"reason": "string",
"expires_at": "2026-07-16T12:00:00Z"
}
}