SY包网 商户接口
游戏、上下分、注单都走这个地址。密钥在商户后台「接口密钥」里查看,只放在你的服务器上,不要写进网页或 App。
鉴权
每个请求带两个请求头。也可以放在 JSON 里,字段名是 account 和 api_key。
| 请求头 | 含义 |
|---|---|
X-Merchant-Code | 本商户的商户号 |
X-Api-Key | 该商户的密钥 |
请求体用 JSON,Content-Type: application/json。
链接
| 用途 | 方法 | 地址 |
|---|---|---|
| 查本商户额度 | GET | https://api.sybw.cc/v1/quota |
| 注册游戏账号 | POST | https://api.sybw.cc/v1/register |
| 进入游戏 | POST | https://api.sybw.cc/v1/login |
| 查游戏余额 | POST | https://api.sybw.cc/v1/balance |
| 上分 | POST | https://api.sybw.cc/v1/deposit |
| 下分 | POST | https://api.sybw.cc/v1/withdrawal |
| 查转账订单 | POST | https://api.sybw.cc/v1/orderstatus |
| 游戏列表 | POST | https://api.sybw.cc/v1/gamelist |
| 厂商列表 | POST | https://api.sybw.cc/v1/apilist |
| 游戏注单 | POST | https://api.sybw.cc/v1/gamerecord |
| 额度记录 | POST | https://api.sybw.cc/v1/orderrecord |
| 进入彩票大厅 | POST | https://api.sybw.cc/v1/lottery |
账号规则
游戏账号必须以本商户前缀开头,前缀后面接数字或下划线。例如你的前缀是 abc,账号就写成 abc_1001、abc1001。不能操作别的商户前缀。
本商户的商户号、前缀和密钥在商户后台查看:「商户信息 → 商户设置」或「财务管理 → 钱包充值」里的「接口密钥」。
参数
| 字段 | 用在 | 说明 |
|---|---|---|
| username | 除厂商列表、额度查询外 | 游戏账号 |
| password | 注册 | 6 到 32 位 |
| api_code | 进游戏、余额、上下分、列表、注单 | 厂商代码,如 PG、PP、JILI。经典百家乐填 SYDB |
| amount | 上分、下分 | 正整数。上分扣本商户额度,下分成功后加回 |
| gameCode | 进游戏 | 游戏代码,不填按 0 |
| gameType | 进游戏 | 不填按 3 |
| isMobile | 进游戏 | 0 电脑,1 手机。不填按 0 |
| order | 查转账 | 上分或下分返回的 transferno |
| type | 查转账 | IN 上分,OUT 下分 |
| page / pageSize | 列表、注单 | 页码从 1 开始,每页最多 100 |
返回
Code 为 0 表示成功。Message 是说明。Data 是结果,进游戏时里面有启动地址。transferno 是上下分订单号。points 是这次之后的商户额度。
{
"Code": 0,
"Message": "成功",
"Data": {},
"transferno": "",
"points": 0
}
进游戏示例
curl -s https://api.sybw.cc/v1/login \
-H 'Content-Type: application/json' \
-H 'X-Merchant-Code: 你的商户号' \
-H 'X-Api-Key: 你的密钥' \
-d '{"username":"你的前缀_1001","api_code":"PG","gameCode":"0","gameType":"3","isMobile":"0"}'
上分示例
curl -s https://api.sybw.cc/v1/deposit \
-H 'Content-Type: application/json' \
-H 'X-Merchant-Code: 你的商户号' \
-H 'X-Api-Key: 你的密钥' \
-d '{"username":"你的前缀_1001","api_code":"PG","amount":"100"}'
进彩票大厅
账号规则和进游戏一样,必须是本商户前缀。Data.url 打开就是彩票大厅,里面是当前正在开奖的全部彩种,十分钟内有效。
curl -s https://api.sybw.cc/v1/lottery \
-H 'Content-Type: application/json' \
-H 'X-Merchant-Code: 你的商户号' \
-H 'X-Api-Key: 你的密钥' \
-d '{"username":"你的前缀_1001"}'
经典百家乐
厂商代码 SYDB。开户、进厅、上下分和注单用上面的地址,api_code 填 SYDB。玩家打开进厅地址后在大厅下注,商户不要另外送注额。注额记在这个游戏账号上。
游戏账号必须是「前缀 + 下划线 + 后面的字符」,例如前缀 abc 写成 abc_1001。金额用元,最多两位小数。
| 用途 | 地址 | 成功时看 |
|---|---|---|
| 注册 | POST /v1/register | Data.username。重复注册也成功 |
| 进厅 | POST /v1/login | Data.url,60 秒内有效,只能打开一次 |
| 余额 | POST /v1/balance | Data.balance 是元 |
| 上分 / 下分 | POST /v1/deposit、/v1/withdrawal | Data.transferno、Data.amount、Data.balance |
| 查转账 | POST /v1/orderstatus | Data.status:success、notfound、pending |
| 注单 | POST /v1/gamerecord | Data.data。不填账号则是本商户全部会员 |
| 额度记录 | POST /v1/orderrecord | type 为 IN 或 OUT |
上分先扣商户额度,再加游戏余额。额度按自营公式:金额 × (1 + 点位 / 100)。点位在商户后台的 SYDB 配置里。点位是 10 时,上分 100 元,商户额度减少 110,游戏余额增加 100。下分成功后按同一公式加回。下分金额可以写 ALL,表示全部转出。
订单号放在 order。同一单号、同一账号、同一方向、同一金额再送一次,返回原来的成功结果。单号被别的金额用过会拒绝。
注单分页用 page 和 pageSize,每页最多 500。start_at、end_at 用秒。已结算按结算时间,未结算按下注时间。betStatus:open 未结算,won 赢,lost 输,push 退回,cancelled 取消。playType 是玩法,tableCode 是桌号,netAmount 是输赢。
闲、庄是 1:1。庄免佣的利润是注额的 0.95。和是 1:8。和局时闲、庄、庄免佣退回。闲对、庄对、幸运六、幸运七、超级幸运七目前退回本金。单注点上限 200,000。开牌、结算、洗牌时不能下注。
curl -s https://api.sybw.cc/v1/login \
-H 'Content-Type: application/json' \
-H 'X-Merchant-Code: 你的商户号' \
-H 'X-Api-Key: 你的密钥' \
-d '{"username":"你的前缀_1001","api_code":"SYDB"}'
curl -s https://api.sybw.cc/v1/deposit \
-H 'Content-Type: application/json' \
-H 'X-Merchant-Code: 你的商户号' \
-H 'X-Api-Key: 你的密钥' \
-d '{"username":"你的前缀_1001","api_code":"SYDB","amount":"100","order":"你的单号"}'