Cancel transaction V2

curl --request POST \
  --url https://{host}/bonus/v2/transactions/{id}/cancel \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "operationId": "<string>",
  "amount": 123
}
'

import requests

url = "https://{host}/bonus/v2/transactions/{id}/cancel"

payload = {
    "operationId": "<string>",
    "amount": 123
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({operationId: '<string>', amount: 123})
};

fetch('https://{host}/bonus/v2/transactions/{id}/cancel', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{host}/bonus/v2/transactions/{id}/cancel",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'operationId' => '<string>',
    'amount' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{host}/bonus/v2/transactions/{id}/cancel"

	payload := strings.NewReader("{\n  \"operationId\": \"<string>\",\n  \"amount\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{host}/bonus/v2/transactions/{id}/cancel")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"operationId\": \"<string>\",\n  \"amount\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{host}/bonus/v2/transactions/{id}/cancel")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"operationId\": \"<string>\",\n  \"amount\": 123\n}"

response = http.request(request)
puts response.read_body

{
  "state": "Waiting",
  "remainingReservedAmount": 123
}

{
  "name": "<string>",
  "message": "<string>",
  "details": null
}

{
  "name": "<string>",
  "message": "<string>",
  "details": null
}

POST

transactions

{id}

cancel

Cancel transaction V2

curl --request POST \
  --url https://{host}/bonus/v2/transactions/{id}/cancel \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "operationId": "<string>",
  "amount": 123
}
'

import requests

url = "https://{host}/bonus/v2/transactions/{id}/cancel"

payload = {
    "operationId": "<string>",
    "amount": 123
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({operationId: '<string>', amount: 123})
};

fetch('https://{host}/bonus/v2/transactions/{id}/cancel', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{host}/bonus/v2/transactions/{id}/cancel",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'operationId' => '<string>',
    'amount' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{host}/bonus/v2/transactions/{id}/cancel"

	payload := strings.NewReader("{\n  \"operationId\": \"<string>\",\n  \"amount\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{host}/bonus/v2/transactions/{id}/cancel")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"operationId\": \"<string>\",\n  \"amount\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{host}/bonus/v2/transactions/{id}/cancel")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"operationId\": \"<string>\",\n  \"amount\": 123\n}"

response = http.request(request)
puts response.read_body

{
  "state": "Waiting",
  "remainingReservedAmount": 123
}

{
  "name": "<string>",
  "message": "<string>",
  "details": null
}

{
  "name": "<string>",
  "message": "<string>",
  "details": null
}

Authorizations

Authorization

string

header

required

JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Path Parameters

integer<int64>

required

Unique transaction id.

Body

Cancel operation details.

operationId

string

required

Unique identifier of the cancel operation (should be the same only for retries of the same operation).

Required string length: 1 - 128

amount

number<double> | null

Amount which should be released.

Response

state

enum<string>

required

Available options:

Waiting,

Successful,

Cancelled

remainingReservedAmount

number<double>

required

Reserved amount of the transaction remaining after the cancel operation. If the remaining reserved amount is zero then the transaction is finalized.

Last modified on August 10, 2026

⌘I