💹Refund

Good to know: Before you begin, make sure you have obtained the login and password from the administrator. These credentials are required to authenticate and successfully execute the API requests.

Refund of payment via api

A refund can only be made if the payment is completed with the status "Charge"

to make a refund, you need to make a POST request to this url: https://{url}.finipay.kg/api/v1.1.0/refund.

POST https://{url}.finipay.kg/api/v1.1.0/refund

Headers

Name	Value
Content-Type	application/json
Authorization	Basic Auth

Body

Name	Type	Description
orderNumber*	String	The unique number of transaction
amount*	BigDecimal	The amount you want to refund

* - required

Response

204 Refund

Full refund
{
    "code": "204",
    "message": "REFUND",
    "data": {
        "amount": 200.00,
        "refunded": 200,
        "refundable": 0.00,
        "currency": "KGS"
    }
}


Partial refund

{
    "code": "204",
    "message": "REFUND",
    "data": {
        "amount": 200.00,
        "refunded": 100,
        "refundable": 100.00,
        "currency": "KGS"
    }
}

404 Payment Not Found

{
    "code": "404",
    "message": "PAYMENT_NOT_FOUND",
    "data": null
}

33 Invalid Order Params

{
    "code": "33",
    "message": "INVALID_PARAMS",
    "data": null
}

41 Invalid Order State

{
    "code": "41",
    "message": "INVALID_ORDER_STATE",
    "data": null
}

171 Incorrect_sum

{
    "code": "171",
    "message": "INCORRECT_SUM",
    "data": null
}

400 Bad Request

{
    "timestamp": "2025-05-13T08:44:35.072+00:00",
    "status": 400,
    "error": "Bad Request",
    "path": "/api/v1.1.0/refund"
}