POST /freespins/cancel

Operator → Beexar

Cancels a freespins issue at any time, even while the player is playing it. A canceled issue never sends its Freespins/Finish: what its rounds won is forfeited.

---

Request

POST {GATEWAY_URL}/api/v1/softswiss/freespins/cancel

Headers

Header	Value
Content-Type	application/json
X-REQUEST-SIGN	HMAC-SHA256 signature of the request body (64 hex chars)

Body

Field	Type	Required	Description
casino_id	string	Yes	Operator slug
issue_id	string	Yes	The issue_id you sent to Freespins/Issue

Example

{
  "casino_id": "casinoxyz",
  "issue_id": "fs-2026-000123"
}

---

Response (200 OK)

{}

---

What a Cancel Does

The issue is	Answer	Effect
Active — including mid-round	200	Canceled. No Finish will be sent; a round already playing is played to the end
Already canceled	200	Nothing more
Unknown	200	Remembered: an Issue with this issue_id arriving later is refused with 605
Over with rounds played — played out, or expired after a round — its Finish is on its way or delivered	400, api_code 620	None. The result will be (or was) reported
Expired with no round played	400, api_code 611	None

Tip

Mark an issue canceled in your ledger only when the cancel is accepted. A 620 means the issue was played out: its Freespins/Finish arrives and must be credited.

A cancel that arrives before its Issue — because the Issue timed out on your side and is being retried — wins: the late Issue is refused with 605, and no freespins are given.

---

Error Responses

HTTP	code	meta.api_code	Meaning
403	invalid_argument	403	Invalid request signature
400	invalid_argument	400	Malformed body
400	invalid_argument	404	casino_id not found
400	invalid_argument	410	Casino is disabled
400	invalid_argument	420	This endpoint is not available for the operator’s integration type
400	invalid_argument	611	The issue has already expired
400	invalid_argument	620	The issue has been played out and can’t be canceled
500	internal	500	Internal error. Retryable

---

curl Example

BODY='{"casino_id":"casinoxyz","issue_id":"fs-2026-000123"}'
SIGNATURE=$(echo -n "$BODY" | openssl dgst -sha256 -hmac "your_auth_token" | awk '{print $2}')

curl -X POST https://gateway.beexar.com/api/v1/softswiss/freespins/cancel \
  -H "Content-Type: application/json" \
  -H "X-REQUEST-SIGN: $SIGNATURE" \
  -d "$BODY"