POST
Merchant wallets/merchant-wallets/{merchantId}/settlement-requestطلب تسوية تاجر
ينشئ طلب تسوية يدويًا لفترة محفظة التاجر.
مستوى الوصولmerchant_financeالحد60/minمنع التكرارbody:idempotency_keyالمصادقةBearerAuth
المصدر
LuxApi/Modules/LuxPayIdentity/Http/Controllers/Api/MerchantWalletApiController.php::settlementRequestLuxPayProjects @ 146e98baa44eالمعاملات
X-Request-IDheaderClient correlation identifier. LuxPay may generate one when omitted.
Example:req_01J...merchantIdpathMerchant/business identifier.
Example:10101جسم الطلب
MerchantSettlementRequestإلزامي
wallet_idinteger
period_startstring
period_endstring
idempotency_keystring
notesstring | null
JSON example
{
"wallet_id": 1,
"period_start": "2026-07-16",
"period_end": "2026-07-16",
"idempotency_key": "string",
"notes": "string"
}أمثلة الكود
العنوان المعروض Sandbox Placeholder حتى يتم تزويد النطاق الرسمي. لا تلصق رمز Production في متصفح عام.
curl --request POST \
--url 'https://sandbox-api.luxpay.example/v1/merchant-wallets/10101/settlement-request' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"wallet_id": 1,
"period_start": "2026-07-16",
"period_end": "2026-07-16",
"idempotency_key": "string",
"notes": "string"
}'الاستجابات
200Successful response.
statusboolean
Example:
truemessagestring | null
dataSettlement
{
"status": true,
"message": "string",
"data": {
"id": 1,
"uuid": "00000000-0000-4000-8000-000000000001",
"wallet_id": 1,
"period_type": "daily",
"period_start": "2026-07-16",
"period_end": "2026-07-16",
"status": "pending",
"idempotency_key": "string",
"notes": "string",
"items": [
{}
],
"created_at": "2026-07-16T12:00:00Z"
}
}