Freedom Pay

edit payment.refund

POST

https://api.freedompay.kz/v5/g2g/edit

Request

Header Params

string

optional

Indicates the media types that the client is able to understand from the server response.

Example:

application/json

Content-Type

string

optional

Specifies the media type of the resource being sent to the server.

Example:

application/json

X-Action

string

required

Invoked method.

Default:

gateway.payment.refund

X-Request-Id

string <uuid>

required

Unique request ID (UUID).
If the same request_id is sent more than once, the API guarantees idempotent behavior and returns the original response.

Example:

01978c2b-f191-7b56-92f8-20c7c401d1fc

X-JWS-Signature

string

required

Request signature.

Example:

eyJhbGciOiJSUzI1NiIsImtpZCI6IjEyMzQ1NiJ9.eyJpc3MiOiJleGFtcGxlLmNvbSIsInN1YiI6InVzZXIxMjMiLCJhdWQiOiJhcGkuZXhhbXBsZS5jb20iLCJleHAiOjE2MzAwMDAwMDAsImlhdCI6MTYyOTk5NjQwMH0.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Body Params application/json

string <uuid>

required

Payment ID (UUID).

amount

number <float>

required

Payment amount.

Example

{
    "id": "01904e28-a01d-75d0-bc3a-56d777f0a39b",
    "amount": 100
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.freedompay.kz/v5/g2g/edit' \
--header 'Accept: application/json' \
--header 'X-Action;' \
--header 'X-Request-Id: 01978c2b-f191-7b56-92f8-20c7c401d1fc' \
--header 'X-JWS-Signature: eyJhbGciOiJSUzI1NiIsImtpZCI6IjEyMzQ1NiJ9.eyJpc3MiOiJleGFtcGxlLmNvbSIsInN1YiI6InVzZXIxMjMiLCJhdWQiOiJhcGkuZXhhbXBsZS5jb20iLCJleHAiOjE2MzAwMDAwMDAsImlhdCI6MTYyOTk5NjQwMH0.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": "01904e28-a01d-75d0-bc3a-56d777f0a39b",
    "amount": 100
}'

Responses

🟢200Success

application/json

Headers

x-request-id

string

required

Request ID (UUID), equals X-Request-Id from request headers.

Example:

01978c2b-f191-7b56-92f8-20c7c401d1fc

x-request-status

string

required

Request status.

Example:

success

x-datetime

string

required

Request datetime.

Example:

2025-06-20T07:13:31Z

Body

string

required

amount

integer

required

refund_payment

object

required

string

required

status

string

required

amount

integer

required

Example

{
    "id": "01978d4f-fb27-7615-a95c-d646dc1df3f3",
    "amount": 100,
    "refund_payment": {
        "id": "01978d53-4748-74c1-9c0a-0ca2b64b9c1b",
        "status": "process",
        "amount": -100
    }
}

Modified at 2025-06-26 13:31:42

read request

edit payment.reverse