{"info":{"_postman_id":"9b99479a-adc6-47e0-be3c-899899ac96bd","name":"SBO Sports FreeBet 568Win API and Customer Seamless Wallet Changes","description":"

Complete Cross Promotion flow in the API system

In back office, create a Promotion for SBO Sports + FreeBet.
Select the Issuance Method:
- API Issuance: your system decides which players receive FreeBet and calls the 568Win FreeBet API.
- System Auto Issuance: 568Win evaluates the configured mission/qualification rules and issues FreeBet automatically.
\n
Configure currency, FreeBet amount, player claim limit, total budget, max payout, expiry, and usage conditions.
Activate the Promotion and save the generated PromotionKey.
If your WL/API promotion flow uses section 13.5 Cross Promotion Reward, select this Cross Promotion reward campaign there and set the reward count. The selected campaign must be active, use API Issuance, support the promotion currency, and stay within the reward count limit.
For API Issuance, call the 568Win FreeBet API to issue one or multiple FreeBet tickets. The API response may return before the ticket is immediately usable, so allow a short processing time before treating the FreeBet as available to the player.
When the player uses the FreeBet in SBO Sports, the existing Customer Seamless Wallet Deduct endpoint is still used with Amount = 0 and Promotion Reward parameters in ExtraInfo.
Settle, Cancel, Rollback, and GetBetStatus continue through the existing wallet lifecycle.
Use FreeBet ticket lookup, PromotionRewardCode, PromotionEventId, TransferCode, and TransactionId for support and reconciliation.

Purpose

This collection is for customers integrating SBO Sports FreeBet. It explains how to configure FreeBet promotions in back office, when to call the 568Win FreeBet API, and what your Customer Seamless Wallet must support for FreeBet wagers.

You will learn:

What must be configured in each backoffice setup stage
The difference between API Issuance and System Auto Issuance
Which 568Win FreeBet APIs are used for API Issuance
Which FreeBet request examples and processing rules your Customer Seamless Wallet must support

What you should know first

SBO Sports FreeBet has two issuance methods:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Issuance method	Issuance behavior	Do you need to call the 568Win FreeBet API?
API Issuance	You create a FreeBet Promotion in back office, then your system assigns and issues FreeBet to selected players through the API	Yes
System Auto Issuance	568Win automatically issues FreeBet after you configure a player-facing FreeBet mission and the player completes it	No

Customer Seamless Wallet impact

Existing wallet endpoint paths, HTTP methods, authentication, request envelopes, and response envelopes do not change.

Your wallet handlers only need to recognize FreeBet wagers inside the existing Sports lifecycle:

GetBalance does not need FreeBet-specific logic.
Deduct must identify the Promotion Reward parameters in ExtraInfo.
Settle, Cancel, and Rollback continue using the existing transaction lifecycle.
GetBetStatus continues returning wallet-side bet status.
Bonus is not the default payout path for SBO Sports FreeBet.

SBO Sports FreeBet wagers use Deduct.Amount = 0 and include:

{\n  \"PromotionRewardCode\": \"FB-2Q4W6E8R1T3Y5U7I\",\n  \"PromotionRewardAmount\": 50.0,\n  \"PromotionEventId\": 1001\n}\n

Do not identify FreeBet from Amount = 0 alone. Use the Promotion Reward parameters in ExtraInfo.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"39587621","collectionId":"9b99479a-adc6-47e0-be3c-899899ac96bd","publishedId":"2sBXqMHKGA","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-05-06T06:12:32.000Z"},"item":[{"name":"568Win FreeBet API","item":[{"name":"Get FreeBet Promotions for API Issuance","id":"b6f05b48-3e9d-4b5b-aae1-f5491b91e9f7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"body":{"mode":"raw","raw":"{\n \"CompanyKey\": \"{{your_company_key_here}}\"\n}"},"url":"https://api.example.com/web-root/restricted/freebet/get-api-issuance-promotions.aspx","description":"

Returns FreeBet promotions that were created for API Issuance. After creating the promotion in the back office, your system can assign and issue FreeBets to selected players through the FreeBet API.

Call this API first to retrieve the promotionKey that must be submitted when issuing FreeBet.

Request fields

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Required	Description
`CompanyKey`	string	Yes	Company key provided by 568Win.

Response fields

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Description
`serverId`	string	568Win server identifier that handled the request.
`promotions`	array	FreeBet promotions available for API Issuance. Please refer to the Promotion table below.
`error`	object	Standard 568Win API error object. `id = 0` means success.

Promotion

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Description
`promotionEventId`	number	568Win promotion event ID.
`promotionName`	string	Promotion name.
`promotionKey`	string	Promotion key required when issuing FreeBet.
`currencies`	array	Supported currencies for the promotion.
`expiryRule`	object	FreeBet expiry rule. Please refer to the Expiry Rule table below.
`freeBetAmount`	number	FreeBet amount.
`maxPayout`	number	Maximum payout per FreeBet ticket.
`displayValue`	string	Display value for the amount and max payout.
`eventStartTime`	string \| null	Promotion start time.
`eventEndTime`	string \| null	Promotion end time.

Expiry Rule

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Description
`expirationType`	string	Expiry rule type.
`expirationDays`	number \| null	Number of days after issuance before expiry, when applicable.
`expirationDateTime`	string \| null	Fixed expiry time, when applicable.

","urlObject":{"path":["web-root","restricted","freebet","get-api-issuance-promotions.aspx"],"host":["https://api.example.com"],"query":[],"variable":[]}},"response":[{"id":"ac46d67f-c834-457b-93fd-b83f65b1bed3","name":"Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"body":{"mode":"raw","raw":"{\n \"CompanyKey\": \"{{your_company_key_here}}\"\n}"},"url":"https://api.example.com/web-root/restricted/freebet/get-api-issuance-promotions.aspx"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"cookie":[],"responseTime":null,"body":"{\n \"serverId\": \"YY-STG\",\n \"promotions\": [\n {\n \"promotionEventId\": 1001,\n \"promotionName\": \"Weekly Retention Gift\",\n \"promotionKey\": \"RETENTION-WEEKLY-301\",\n \"currencies\": [\n \"USD\",\n \"TMP\"\n ],\n \"expiryRule\": {\n \"expirationType\": \"AfterIssued\",\n \"expirationDays\": 7,\n \"expirationDateTime\": null\n },\n \"freeBetAmount\": 50,\n \"maxPayout\": 200,\n \"displayValue\": \"USD 50 FreeBet / Max Payout USD 200\",\n \"eventStartTime\": \"2026-05-01T00:00:00.000-04:00\",\n \"eventEndTime\": \"2026-05-31T23:59:59.000-04:00\"\n }\n ],\n \"error\": {\n \"id\": 0,\n \"msg\": \"No Error\"\n }\n}"}],"_postman_id":"b6f05b48-3e9d-4b5b-aae1-f5491b91e9f7"},{"name":"Issue FreeBet by API","event":[{"listen":"test","script":{"exec":["try {"," const json = pm.response.json();"," if (json.freeBetCode) pm.collectionVariables.set('FreeBetCode', json.freeBetCode);"," if (json.amount !== undefined) pm.collectionVariables.set('PromotionRewardAmount', String(json.amount));","} catch (e) {}"],"id":"8c319115-f98d-477d-a19e-ddf984530c81","type":"text/javascript"}}],"id":"a438950e-ed3d-494f-b00b-45641877ec21","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"body":{"mode":"raw","raw":"{\n \"CompanyKey\": \"{{your_company_key_here}}\",\n \"Username\": \"player001\",\n \"PromotionKey\": \"RETENTION-WEEKLY-301\",\n \"CurrencyCode\": \"USD\",\n \"ExternalAssignmentReferenceNo\": \"CRM-20260505-0001\"\n}"},"url":"https://api.example.com/web-root/restricted/freebet/assign-api-issuance.aspx","description":"

Issue one SBO Sports FreeBet to a selected player through the FreeBet API.

After this API returns success, the FreeBet issuance may still need a short processing time before the player can use the FreeBet. Your system should allow time for 568Win to complete issuance before treating the FreeBet as immediately available to the player.

Your system should keep each externalAssignmentReferenceNo unique so the issuance can be reconciled and duplicate issuance can be avoided.

Request fields

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Required	Description
`CompanyKey`	string	Yes	Company key provided by 568Win.
`Username`	string	Yes	Player account receiving the FreeBet.
`PromotionKey`	string	Yes	`promotionKey` returned by the API Issuance promotion list API.
`CurrencyCode`	string	Yes	Issuance currency. It must be supported by the promotion.
`ExternalAssignmentReferenceNo`	string	Yes	Single-issuance reference number generated by your system.

Response fields

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Description
`serverId`	string	568Win server identifier that handled the request.
`freeBetCode`	string	FreeBet code generated by 568Win.
`promotionKey`	string	Promotion key used for issuance.
`username`	string	Player account receiving the FreeBet.
`status`	string	Current FreeBet status.
`currencyCode`	string	FreeBet currency.
`amount`	number	FreeBet amount.
`maxPayoutPerBet`	number	Maximum payout for this FreeBet ticket.
`expiresAt`	string \| null	FreeBet expiry time.
`externalAssignmentReferenceNo`	string	Single-issuance reference number you submitted.
`error`	object	Standard 568Win API error object. `id = 0` means success.

","urlObject":{"path":["web-root","restricted","freebet","assign-api-issuance.aspx"],"host":["https://api.example.com"],"query":[],"variable":[]}},"response":[{"id":"0b21494f-21da-4518-a50c-2495ff626eff","name":"Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"body":{"mode":"raw","raw":"{\n \"CompanyKey\": \"{{your_company_key_here}}\",\n \"Username\": \"player001\",\n \"PromotionKey\": \"RETENTION-WEEKLY-301\",\n \"CurrencyCode\": \"USD\",\n \"ExternalAssignmentReferenceNo\": \"CRM-20260505-0001\"\n}"},"url":"https://api.example.com/web-root/restricted/freebet/assign-api-issuance.aspx"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"cookie":[],"responseTime":null,"body":"{\n \"serverId\": \"YY-STG\",\n \"freeBetCode\": \"FB-2Q4W6E8R1T3Y5U7I\",\n \"promotionKey\": \"RETENTION-WEEKLY-301\",\n \"username\": \"player001\",\n \"status\": \"Active\",\n \"currencyCode\": \"USD\",\n \"amount\": 50,\n \"maxPayoutPerBet\": 200,\n \"expiresAt\": \"2026-05-12T00:00:00.000-04:00\",\n \"externalAssignmentReferenceNo\": \"CRM-20260505-0001\",\n \"error\": {\n \"id\": 0,\n \"msg\": \"No Error\"\n }\n}"}],"_postman_id":"a438950e-ed3d-494f-b00b-45641877ec21"},{"name":"Batch Issue FreeBet by API","event":[{"listen":"test","script":{"id":"f86134d8-b3c9-4b4e-8d7f-f6ee2e8e7f0c","type":"text/javascript","exec":["try {"," const json = pm.response.json();"," if (Array.isArray(json.assignedTickets) && json.assignedTickets.length > 0 && json.assignedTickets[0].freeBetCode) pm.collectionVariables.set('FreeBetCode', json.assignedTickets[0].freeBetCode);","} catch (e) {}"]}}],"id":"b7bb02b2-0bd7-4f0b-98b9-8bcd9465813a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"CompanyKey\": \"{{your_company_key_here}}\",\n \"Username\": \"player001\",\n \"PromotionKey\": \"RETENTION-WEEKLY-301\",\n \"CurrencyCode\": \"USD\",\n \"Quantity\": 2,\n \"BatchExternalReferenceNo\": \"CRM-20260505-BATCH-0001\",\n \"ItemExternalReferenceNos\": [\n \"CRM-20260505-BATCH-0001-1\",\n \"CRM-20260505-BATCH-0001-2\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.example.com/web-root/restricted/freebet/assign-batch.aspx","description":"

Issue multiple SBO Sports FreeBet tickets to the same player through the FreeBet API.

After this API returns success, the issued FreeBet tickets may still need a short processing time before the player can use them. Your system should allow time for 568Win to complete issuance before treating the FreeBets as immediately available to the player.

Use this API when your system needs to issue multiple FreeBet tickets in one business batch. Each ticket must have a unique itemExternalReferenceNo so you can reconcile or troubleshoot each issued ticket.

Request fields

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Required	Description
`CompanyKey`	string	Yes	Company key provided by 568Win.
`Username`	string	Yes	Player account receiving the FreeBet tickets.
`PromotionKey`	string	Yes	`promotionKey` returned by the API Issuance promotion list API.
`CurrencyCode`	string	Yes	Issuance currency. It must be supported by the promotion.
`Quantity`	number	Yes	Number of FreeBet tickets to issue. Must be greater than 0.
`BatchExternalReferenceNo`	string	Yes	Batch reference number generated by your system.
`ItemExternalReferenceNos`	array	Yes	Per-ticket reference numbers. The count must equal `Quantity`; values cannot be blank or duplicated.

Response fields

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Description
`serverId`	string	568Win server identifier that handled the request.
`reasonCode`	string \| null	Reason code when the batch is not fully successful; `null` on success.
`reasonMessage`	string \| null	Reason message when the batch is not fully successful; `null` on success.
`batchExternalReferenceNo`	string	Batch reference number you submitted.
`promotionKey`	string	Promotion key used for issuance.
`username`	string	Player account receiving the FreeBet tickets.
`currencyCode`	string	FreeBet currency.
`requestedQuantity`	number	Requested number of tickets.
`remainingQuantity`	number	Number of tickets not issued by 568Win; `0` on success.
`assignedTickets`	array	Successfully issued FreeBet tickets. Please refer to the Assigned Ticket table below.
`error`	object	Standard 568Win API error object. `id = 0` means success.

Assigned Ticket

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Description
`itemExternalReferenceNo`	string	Per-ticket reference number you submitted.
`freeBetCode`	string	FreeBet code generated by 568Win.

","urlObject":{"path":["web-root","restricted","freebet","assign-batch.aspx"],"host":["https://api.example.com"],"query":[],"variable":[]}},"response":[{"id":"d5d37b6e-e259-47b8-90aa-9235c9881201","name":"Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"CompanyKey\": \"{{your_company_key_here}}\",\n \"Username\": \"player001\",\n \"PromotionKey\": \"RETENTION-WEEKLY-301\",\n \"CurrencyCode\": \"USD\",\n \"Quantity\": 2,\n \"BatchExternalReferenceNo\": \"CRM-20260505-BATCH-0001\",\n \"ItemExternalReferenceNos\": [\n \"CRM-20260505-BATCH-0001-1\",\n \"CRM-20260505-BATCH-0001-2\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.example.com/web-root/restricted/freebet/assign-batch.aspx"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"serverId\": \"YY-STG\",\n \"reasonCode\": null,\n \"reasonMessage\": null,\n \"batchExternalReferenceNo\": \"CRM-20260505-BATCH-0001\",\n \"promotionKey\": \"RETENTION-WEEKLY-301\",\n \"username\": \"player001\",\n \"currencyCode\": \"USD\",\n \"requestedQuantity\": 2,\n \"remainingQuantity\": 0,\n \"assignedTickets\": [\n {\n \"itemExternalReferenceNo\": \"CRM-20260505-BATCH-0001-1\",\n \"freeBetCode\": \"FB-2Q4W6E8R1T3Y5U7I\"\n },\n {\n \"itemExternalReferenceNo\": \"CRM-20260505-BATCH-0001-2\",\n \"freeBetCode\": \"FB-4A6S8D1F3G5H7J9K\"\n }\n ],\n \"error\": {\n \"id\": 0,\n \"msg\": \"No Error\"\n }\n}"}],"_postman_id":"b7bb02b2-0bd7-4f0b-98b9-8bcd9465813a"}],"id":"87aeecb8-b44d-4d22-8eeb-0118e920f355","description":"

The 568Win FreeBet API is used for SBO Sports FreeBet API Issuance.

API Issuance means you first create a FreeBet Promotion in back office, then issue FreeBets to players through the 568Win FreeBet API.

API Issuance flow:

In back office, create a Promotion and select Reward Type: FreeBet and Issuance Method: API Issuance
Configure currency, FreeBet amount, player claim limit, total budget, max payout, and usage conditions
Activate the Promotion and save the PromotionKey generated by back office
If a WL/API promotion uses section 13.5 Cross Promotion Reward, select this active Cross Promotion reward campaign and set the reward count there
Determine which players should receive the FreeBet reward
Call the 568Win FreeBet API to issue FreeBets to players. Use the batch API when issuing multiple FreeBet tickets at once

Common rules:

A successful issuance API response may still need a short processing time before the FreeBet is available to the player.
\n
Requests use the existing 568Win API JSON format and CompanyKey authentication.
\n
Player identity uses the existing public API Username.
\n
568Win resolves platform-side internal identifiers from CompanyKey and Username; do not add internal platform IDs to the request.
\n
If your environment already requires ServerId, follow the existing API documentation. It is not a FreeBet-specific field.
\n

System Auto Issuance does not need this API. 568Win issues FreeBet automatically after the player completes the configured mission.

\n","_postman_id":"87aeecb8-b44d-4d22-8eeb-0118e920f355"},{"name":"Customer Seamless Wallet FreeBet Change Examples","item":[{"name":"Get User Balance - No FreeBet Change","id":"db4199a0-eaa8-42af-88c5-9ad84f2cb447","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"body":{"mode":"raw","raw":"{\n \"CompanyKey\": \"{{your_company_key_here}}\",\n \"Username\": \"player001\",\n \"ProductType\": 1,\n \"GameType\": 1,\n \"Gpid\": -2\n}"},"url":"https://customer-wallet.example.com/GetBalance","description":"

FreeBet impact

GetBalance does not need FreeBet-specific logic.

Continue using the existing Customer Seamless Wallet API behavior and response envelope. Do not add Promotion-specific state or FreeBet ticket lookup logic to this endpoint.

\n","urlObject":{"path":["GetBalance"],"host":["https://customer-wallet.example.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"db4199a0-eaa8-42af-88c5-9ad84f2cb447"},{"name":"Deduct Bet Amount - FreeBet Amount 0 + ExtraInfo","id":"98cf9f44-6693-490e-ab49-04299e032b1c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"body":{"mode":"raw","raw":"{\n \"Amount\": 0,\n \"TransferCode\": \"3998211\",\n \"TransactionId\": \"3998211\",\n \"BetTime\": \"2026-05-05T00:23:25.9143053-04:00\",\n \"GameRoundId\": null,\n \"GamePeriodId\": null,\n \"OrderDetail\": null,\n \"PlayerIp\": \"1.2.3.4\",\n \"GameTypeName\": null,\n \"CompanyKey\": \"{{your_company_key_here}}\",\n \"Username\": \"player001\",\n \"ProductType\": 1,\n \"GameType\": 1,\n \"NewGameType\": 101,\n \"GameId\": 1,\n \"Gpid\": -2,\n \"ExtraInfo\": {\n \"sportType\": \"Football\",\n \"marketType\": \"Over/Under\",\n \"league\": \"ITALY SERIE A\",\n \"match\": \"Lecce vs Sampdoria\",\n \"betOption\": \"Over\",\n \"kickoffTime\": \"2026-05-05T00:23:25\",\n \"isHalfWonLose\": false,\n \"winlostDate\": null,\n \"PromotionRewardCode\": \"FB-2Q4W6E8R1T3Y5U7I\",\n \"PromotionRewardAmount\": 50.0,\n \"PromotionEventId\": 1001\n },\n \"SeamlessGameExtraInfo\": {\n \"FeatureBuyStatus\": 0,\n \"EndRoundStatus\": 0\n }\n}"},"url":"https://customer-wallet.example.com/Deduct","description":"

Purpose

SBO Sports still calls the existing Deduct endpoint when the player places a wager.

The difference between a normal bet and a FreeBet wager is:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Amount	ExtraInfo Promotion Reward parameters	Customer Seamless Wallet behavior
Normal SBO Sports bet	Greater than 0	No	Deduct cash balance according to existing logic
SBO Sports FreeBet bet	0	Yes	Do not deduct player cash balance. Store the parameters and create a promotion-funded bet

FreeBet request parameters

When a FreeBet wager is placed, ExtraInfo includes three additional fields:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Description
`PromotionRewardCode`	FreeBet ticket / reward identifier. Customer support and reconciliation can use this value for tracing.
`PromotionRewardAmount`	FreeBet stake amount. SBO Sports uses this amount to calculate payout. It is not the same as the top-level cash deduction amount.
`PromotionEventId`	568Win Promotion campaign ID, used for reporting, attribution, and customer support lookup.

Customer handler rules

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Customer handling
No Promotion Reward parameters	Process as a normal SBO Sports bet using existing logic.
`Amount = 0` and all three Promotion Reward parameters are valid	Treat as a FreeBet wager. Do not deduct player cash balance. Store the parameters and `TransferCode + TransactionId`.
`Amount = 0` but no Promotion Reward parameters	Do not infer FreeBet from amount alone. Process with existing zero amount validation.
Promotion Reward parameters exist but `Amount != 0`	Treat as a contract conflict and reject.
`PromotionRewardCode` is blank	Reject.
`PromotionRewardAmount <= 0`	Reject.
`PromotionEventId <= 0`	Reject.
Same `TransferCode + TransactionId` is retried with identical payload	Return the same idempotent result as the first request.
Same `TransferCode + TransactionId` but parameters, amount, player, product, or game differs	Treat as a duplicate transaction conflict and reject.

Response keeps the existing format

The response envelope does not need new FreeBet-specific fields and can continue using the existing format:

{\n  \"AccountName\": \"Player01\",\n  \"Balance\": 8262.52,\n  \"ErrorCode\": 0,\n  \"ErrorMessage\": \"No Error\",\n  \"BetAmount\": 0\n}\n

Balance returns the player's cash balance. The FreeBet stake must not be treated as a player cash deduction.

\n","urlObject":{"path":["Deduct"],"host":["https://customer-wallet.example.com"],"query":[],"variable":[]}},"response":[{"id":"76b37f35-0356-4a01-82e2-71f472ead1cd","name":"FreeBet Deduct Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"body":{"mode":"raw","raw":"{\n \"Amount\": 0,\n \"TransferCode\": \"3998211\",\n \"TransactionId\": \"3998211\",\n \"BetTime\": \"2026-05-05T00:23:25.9143053-04:00\",\n \"GameRoundId\": null,\n \"GamePeriodId\": null,\n \"OrderDetail\": null,\n \"PlayerIp\": \"1.2.3.4\",\n \"GameTypeName\": null,\n \"CompanyKey\": \"{{your_company_key_here}}\",\n \"Username\": \"player001\",\n \"ProductType\": 1,\n \"GameType\": 1,\n \"NewGameType\": 101,\n \"GameId\": 1,\n \"Gpid\": -2,\n \"ExtraInfo\": {\n \"sportType\": \"Football\",\n \"marketType\": \"Over/Under\",\n \"league\": \"ITALY SERIE A\",\n \"match\": \"Lecce vs Sampdoria\",\n \"betOption\": \"Over\",\n \"kickoffTime\": \"2026-05-05T00:23:25\",\n \"isHalfWonLose\": false,\n \"winlostDate\": null,\n \"PromotionRewardCode\": \"FB-2Q4W6E8R1T3Y5U7I\",\n \"PromotionRewardAmount\": 50.0,\n \"PromotionEventId\": 1001\n },\n \"SeamlessGameExtraInfo\": {\n \"FeatureBuyStatus\": 0,\n \"EndRoundStatus\": 0\n }\n}"},"url":"https://customer-wallet.example.com/Deduct"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"cookie":[],"responseTime":null,"body":"{\n \"AccountName\": \"Player01\",\n \"Balance\": 8262.52,\n \"ErrorCode\": 0,\n \"ErrorMessage\": \"No Error\",\n \"BetAmount\": 0\n}"},{"id":"cc155cb8-517b-42b0-aa88-6c6eb752a16a","name":"FreeBet Deduct Rejected","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"body":{"mode":"raw","raw":"{\n \"Amount\": 0,\n \"TransferCode\": \"3998211\",\n \"TransactionId\": \"3998211\",\n \"BetTime\": \"2026-05-05T00:23:25.9143053-04:00\",\n \"GameRoundId\": null,\n \"GamePeriodId\": null,\n \"OrderDetail\": null,\n \"PlayerIp\": \"1.2.3.4\",\n \"GameTypeName\": null,\n \"CompanyKey\": \"{{your_company_key_here}}\",\n \"Username\": \"player001\",\n \"ProductType\": 1,\n \"GameType\": 1,\n \"NewGameType\": 101,\n \"GameId\": 1,\n \"Gpid\": -2,\n \"ExtraInfo\": {\n \"sportType\": \"Football\",\n \"marketType\": \"Over/Under\",\n \"league\": \"ITALY SERIE A\",\n \"match\": \"Lecce vs Sampdoria\",\n \"betOption\": \"Over\",\n \"kickoffTime\": \"2026-05-05T00:23:25\",\n \"isHalfWonLose\": false,\n \"winlostDate\": null,\n \"PromotionRewardCode\": \"FB-2Q4W6E8R1T3Y5U7I\",\n \"PromotionRewardAmount\": 50.0,\n \"PromotionEventId\": 1001\n },\n \"SeamlessGameExtraInfo\": {\n \"FeatureBuyStatus\": 0,\n \"EndRoundStatus\": 0\n }\n}"},"url":"https://customer-wallet.example.com/Deduct"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"cookie":[],"responseTime":null,"body":"{\n \"AccountName\": \"Player01\",\n \"Balance\": 0,\n \"ErrorCode\": 1,\n \"ErrorMessage\": \"Invalid FreeBet parameters\",\n \"BetAmount\": 0\n}"}],"_postman_id":"98cf9f44-6693-490e-ab49-04299e032b1c"},{"name":"Settle Bet - FreeBet Uses Existing Settle","id":"1377f0b5-1e9b-4a4c-a25c-4139fdb22aaf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"body":{"mode":"raw","raw":"{\n \"TransferCode\": \"3998211\",\n \"WinLoss\": 150.0,\n \"ResultType\": 0,\n \"ResultTime\": \"2026-05-05T23:33:49.0404216-04:00\",\n \"CommissionStake\": 0.0,\n \"GameResult\": \"\",\n \"CompanyKey\": \"{{your_company_key_here}}\",\n \"Username\": \"player001\",\n \"ProductType\": 1,\n \"GameType\": 1,\n \"Gpid\": -2,\n \"IsCashOut\": false,\n \"ExtraInfo\": {\n \"sportType\": \"Football\",\n \"marketType\": \"Over/Under\",\n \"league\": \"ITALY SERIE A\",\n \"match\": \"Lecce vs Sampdoria\",\n \"betOption\": \"Over\",\n \"kickoffTime\": \"2026-05-05T00:23:25\",\n \"isHalfWonLose\": false,\n \"winlostDate\": \"2026-05-05T00:00:00\"\n }\n}"},"url":"https://customer-wallet.example.com/Settle","description":"

FreeBet impact

Settle does not need a FreeBet-specific endpoint or new request fields.

Find the original bet by TransferCode or the existing transaction identifier:

If the original bet is not FreeBet, continue using the existing settle logic.
If the original bet is FreeBet, credit the result based on the WinLoss / settlement amount sent by SBO Sports.
Do not recalculate FreeBet payout rules or MaxPayoutPerBet in the wallet.
Retain the Promotion Reward parameters stored during Deduct for support lookup and reconciliation.
If the same settlement payload is retried, return the same idempotent result.
If a different settlement amount or outcome is sent after settlement, reject it as a settlement conflict or require your existing rollback / resettlement flow first.

Response envelope keeps the existing format. No FreeBet-specific response fields are required.

\n","urlObject":{"path":["Settle"],"host":["https://customer-wallet.example.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"1377f0b5-1e9b-4a4c-a25c-4139fdb22aaf"},{"name":"Rollback - FreeBet Uses Existing Rollback","id":"8ef79fcf-6271-42c0-87a8-59b224a6d063","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"body":{"mode":"raw","raw":"{\n \"CompanyKey\": \"{{your_company_key_here}}\",\n \"Username\": \"player001\",\n \"TransferCode\": \"3998211\",\n \"ProductType\": 1,\n \"GameType\": 1,\n \"Gpid\": -2,\n \"ExtraInfo\": {\n \"sportType\": \"Football\",\n \"marketType\": \"Over/Under\",\n \"league\": \"ITALY SERIE A\",\n \"match\": \"Lecce vs Sampdoria\",\n \"betOption\": \"Over\",\n \"kickoffTime\": \"2026-05-05T00:23:25\",\n \"isHalfWonLose\": false,\n \"winlostDate\": null\n }\n}"},"url":"https://customer-wallet.example.com/Rollback","description":"

FreeBet impact

Rollback does not need a FreeBet-specific endpoint or new request fields.

Follow the existing rollback flow and move the wallet-side bet state back through your existing state model. Keep the Promotion Reward parameters with the transaction record.

Important: wallet rollback does not restore the 568Win FreeBet ticket to active. It only rolls back the wallet-side bet state according to the existing wallet contract.

If the same rollback payload is retried, return the same idempotent result.

Response envelope keeps the existing format. No FreeBet-specific response fields are required.

\n","urlObject":{"path":["Rollback"],"host":["https://customer-wallet.example.com"],"query":[],"variable":[]}},"response":[{"id":"78f48faa-f6a9-4ecb-81a1-e994370940ee","name":"Rollback Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"body":{"mode":"raw","raw":"{\n \"CompanyKey\": \"{{your_company_key_here}}\",\n \"Username\": \"player001\",\n \"TransferCode\": \"3998211\",\n \"ProductType\": 1,\n \"GameType\": 1,\n \"Gpid\": -2,\n \"ExtraInfo\": {\n \"sportType\": \"Football\",\n \"marketType\": \"Over/Under\",\n \"league\": \"ITALY SERIE A\",\n \"match\": \"Lecce vs Sampdoria\",\n \"betOption\": \"Over\",\n \"kickoffTime\": \"2026-05-05T00:23:25\",\n \"isHalfWonLose\": false,\n \"winlostDate\": null\n }\n}"},"url":"https://customer-wallet.example.com/Rollback"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"cookie":[],"responseTime":null,"body":"{\n \"AccountName\": \"Player01\",\n \"Balance\": 8222.52,\n \"ErrorCode\": 0,\n \"ErrorMessage\": \"No Error\"\n}"}],"_postman_id":"8ef79fcf-6271-42c0-87a8-59b224a6d063"},{"name":"Cancel Bet - FreeBet Uses Existing Cancel","id":"87271d06-50b0-4271-a2db-72e905044182","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"body":{"mode":"raw","raw":"{\n \"CompanyKey\": \"{{your_company_key_here}}\",\n \"Username\": \"player001\",\n \"TransferCode\": \"3998211\",\n \"ProductType\": 1,\n \"GameType\": 1,\n \"IsCancelAll\": true,\n \"TransactionId\": \"3998211\",\n \"Gpid\": -2,\n \"ExtraInfo\": {\n \"sportType\": \"Football\",\n \"marketType\": \"Over/Under\",\n \"league\": \"ITALY SERIE A\",\n \"match\": \"Lecce vs Sampdoria\",\n \"betOption\": \"Over\",\n \"kickoffTime\": \"2026-05-05T00:23:25\",\n \"isHalfWonLose\": false,\n \"winlostDate\": null\n }\n}"},"url":"https://customer-wallet.example.com/Cancel","description":"

FreeBet impact

Cancel does not need a FreeBet-specific endpoint or new request fields.

Follow the existing cancel flow and move the wallet-side bet state to void.

If the bet is FreeBet, no player cash stake needs to be refunded because Deduct.Amount = 0.
Keep the Promotion Reward parameters for support lookup and reconciliation.
If the same cancel payload is retried, return the same idempotent result.

Response envelope keeps the existing format. No FreeBet-specific response fields are required.

\n","urlObject":{"path":["Cancel"],"host":["https://customer-wallet.example.com"],"query":[],"variable":[]}},"response":[{"id":"2ac22eac-b36e-4d26-8b9e-dfa4a3628546","name":"Cancel Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"body":{"mode":"raw","raw":"{\n \"CompanyKey\": \"{{your_company_key_here}}\",\n \"Username\": \"player001\",\n \"TransferCode\": \"3998211\",\n \"ProductType\": 1,\n \"GameType\": 1,\n \"IsCancelAll\": true,\n \"TransactionId\": \"3998211\",\n \"Gpid\": -2,\n \"ExtraInfo\": {\n \"sportType\": \"Football\",\n \"marketType\": \"Over/Under\",\n \"league\": \"ITALY SERIE A\",\n \"match\": \"Lecce vs Sampdoria\",\n \"betOption\": \"Over\",\n \"kickoffTime\": \"2026-05-05T00:23:25\",\n \"isHalfWonLose\": false,\n \"winlostDate\": null\n }\n}"},"url":"https://customer-wallet.example.com/Cancel"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"cookie":[],"responseTime":null,"body":"{\n \"AccountName\": \"Player01\",\n \"Balance\": 8242.52,\n \"ErrorCode\": 0,\n \"ErrorMessage\": \"No Error\"\n}"}],"_postman_id":"87271d06-50b0-4271-a2db-72e905044182"},{"name":"Get Bet Status - No FreeBet-Specific Fields","id":"fa77e40e-576d-4db2-9a90-0f1f6441e57b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"body":{"mode":"raw","raw":"{\n \"CompanyKey\": \"{{your_company_key_here}}\",\n \"Username\": \"player001\",\n \"TransferCode\": \"3998211\",\n \"ProductType\": 1,\n \"GameType\": 1,\n \"Gpid\": -2\n}"},"url":"https://customer-wallet.example.com/GetBetStatus","description":"

FreeBet impact

GetBetStatus does not need new FreeBet-specific fields.

This endpoint queries the existing Customer Seamless Wallet bet status. It is not the backoffice FreeBet Ticket status and does not expose internal FreeBet Ticket Detail fields.

Continue returning existing wallet-side bet statuses, for example:

running
settled
void

If the bet is an SBO Sports FreeBet wager, the same response envelope and existing bet status rules still apply.

\n","urlObject":{"path":["GetBetStatus"],"host":["https://customer-wallet.example.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"fa77e40e-576d-4db2-9a90-0f1f6441e57b"}],"id":"4b80b30d-e0be-4ae2-94fa-0040f5e87be2","description":"

This folder provides change examples for Customer Seamless Wallet implementers.

Existing Seamless Wallet endpoint paths, HTTP methods, CompanyKey authentication, request envelopes, and response envelopes do not change.

Customer checklist:

GetBalance does not need FreeBet-specific logic
Deduct must identify the FreeBet parameters
Settle, Cancel, and Rollback continue using the existing bet lifecycle
GetBetStatus continues returning existing wallet-side statuses
Bonus is not the default payout path for SBO Sports FreeBet

The most important endpoint is Deduct: when SBO Sports FreeBet is used, Amount = 0 and ExtraInfo contains the Promotion Reward parameters. Your wallet should store these parameters with TransferCode + TransactionId for later settlement, rollback, cancellation, support lookup, and reconciliation.

\n","_postman_id":"4b80b30d-e0be-4ae2-94fa-0040f5e87be2"},{"name":"Backoffice Setup Notes","item":[{"name":"Documentation Note - Complete Flow and Setup Stages","id":"0d8a5507-e879-4ba1-82a0-6ade894a8ff9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://example.invalid/docs-only/freebet-full-flow","description":"

Documentation note only. Do not send this request. This item explains back-office setup; it is not an API endpoint.

Complete Cross Promotion flow in the API system

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Step	Where	What you do	Result
1	Back office Promotion List	Create a Promotion for `SBO Sports` + `FreeBet`.	A FreeBet Promotion draft is created.
2	Basic Settings / Promotion Event	Set Promotion name, event time, product, reward type, and Issuance Method.	The Promotion is classified as API Issuance or System Auto Issuance.
3	Budget & Risk Controls	Configure currency, FreeBet amount, player claim limit, total budget, and max payout.	568Win can enforce issuance budget, per-player claim limit, and payout cap.
4	Issuance Conditions	Configure mission/qualification rules only for System Auto Issuance.	568Win can automatically determine player qualification.
5	Reward Usage Conditions	Configure ticket expiry and eligible SBO Sports conditions.	The player can use FreeBet only under the configured usage rules.
6	Review / Activate	Review settings and activate the Promotion.	The Promotion can issue and validate FreeBet tickets. Save the `PromotionKey`.
7	Optional 13.5 Cross Promotion Reward setting	When a WL/API promotion should give this FreeBet reward, choose Cross Promotion Reward, select this campaign, and set the reward count.	The WL/API promotion can assign this FreeBet reward when its own promotion flow qualifies the player.
8	568Win FreeBet API	For API Issuance, call the single or batch issuance API.	568Win creates FreeBet tickets for selected players.
9	Customer Seamless Wallet	Support `Deduct.Amount = 0` and the Promotion Reward parameters in `ExtraInfo`.	FreeBet bets run through the existing wallet lifecycle without new endpoints.
10	Support / reconciliation	Use FreeBet ticket lookup and wallet references.	You can reconcile by `PromotionRewardCode`, `PromotionEventId`, `TransferCode`, and `TransactionId`.

13.5 Cross Promotion Reward setting

Use the 13.5 Cross Promotion Reward setting only when another WL/API promotion should issue this FreeBet reward after its own qualification flow.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Setting	What to check
Reward Mode	Select Cross Promotion Reward.
Reward Campaign	Select the active FreeBet Promotion created in Cross Promotion.
Reward Count	Number of FreeBet tickets to issue per qualified request.
Currency	Must match the selected FreeBet Promotion currency.
PromotionKey	Keep the generated key stable; backend issuance uses it to map to the FreeBet Promotion.

Before launch, confirm the selected FreeBet Promotion is active, uses API Issuance, supports the same currency, and the reward count is within the configured player claim limit and assignment count limit.

Five backoffice setup stages

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Stage	Screen	Customer action	Checkpoint
1	Basic Settings / Promotion Event	Create promotion name, promotion period, Product, Reward Type, and Issuance Method	Confirm whether this FreeBet uses API Issuance or System Auto Issuance
2	Amount and Risk / General Setting	Configure currency, FreeBet amount, total budget, player claim count, and max payout	Confirm amount, currency, budget cap, and max payout match promotion rules
3	Qualifying Conditions	Configure player-facing mission rules only for System Auto Issuance	Confirm metric, period, threshold, and SBO Sports conditions are complete
4	Use Conditions	Configure ticket expiry time and eligible SBO Sportsbook conditions	Confirm ticket expiry and eligible SBO Sportsbook conditions match the promotion terms
5	Review / Activate	Review and activate the promotion	Issuance and usage start only after activation

Sportsbook conditions

Use Sports Conditions define where the player can use the FreeBet.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Setting	What it means for you
Condition group	A group of rules for one set of eligible bets. Add another group when you need a separate rule set.
Condition logic	How this group combines with the previous group, for example AND logic.
Applicable to	Whether the FreeBet can be used on live bets, non-live bets, or both.
Sport filter	Include or exclude specific sports.
League filter	Include or exclude specific leagues within the selected sport.
Match filter	Include or exclude specific matches.
Market filter	Include or exclude specific market types.
Odds condition	Set minimum or maximum eligible odds. Odds are entered as Euro odds.

If no specific sport, league, match, or market is selected, the condition applies to all values allowed by the rule.

Complete flow diagram

\n\n

Back-office screen reference

These images help you understand where settings are configured and how the setup flow works. The production UI may differ slightly due to layout or wording adjustments.

Basic Settings / Promotion Event:

\n\n

Amount and Risk / General Setting:

\n\n

Qualifying Conditions:

\n\n

Responsibility boundary

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Area	Your responsibility
Back-office setup	Correctly create the promotion, amount, budget, qualification conditions, use conditions, and promotion status
13.5 Cross Promotion Reward setting	If another WL/API promotion issues this reward, select the correct active FreeBet Promotion and reward count.
API Issuance	If using API Issuance, call the 568Win FreeBet API to issue FreeBet to selected players.
Customer Seamless Wallet	Support `Deduct.Amount = 0` and `ExtraInfo` Promotion Reward parameters. Later lifecycle endpoints continue using existing logic
Support and reconciliation	Use `PromotionRewardCode`, `PromotionEventId`, `TransferCode`, and `TransactionId` for lookup

","urlObject":{"protocol":"https","path":["docs-only","freebet-full-flow"],"host":["example","invalid"],"query":[],"variable":[]}},"response":[],"_postman_id":"0d8a5507-e879-4ba1-82a0-6ade894a8ff9"},{"name":"Documentation Note - System Auto Issuance Backoffice Setup","id":"ab34904d-7dcc-4efe-af93-00e205b91b69","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://example.invalid/docs-only/system-auto-issuance-backoffice-setup","description":"

Documentation note only. Do not send this request. This item explains back-office setup; it is not an API endpoint.

What is System Auto Issuance?

System Auto Issuance means you create a player-facing FreeBet mission in back office. 568Win displays player progress and issues FreeBet automatically after the mission is completed.

You do not need to call the 568Win FreeBet issuance API for this issuance method.

Setup stages

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Stage	Your action
Step 1 Basic Settings	Choose System Auto Issuance, then configure promotion name and promotion period.
Step 2 Amount and Risk	Configure currency, FreeBet amount, total budget, player claim limit, and max payout.
Step 3 Qualifying Conditions	Configure what betting conditions a player must satisfy to automatically receive FreeBet.
Step 4 Use Conditions	Configure FreeBet ticket expiry time and eligible SBO Sportsbook conditions.
Step 5 Review / Activate	Review settings and activate the promotion.

Flow after activation

Player places a normal SBO Sports wager
568Win accumulates player progress based on backoffice mission rules
After the player completes the mission, 568Win automatically creates a FreeBet ticket
The player uses FreeBet to place a wager in SBO Sports
SBO Sports calls Customer Seamless Wallet Deduct
Deduct.Amount = 0, and ExtraInfo contains the Promotion Reward parameters
Later Settle, Cancel, and Rollback continue using existing endpoints

Checklist

Confirm qualification conditions, period, currency threshold, and SBO Sportsbook conditions
Confirm use conditions match promotion terms
Confirm Seamless Wallet can identify Deduct.Amount = 0 and the Promotion Reward parameters
Confirm support can look up tickets by FreeBetCode / PromotionRewardCode

\n","urlObject":{"protocol":"https","path":["docs-only","system-auto-issuance-backoffice-setup"],"host":["example","invalid"],"query":[],"variable":[]}},"response":[],"_postman_id":"ab34904d-7dcc-4efe-af93-00e205b91b69"},{"name":"Documentation Note - API Issuance Backoffice Setup","id":"a5745761-4347-40f9-96b0-3acbd0a8472e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://example.invalid/docs-only/api-issuance-backoffice-setup","description":"

Documentation note only. Do not send this request. This item explains back-office setup; it is not an API endpoint.

What is API Issuance?

API Issuance means you create a FreeBet Promotion in back office, then your system decides which player receives the FreeBet and calls the 568Win FreeBet API. If another WL/API promotion should give this reward, configure the 13.5 Cross Promotion Reward setting after the FreeBet Promotion is active.

Setup stages

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Stage	Your action
Step 1 Basic Settings	Choose API Issuance and save the `PromotionKey` provided by back office.
Step 2 Amount and Risk	Configure currency, FreeBet amount, total budget, player claim limit, and max payout.
Step 3 Qualifying Conditions	Usually not the main setup focus because selected players are determined by your system.
Step 4 Use Conditions	Configure FreeBet ticket expiry time and eligible SBO Sportsbook conditions.
Step 5 Review / Activate	Review settings and activate the promotion.
Optional 13.5 Cross Promotion Reward	Select this campaign when a WL/API promotion should issue this FreeBet reward, then set reward count.

Issuance flow

Your system or linked WL/API promotion flow decides which player should receive FreeBet
\n
Call \"Get FreeBet Promotions for API Issuance\" to confirm PromotionKey
\n
Call \"Issue FreeBet by API\" or \"Batch Issue FreeBet by API\"
\n
Response returns freeBetCode
\n
Allow a short processing time before treating the FreeBet as immediately available to the player
\n
When the player uses FreeBet, your Customer Seamless Wallet receives the same code in Deduct.ExtraInfo.PromotionRewardCode
\n

APIs used

POST /web-root/restricted/freebet/get-api-issuance-promotions.aspx
\n
POST /web-root/restricted/freebet/assign-api-issuance.aspx
\n
POST /web-root/restricted/freebet/assign-batch.aspx
\n

Checklist

Confirm the FreeBet Promotion is configured for API Issuance
\n
Save PromotionKey
\n
If using 13.5 Cross Promotion Reward, confirm the selected campaign, currency, and reward count are correct
\n
Confirm ExternalAssignmentReferenceNo, BatchExternalReferenceNo, and each ItemExternalReferenceNo are unique where applicable
\n
Confirm Customer Seamless Wallet can identify Deduct.Amount = 0 and the Promotion Reward parameters
\n
Confirm support can use ExternalAssignmentReferenceNo, FreeBetCode, and PromotionRewardCode for lookup and reconciliation
\n

\n","urlObject":{"protocol":"https","path":["docs-only","api-issuance-backoffice-setup"],"host":["example","invalid"],"query":[],"variable":[]}},"response":[],"_postman_id":"a5745761-4347-40f9-96b0-3acbd0a8472e"}],"id":"0d42f425-56ce-4aab-b32d-119129ce3db2","description":"

This folder explains backoffice setup for customers. These entries are documentation notes and do not need to be sent as requests.

Purpose:

Help you understand the complete Cross Promotion flow and the five back-office setup stages inside Postman
Explain the operational difference between API Issuance and System Auto Issuance
Connect back-office setup, optional 13.5 Cross Promotion Reward linkage, 568Win issuance APIs, and Customer Seamless Wallet Deduct / Settle / Cancel / Rollback into one complete flow

Read \"Complete Flow Diagram and Setup Stages\" first, then read the API Issuance or System Auto Issuance note based on your issuance method.

\n","_postman_id":"0d42f425-56ce-4aab-b32d-119129ce3db2"}],"variable":[{"key":"568WinApiDomain","value":"https://api.example.com"},{"key":"YourDomain","value":"https://customer-wallet.example.com"},{"key":"CompanyKey","value":"{{your_company_key_here}}"},{"key":"PlayerName","value":"player001"},{"key":"PromotionKey","value":"RETENTION-WEEKLY-301"},{"key":"CurrencyCode","value":"USD"},{"key":"ExternalAssignmentReferenceNo","value":"CRM-20260505-0001"},{"key":"FreeBetCode","value":"FB-2Q4W6E8R1T3Y5U7I"},{"key":"PromotionRewardAmount","value":"50.0"},{"key":"PromotionEventId","value":"1001"},{"key":"TransferCode","value":"3998211"},{"key":"TransactionId","value":"3998211"},{"key":"BatchExternalReferenceNo","value":"CRM-20260505-BATCH-0001","type":"string"},{"key":"ItemExternalReferenceNo1","value":"CRM-20260505-BATCH-0001-1","type":"string"},{"key":"ItemExternalReferenceNo2","value":"CRM-20260505-BATCH-0001-2","type":"string"}]}