POST
Transactions/wallets/refundاسترداد عملية محفظة
ينشئ استردادًا مرتبطًا بمعرف العملية الأصلية.
مستوى الوصولbusiness_operatorالحد20/minمنع التكرارnoneالمصادقةBearerAuth
المصدر
LuxApi/app/Http/Controllers/Api/WalletApiController.php::refundLuxPayProjects @ 146e98baa44eالمعاملات
X-Request-IDheaderClient correlation identifier. LuxPay may generate one when omitted.
Example:req_01J...جسم الطلب
WalletRefundRequestإلزامي
original_transaction_uuidstring
amountnumber
reasonstring | null
JSON example
{
"original_transaction_uuid": "00000000-0000-4000-8000-000000000001",
"amount": 1,
"reason": "string"
}أمثلة الكود
العنوان المعروض Sandbox Placeholder حتى يتم تزويد النطاق الرسمي. لا تلصق رمز Production في متصفح عام.
curl --request POST \
--url 'https://sandbox-api.luxpay.example/v1/wallets/refund' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"original_transaction_uuid": "00000000-0000-4000-8000-000000000001",
"amount": 1,
"reason": "string"
}'الاستجابات
200Successful response.
statusboolean
Example:
truemessagestring | null
message_translatedstring | null
dataTransaction
{
"status": true,
"message": "string",
"message_translated": "string",
"data": {
"id": 901,
"uuid": "00000000-0000-4000-8000-000000000001",
"wallet_id": 42,
"owner_type": "customer",
"owner_id": 2201,
"transaction_type": "transfer",
"status": "completed",
"amount": 1250.5,
"currency_code": "YER",
"exchange_rate": 1,
"local_amount": 1,
"fee_amount": 0,
"net_amount": 1250.5,
"reference_type": "string",
"reference_id": 1,
"external_reference": "string",
"idempotency_key": "string",
"business_id": 1,
"branch_id": 1,
"payment_method": "string",
"description": "string",
"meta": {},
"completed_at": "2026-07-16T12:00:00Z",
"failed_at": "2026-07-16T12:00:00Z",
"reversed_at": "2026-07-16T12:00:00Z",
"created_at": "2026-07-16T12:00:00Z"
}
}