{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"17220fa1-243d-4df7-b76f-46559e2a22e6","name":"568Win免转钱包API 文档中文版","description":"### 免转钱包是什么?\n\n免转钱包允许您的玩家通过他们在您网站上注册的帐户或信用游玩 568Win 的所有产品。 \n如果您对此功能感兴趣，请联系 568Win 获取进一步的帮助。\n\n### 免转钱包如何运作?\n\n##### 当玩家下注时\n\n- 首先 568Win 将检查用户帐户的余额。568Win 将发出API请求，然后您接收到后应该将帐户余额发回给 568Win。 \n 请参阅 [取得用户帐号余额](#a28ae7ab-35a0-4508-88d4-8ed468588c12)\n \n- 如果用户没有足够的余额，568Win 将不接受该投注。 \n 如果用户有足够的余额来下注，568Win 会请您从用户帐户中扣除投注的金额。 \n 请参阅 [扣除投注金额](#e6a2e2f3-4133-4160-90ec-6b3f193d9b67)\n \n\n##### 当投注被接受后\n\n- 568Win会为您发送投注的结果。 请参阅 [结算投注](#5124e4cc-f6f2-4458-912c-d4c3d609ab0c) \n 如果 568Win 回滚了赌注，568Win将发送回滚请求通知您。请参阅 [回滚](#77c72820-0509-40c6-9e18-adbf6c8b6704) \n 如果 568Win 取消了赌注，568Win将发送取消请求通知您。请参阅 [取消投注](#e74ee04b-6349-4bd5-89cf-d0fce5205db5)\n \n\n## 公司密钥政策\n\n- 公司密钥是访问 568Win 系统所需的安全凭证。为确保安全，每个密钥都有一个有效期限制，过期后将无法继续使用。\n \n- 您可以选择密钥的有效期限。在后台的 **7.3 系统参数** 页面，您可以选择 30 天或 90 天的密钥有效期。\n \n- 为保持系统的持续访问，您必须在当前密钥到期之前生成一个新密钥。 \n 您可以透过后台 3.4 系统参数 或 [API 7.3 重新生成密钥](https://documenter.getpostman.com/view/39587621/2sAYdctCyH#7d541359-0c13-463b-bd53-e8e336cbfbef) 随时创建新密钥。\n \n\n#### **对于以下所有 API，应使用公司密钥 ApiType：**SeamlessWallet\n\n### 免转钱包 API 测试网站\n\n您可以依照以下的步骤, 点击 [测试网站](http://swtest-demo.568win.com/) 来测试您的 免转钱包 API\n\n![](\"https://content.pstmn.io/5258de27-0a50-42f7-a09f-2dfa50329a83/aW1hZ2UucG5n\")
\n\n### 流程图\n\n![\"seamlessWalletFlow\"](\"https://ex-api-yy2.ttbbyyllyy.com/content/image/seamlessWallet-flow_cn.png\")
\n\n### 投注状态\n\n系统中的投注状态应如下图所示：运行(running)，已结算(settled)和无效(void)。\n\n![\"betStatus\"](\"https://ex-api-yy2.ttbbyyllyy.com/content/image/betStatus_cn.png\")
\n\n### 通信协议\n\n```\n所有 API函式皆透过 HTTP post。 ● 所有 API请求符合以下规则:\n 1.Header:\n Content-Type: application/json; charset=UTF-8\n 2.Body:\n {\"CompanyKey\":\"7b277d9ad9f146a591a6d40bf4290d62c65bf0bcda32b50404a011733cfb7b1e\", \"Username\":\"test\"} ● 所有 API 回应必须是以 JSON 格式回应:\n 1.Header: Content-Type: application/json; charset=UTF-8\n 2.Body:\n {\"AccountName\":\"test\",\"Balance\":\"9463.50002\",\"ErrorCode\":\"0\",\"ErrorMessage\":\"No Error\"}\n\n ```\n\n## SBO Sports FreeBet 影响\n\nSBO Sports FreeBet 沿用既有 Seamless Wallet endpoints，不需要新增钱包 endpoint、不需要改变 endpoint path、不需要新的验证流程，也不需要改变 response envelope。\n\n当玩家使用 SBO Sports FreeBet 下注时，568Win 仍会调用既有的 `Deduct` API。\n\n此情况下：\n\n* `Amount` 会为 `0`，因为不会扣除玩家钱包余额。\n* [`ExtraInfo`](https://documenter.getpostman.com/view/39587621/2sAY55be3y#917de7a4-1bda-48b3-b6fd-f37f9bc0853b) 会带入 PromotionReward 参数，用于标识该注单为 SBO Sports FreeBet 注单。\n\n请参考附录中的 [ExtraInfo](https://documenter.getpostman.com/view/39587621/2sAY55be3y#917de7a4-1bda-48b3-b6fd-f37f9bc0853b) 相关说明。 \n注：一般注单不会带入 PromotionReward 参数。\n\n[`ExtraInfo`](https://documenter.getpostman.com/view/39587621/2sAY55be3y#917de7a4-1bda-48b3-b6fd-f37f9bc0853b) 内的 FreeBet 参数示例：\n\n```json\n{\n \"PromotionRewardCode\": \"FB-2Q4W6E8R1T3Y5U7I\",\n \"PromotionRewardAmount\": 50.0,\n \"PromotionEventId\": 1001\n}\n```\n\n请勿仅依据 `Amount = 0` 判断是否为 FreeBet 注单。当 [`ExtraInfo`](https://documenter.getpostman.com/view/39587621/2sAY55be3y#917de7a4-1bda-48b3-b6fd-f37f9bc0853b) 中存在 PromotionReward 参数时，请将该注单视为 SBO Sports FreeBet 注单，并保存以下资料：\n\n* PromotionReward\n* `TransferCode`\n* `TransactionId`\n\n后续仍请沿用既有的 `Settle`、`Cancel` 与 `Rollback` 流程处理。","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"39587621","team":6541681,"collectionId":"17220fa1-243d-4df7-b76f-46559e2a22e6","publishedId":"2sAY55be3y","public":true,"publicUrl":"https://documenter-api.postman.tech/view/39587621/2sAY55be3y","privateUrl":"https://go.postman.co/documentation/39587621-17220fa1-243d-4df7-b76f-46559e2a22e6","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-single-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"dark","themes":[{"name":"dark","logo":"https://content.pstmn.io/4874f4c5-c36d-4878-9477-c1852b5c54d6/NTY4V2luX2xvZ29fY29sb3JfY24ucG5n","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":"https://content.pstmn.io/4874f4c5-c36d-4878-9477-c1852b5c54d6/NTY4V2luX2xvZ29fY29sb3JfY24ucG5n","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2024-11-25T09:09:41.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/4874f4c5-c36d-4878-9477-c1852b5c54d6/NTY4V2luX2xvZ29fY29sb3JfY24ucG5n","logoDark":"https://content.pstmn.io/4874f4c5-c36d-4878-9477-c1852b5c54d6/NTY4V2luX2xvZ29fY29sb3JfY24ucG5n"}},"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/768118b36f06c94b0306958b980558e6915839447e859fe16906e29d683976f0","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/2sAY55be3y"}