Refund request
POST/api/v1/refund
After the successful transaction, you can submit a refund request using the information provided below
🔋 Sample request payload
{
  "merchantCode": "842217", // Pass merchant code
  "refundAmount": "10.000", // Refund amount should be in KWD 
  "refundMethod": "1", // "1" for Full Refund , "0" for partial
  "token": "TXN1234560490040400404000404004" // Invoice token number
}
🎯 Note: Payload must be encrypted before being sent to the server. To access the response data, decrypt it upon receiving the response from the server
⚡️ Payload details
| Fields Name | Description | Required | 
|---|---|---|
| merchantCode | Pass the merchant code | ✅ Yes | 
| refundAmount | Pass the refund amount and it should be in KWD | ✅ Yes | 
| refundMethod | Pass the refund method "1" or "2" | ✅ Yes | 
| token | Pass the transaction token number | ✅ Yes | 
📌 Types of refund methods
| Types | Description | Value | 
|---|---|---|
| Full | To process a complete refund of the transaction amount | "1" | 
| Partial | To process a partial refund of the total transaction amount | "2" | 
Request
Responses
- 200
- 404
- 500
Refund request successfully sent, Decrypt the response from the server to see the final result
Transaction not found – The requested transaction ID does not exist or cannot be located. Please verify that the transaction ID is correct.
Internal Server Error – An unexpected error occurred on the server while processing the request. This may be due to a temporary issue or a server-side malfunction. Please try again later or contact support if the issue persists.