单一钱包 Agent API
单一钱包API的IP位址为？
-
49.128.79.50
-
54.64.194.205
-
52.199.206.85
-
3.123.60.168
请向对接整合团队确认应加白的IP位址。
无法接收到单一钱包Single Wallet Agent API的任何回应？
请确认以下事项：
-
您的 API callback URL设定正确并能接收到我端传送的请求。
-
确认您的callback URL使用的是标准的连接埠(443或80)。
即使能收到请求与回应资料，但出现错误讯息。一启动游戏即出现错误讯息。
请确认您传送给我端的资料表头是否正确：
-
X-MGP-REQ-ID应与传送给贵端的相同；举例：如果我端传送到贵端的值为 1234-567891-2345-6789 ，您回传的值也应为1234-567891-2345-6789。 -
X-MGP-RESPONSE-TIME应为处理请求所花费的时间，举例：10 (表示为10毫秒)。
请按照MG+平台整合单一钱包营运商手册的说明回传资料。
何时呼叫/login method?
请于点击启动游戏网址(经由呼叫/sessions API取得)时呼叫。
何时呼叫/getbalance method?
可经常性地于游戏进行过程中呼叫。
何时呼叫/updatebalance method?
针对一般的slot games, 呼叫/updatebalance的时机为：
-
txnType=DEBIT(金额为0则不传送，如免费旋转) -
txnType=CREDIT(金额为0则不传送)
txnType=CREDIT，completed:true则代表游戏结束。
何时呼叫/rollback method?
一般情况下不会呼叫，应先由您的Account Manager进行通知确认使用时机。仅限于真人游戏发生需要回朔的交易时使用。
那些为幂等参数?
betId为幂等参数，对应到整个投注/获胜/游戏结束的过程。
txnId 为幂等参数，对应到一笔交易纪录（debit、credit）。
roundId用途为?
roundId目前已不使用。
txnId, betId与roundId的最大长度为?
txnId, betId与roundId为strings（varchar），最大长度为1000。
单一钱包API
那些国家无法访问游戏?
MG Asia 游戏仅有亚洲区域可以访问。台湾与新加坡的IP位址亦无法访问。
那些功能需要加白IP位址才能使用?
使用API需要加白。使用MG+ Backoffice则无限制。
得到 401 错误讯息。
请确认您的API呼叫，于表头的验证区段内有包含 STS令牌。
得到 403 错误讯息。
请确认您的IP位址是否有加白。
得到 404 错误讯息。
-
请确认您的API位址是否正确，路径中有无包含
/api/v1。 -
或是 STS位址是否有包含
/connect/token。
API应使用哪一个时区?
应使用UTC+0，除非文件中特别指定其他时区。
API呼叫应该使用甚么content type?
Content-Type: application/x-www-form-urlencoded
Accept: application/json
STS令牌相关
令牌能否多次使用?
令牌到期时间为１小时，期间内可多次使用。我们建议每隔45-50分钟更新令牌。
请求新的令牌后，旧的令牌是否自动失效?
旧的令牌在还未超过到期时间时，不会失效。
游戏相关
如何取得游戏清单与游戏代码?
可透过Master Games List excel文档或呼叫/agents/{agentCode}/games。
游戏启动时出现错误代码 107。
该国家被禁止访问游戏.
可能为与 MG+及营运商端的Agent API相关的任何错误。
较常发生在/login或 /getbalance method。
游戏读取速度缓慢，最终出现一般错误。
可能为 MG+及营运商端的Agent API发生过期异常，或是callback URL设定错误。