注单详情页链接
1、注单详情页链接
说明
- 商户在自己后台的注单日志里，可以为单笔注单拼出一个 EEAI 注单详情页链接，直接在浏览器打开，或嵌入 iframe 展示
- 页面展示该注单的基本信息（注单号、玩家、游戏、台桌、局号、币种、时间、金额、状态）、开牌/开奖结果和投注明细，不需要登录，不提供视频回放
- 只能查看本商户及下级商户的注单；未结算的注单也可以查看，输赢显示为「--」
- 链接本身就是访问凭证，有效期内任何人拿到链接都能查看这一笔注单，请不要外传
链接格式
https://merchant.aig1234.com/#/bet-detail?agent_id={agent_id}&txn_id={txn_id}&lang={lang}&tz={tz}×tamp={timestamp}&sign={sign}
链接参数
| 参数 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| agent_id | 商户 ID | string | 必填 | 商户 ID |
| txn_id | 注单 ID | string | 必填 | 注单 ID（投注记录接口返回的 id） |
| lang | 页面语言 | string | 选填 | zh：中文，其他值或不传：英文 |
| tz | 显示时区 | string | 选填 | 相对 UTC 的小时数，取值 -12 ~ 14，如 8 表示 UTC+8、-4 表示 UTC-4；正数不要带 +；不传按 UTC+0 |
| timestamp | 生成时间戳 | int64 | 必填 | 生成链接时的时间戳（单位毫秒），链接 24 小时 内有效 |
| sign | 签名 | string | 必填 | 签名算法详见接口说明，lang、tz 传了也要参与签名 |
注意事项
- 签名必须在商户服务端生成，不要在浏览器 JS 里计算，否则密钥会泄露
- 参数按参数名 ASCII 码排序后拼接，注意
txn_id排在tz前面 - 签名使用参数原值（不做 URL 编码）；拼到链接里时按 URL 规则编码
- 链接过期后页面会提示「链接已过期」，重新生成即可；建议在客服点击时实时生成
- 页面支持 iframe 嵌入，窄屏下自动改为单列显示
签名范例
- 商户私钥为 your_secret
- 参数：agent_id=agent001，txn_id=67f8cdf7ab12bf8b5b606115，lang=en，tz=-4，timestamp=1761638400000
- 拼接后的字符串：
your_secret&agent_id=agent001&lang=en×tamp=1761638400000&txn_id=67f8cdf7ab12bf8b5b606115&tz=-4
- md5 结果：
25bc6d9a3313f0dfc5be6fa7d2eaef28
- 最终链接：
https://merchant.aig1234.com/#/bet-detail?agent_id=agent001&txn_id=67f8cdf7ab12bf8b5b606115&lang=en&tz=-4×tamp=1761638400000&sign=25bc6d9a3313f0dfc5be6fa7d2eaef28
页面错误提示
| 提示 | 原因 |
|---|---|
| 链接参数不完整 | 缺少 agent_id、txn_id、timestamp、sign 其中之一 |
| 链接无效 | 签名错误或商户不存在 |
| 链接已过期 | timestamp 超过 24 小时，或比当前时间超前 5 分钟以上 |
| 注单不存在 | 注单 ID 不存在，或不属于本商户及下级商户 |
| 商户已停用 | 商户已被停用 |
| 请求过于频繁 | 同一 IP 短时间内打开次数过多，请稍后再试 |