POST
Merchant wallets/merchant-walletsإنشاء محفظة تاجر
ينشئ محفظة أساسية لتاجر أو نشاط.
مستوى الوصولbusiness_operatorالحد60/minمنع التكرارnoneالمصادقةBearerAuth
المصدر
LuxApi/Modules/LuxPayIdentity/Http/Controllers/Api/MerchantWalletApiController.php::createLuxPayProjects @ 146e98baa44eالمعاملات
X-Request-IDheaderClient correlation identifier. LuxPay may generate one when omitted.
Example:req_01J...جسم الطلب
CreateMerchantWalletRequestإلزامي
merchant_idinteger
currency_codestring
JSON example
{
"merchant_id": 1,
"currency_code": "string"
}أمثلة الكود
العنوان المعروض Sandbox Placeholder حتى يتم تزويد النطاق الرسمي. لا تلصق رمز Production في متصفح عام.
curl --request POST \
--url 'https://sandbox-api.luxpay.example/v1/merchant-wallets' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"merchant_id": 1,
"currency_code": "string"
}'الاستجابات
201Successful response.
statusboolean
Example:
truemessagestring | null
dataWallet
{
"status": true,
"message": "string",
"data": {
"id": 42,
"uuid": "6ee4b4a8-9f8d-4f18-a586-b32c4593b094",
"owner_type": "customer",
"owner_id": 2201,
"wallet_type": "primary",
"status": "active",
"currency_code": "YER",
"account_number": "C-YER-00000042",
"cached_balance": 5000,
"cached_pending_balance": 0,
"cached_held_balance": 500,
"business_id": 10101,
"branch_id": 7,
"balance_verified_at": "2026-07-16T12:00:00Z",
"meta": {},
"created_at": "2026-07-16T12:00:00Z",
"updated_at": "2026-07-16T12:00:00Z"
}
}