Skip to main content

🔗 Transaction Refunds

🔄 Refund Process​

Transaction Refund Process

A refund is a transaction process where a merchant returns funds to a customer after a payment has been processed.

📖 Refere more about Refund Related API's [ 🔗 Click Here ]

Create a Refund Request​

To create a refund request for a transaction, pass the following parameters:

🏷️ Parameter📝 Description
merchantCode Merchant Code is a unique identifier generated by Hesabe for each activated merchant
token Transaction Token of the original transaction
refundAmount Amount to be refunded
refundMethod 1 for Full Refund, 2 for Partial Refund
$baseUrl = 'http://sandbox.hesabe.com/api/'; // sandbox
$refundRequestApiUrl = $baseUrl . 'transaction-refund';
$data = [
    'merchantCode' => 'your_merchant_code',
    'token' => '521042117249344539468767555844',
    'refundAmount' => 1,
    'refundMethod' => 2,
];
$checkoutRequest = Request::create($refundRequestApiUrl, 'POST', $data);
$checkoutRequest->headers->set('accessCode', $accessCode);

Response Sample​

{
    "status": true,
    "message": "Your refund request is waiting for approval",
    "data": {
        "token": "521042117249344539468767555844",
        "amount": "1.000",
        "order_reference_number": "1724934434",
        "transaction_status": "SUCCESSFUL",
        "refund_status": "PENDING",
        "payment_type": "KNET",
        "service_type": "Payment Gateway",
        "transaction_datetime": "2024-08-29 15:27:38",
        "refund_requested_at": "2024-09-04 15:04:44"
    }
}