Issue Free Spin

Create a new freespin

post

https://dev.riddecgames.com/gatewayhttps://riddecgames.com/gateway

/api/launcher/standard/{integrationId}/v1/freespin/issue

Authorizations

StandardApiSignature

x-signaturestringRequired

hex(HMAC-SHA256(secret, body))

Path parameters

integrationIdstringRequired

Body

application/json

gamesstring[]Required

Game identifiers

Example: ["andvari-ring","jumping-bells"]

freespinIdstringRequired

Unique freespin ID on partners side

Example: fs-789

playerIdstringRequired

Unique player ID

Example: player-456

currencystring · min: 3 · max: 5Required

Currency code

Example: EUR

betCountnumber · min: 1Required

Number of freespin bets

Example: 10

timestampnumberRequired

Unix timestamp of the request

Example: 1767225600

betAmountstringOptional

Fixed bet amount

Example: 10.00

totalWinsAmountLimitstringOptional

Limit of the total wins in this freespin

Example: 100

startsAtstring · date-timeOptional

Start date and time of the freespin

expiresAtstring · date-timeOptional

Expiration date and time of the freespin

brandstringOptional

Brand that is issuing the freespins

Example: sample_casino

Responses

201

Freespin created successfully

application/json

400

Invalid request data

application/json

401

Invalid or missing signature

application/json

404

Game or integration not found

application/json

500

Internal server error

application/json

post

/api/launcher/standard/{integrationId}/v1/freespin/issue

HTTPcURLJavaScriptPython

POST /gateway/api/launcher/standard/{integrationId}/v1/freespin/issue HTTP/1.1
Host: dev.riddecgames.com
x-signature: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 292

{
  "games": [
    "andvari-ring",
    "jumping-bells"
  ],
  "freespinId": "fs-789",
  "playerId": "player-456",
  "currency": "EUR",
  "betCount": 10,
  "timestamp": 1767225600,
  "betAmount": "10.00",
  "totalWinsAmountLimit": "100",
  "startsAt": "2026-01-30T12:43:11.632Z",
  "expiresAt": "2026-01-30T12:43:11.632Z",
  "brand": "sample_casino"
}

{
  "providerFreespinId": "123e4567-e89b-12d3-a456-426614174000"
}