POST
Transactions/wallets/refundRefund wallet transaction
Creates a refund against an original wallet transaction UUID.
Access tierbusiness_operatorRate limit20/minIdempotencynoneAuthenticationBearerAuth
Source
LuxApi/app/Http/Controllers/Api/WalletApiController.php::refundLuxPayProjects @ 146e98baa44eParameters
X-Request-IDheaderClient correlation identifier. LuxPay may generate one when omitted.
Example:req_01J...Request body
WalletRefundRequestRequired
original_transaction_uuidstring
amountnumber
reasonstring | null
JSON example
{
"original_transaction_uuid": "00000000-0000-4000-8000-000000000001",
"amount": 1,
"reason": "string"
}Code examples
The displayed sandbox host is a placeholder until an official host is provisioned. Never paste a production token into a public browser.
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"
}'Responses
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"
}
}