{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"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\n\n1. In back office, create a Promotion for `SBO Sports` + `FreeBet`.\n2. Select the `Issuance Method`:\n   - `API Issuance`: your system decides which players receive FreeBet and calls the 568Win FreeBet API.\n   - `System Auto Issuance`: 568Win evaluates the configured mission/qualification rules and issues FreeBet automatically.\n3. Configure currency, FreeBet amount, player claim limit, total budget, max payout, expiry, and usage conditions.\n4. Activate the Promotion and save the generated `PromotionKey`.\n5. 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.\n6. 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.\n7. 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`.\n8. `Settle`, `Cancel`, `Rollback`, and `GetBetStatus` continue through the existing wallet lifecycle.\n9. Use FreeBet ticket lookup, `PromotionRewardCode`, `PromotionEventId`, `TransferCode`, and `TransactionId` for support and reconciliation.\n\n### Purpose\n\nThis 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.\n\nYou will learn:\n\n1. What must be configured in each backoffice setup stage\n2. The difference between API Issuance and System Auto Issuance\n3. Which 568Win FreeBet APIs are used for API Issuance\n4. Which FreeBet request examples and processing rules your Customer Seamless Wallet must support\n\n### What you should know first\n\nSBO Sports FreeBet has two issuance methods:\n\n| Issuance method | Issuance behavior | Do you need to call the 568Win FreeBet API? |\n| --- | --- | --- |\n| API Issuance | You create a FreeBet Promotion in back office, then your system assigns and issues FreeBet to selected players through the API | Yes |\n| System Auto Issuance | 568Win automatically issues FreeBet after you configure a player-facing FreeBet mission and the player completes it | No |\n\n### Customer Seamless Wallet impact\n\nExisting wallet endpoint paths, HTTP methods, authentication, request envelopes, and response envelopes do not change.\n\nYour wallet handlers only need to recognize FreeBet wagers inside the existing Sports lifecycle:\n\n- `GetBalance` does not need FreeBet-specific logic.\n- `Deduct` must identify the Promotion Reward parameters in `ExtraInfo`.\n- `Settle`, `Cancel`, and `Rollback` continue using the existing transaction lifecycle.\n- `GetBetStatus` continues returning wallet-side bet status.\n- `Bonus` is not the default payout path for SBO Sports FreeBet.\n\nSBO Sports FreeBet wagers use `Deduct.Amount = 0` and include:\n\n```json\n{\n  \"PromotionRewardCode\": \"FB-2Q4W6E8R1T3Y5U7I\",\n  \"PromotionRewardAmount\": 50.0,\n  \"PromotionEventId\": 1001\n}\n```\n\nDo not identify FreeBet from `Amount = 0` alone. Use the Promotion Reward parameters in `ExtraInfo`.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"39587621","team":6541681,"collectionId":"9b99479a-adc6-47e0-be3c-899899ac96bd","publishedId":"2sBXqMHKGA","public":true,"publicUrl":"https://documenter-api.postman.tech/view/39587621/2sBXqMHKGA","privateUrl":"https://go.postman.co/documentation/39587621-9b99479a-adc6-47e0-be3c-899899ac96bd","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-single-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.12.3","publishDate":"2026-05-06T06:12:32.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/e65ac9c1ddaecab6b4c1dc85f0b34f0258c84e4da334b7f5b0d1e7df13338dc5","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2sBXqMHKGA"}