本页为机器翻译。如译文有出入,以英文版为准。 阅读英文版
集成与 API
您的钱包,您的玩家,我们的游戏在 iframe 中。
集成沿用加密货币赌场与游戏提供商已在使用的模式:游戏在 iframe 中运行,资金留在运营商的钱包里,我们的服务器通过签名的幂等请求与您的服务器通信。
开发中。 运营商 API 正在开发中。本页描述的是我们正在构建的设计;字段级文档将在首款游戏向运营商提供之前发布。
游戏启动
您为玩家会话请求一个启动 URL,并在大厅的 iframe 中打开。会话带有您选定的玩家标识、币种和语言。游戏以移动端优先构建,并可扩展到桌面端。
无缝钱包(seamless wallet)
余额从不离开您的系统。玩家下注时,我们的服务器请求您的钱包扣除投注额;回合派彩时,请求您的钱包记入赢额;失败的回合会被回滚。我们不持有玩家资金,也不保留平行的余额。
API 概览
- 您的平台调用我们来开启游戏会话并获取启动 URL,也用来读取回合历史和报表。
- 资金变动时,我们的服务器会调用您的钱包:读取余额、扣除投注、记入赢额,并撤销失败的扣款。
- 消息为基于 HTTPS 的 JSON。金额是以货币最小单位表示的整数,因此不会出现舍入误差。
- 每次调用都可以安全重复:相同的交易 ID 总是得到相同的答复。
签名的幂等请求
- 我们的服务器与您的服务器之间的每个请求都用共享密钥签名并带有时间戳,因此无法被伪造,也无法在之后被重放。
- 每笔资金变动都带有唯一的交易 ID。用同一 ID 重复请求会返回原来的应答,绝不会重复动账,因此超时后的重试是安全的。
- 结果未知的情形,例如扣款后超时,通过用同一 ID 重试来解决,而不是靠猜测。
演示模式
每款游戏都可在演示模式下运行,使用虚拟余额,不调用钱包:用于大厅预览、联盟推广,以及想先试玩再下注的玩家。
运营商后台
- 可按回合 ID 查询的回合历史,以及根据种子重放任意回合。
- 按游戏、币种和时间段统计的 GGR 报表,可导出。
- 您已启用的每款游戏及版本的数学护照。
商业模式
按我们的游戏在您的赌场产生的 GGR 收益分成。资金池、钱包和与玩家的关系都由您掌握。条款直接商定,请给我们写信。
常见问题
什么是无缝钱包?
玩家的余额留在赌场自己的钱包中。游戏提供商从不持有余额:它逐回合要求赌场扣除投注并记入赢额。另一种方式是转账钱包,即在游戏前把资金转入提供商的系统;我们不采用这种方式。
游戏如何启动?
您的平台向我们的服务器请求玩家会话的启动 URL,并在您大厅的 iframe 中打开,手机和桌面端都一样。会话携带您选定的玩家 ID、币种和语言。
请求超时会怎样?
每个涉及资金的请求都带有唯一的交易 ID。请求会用同一个 ID 重复发送,直到得到答复,而您的钱包对重复的 ID 返回原始结果,因此资金绝不会变动两次。无法确认的扣款会用同一个 ID 撤销,而不是靠猜测。
请求如何受到保护?
每个请求都用与您的平台共享的密钥签名,并带有时间戳。签名错误或时间戳过旧的请求会被拒绝,因此无法被伪造,也无法在事后被重放。
有演示模式吗?
有。每款游戏都可以使用虚拟余额运行,且不调用钱包:用于大厅预览、联盟推广方,以及想在下注前先试玩的玩家。
API 什么时候可用?
目前正在开发中。在第一款游戏向运营商提供之前,我们会公布字段级文档。早期合作伙伴现在就可以与我们一起规划集成。