Refund

POST

https://api.freedompay.kz/v5/merchant/invoice/refund

This method used to return funds to a payer for a previously processed payment.

Request

Body Params application/jsonRequired

Example

{
    "id": "019d0652-4e2f-7f54-a179-007c80c48adu",
    "amount": 12500.50,
    "description": "Refund description",
    "device": {
        "id": "device-abc-123",
        "browserVersion": "Chrome/121.0.0.0",
        "ip": "85.116.189.120"
    }
}

Responses

🟢200OK

application/json

Body

Example

{
    "refund_id": "019d2ec0-f051-76ae-a8a7-125369e63020",
    "status": "refunded",
    "created_at": "2026-03-23T15:10:00Z"
}

Info

Status