Lucky Gaming
✈ @lucky_gaming
Lucky Gaming开发文档
DEVELOPER DOCUMENTATION

开发文档
清晰规范 · 快速联调

本页是可上线的文档结构示例；正式接口字段应以项目签署后的技术文档为准。

QUICK START

接入准备

1

商户资料

取得 merchantId、API Key 和沙箱域名。

2

网络配置

提交服务器IP白名单与回调地址。

3

接口联调

完成签名、用户、钱包、启动和回调测试。

4

上线验收

完成压力、安全和异常流程验证。

AUTHHMAC-SHA256

请求签名

建议使用时间戳、随机串、商户编号、请求路径和请求体构建规范字符串。

canonical = timestamp + "\n" + nonce + "\n" + merchantId + "\n" + path + "\n" + body
signature = HMAC_SHA256(secret, canonical)

接口列表

方法路径用途
POST/api/v1/member/login创建或同步会员会话
POST/api/v1/wallet/balance查询余额与币种
POST/api/v1/game/list获取游戏列表
POST/api/v1/game/launch获取启动URL
POST/api/v1/order/query查询订单状态
CALLBACK/merchant/order/callback接收订单事件
POST/api/v1/member/login
{
  "merchantId": "lg_demo_001",
  "memberId": "user_10086",
  "currency": "USDT",
  "lang": "zh-CN"
}
POST/api/v1/game/launch
{
  "memberId": "user_10086",
  "gameCode": "SPORTS_DEMO",
  "returnUrl": "https://merchant.example/home"
}

// response
{ "code": 0, "launchUrl": "https://sandbox.example/launch/..." }
CALLBACK/merchant/order/callback

回调接收下注、结算、取消和调整。商户必须按 eventId 实现幂等，并在限定时间内返回成功响应。

失败回调应使用指数退避重试；生产环境需记录原始请求、签名验证结果和处理状态。

错误代码

Code说明处理建议
0成功继续处理
1001签名无效检查密钥、时间戳与规范字符串
1002请求过期同步服务器时间并重新请求
2001会员不存在先创建或同步会员
3001游戏维护提示用户稍后重试
4001余额不足检查钱包状态
5000系统异常记录 requestId 并联系技术支持
SEC

生产安全建议

所有请求使用 HTTPS密钥存储在安全配置或密钥管理系统配置IP白名单、限流和重放保护回调采用签名、幂等和审计日志不要在浏览器前端暴露API密钥
以上接口名称和字段用于网页演示，不代表实际生产协议。正式项目由双方确认技术规范。
TG✦