SY包网 商户接口

游戏、上下分、注单都走这个地址。密钥在商户后台「接口密钥」里查看,只放在你的服务器上,不要写进网页或 App。

文档:接口 · 产品概要 · 使用指南 · 接入流程
接口目录:https://api.sybw.cc/v1

鉴权

每个请求带两个请求头。也可以放在 JSON 里,字段名是 account 和 api_key。

请求头含义
X-Merchant-Code本商户的商户号
X-Api-Key该商户的密钥

请求体用 JSON,Content-Type: application/json。

链接

用途方法地址
查本商户额度GEThttps://api.sybw.cc/v1/quota
注册游戏账号POSThttps://api.sybw.cc/v1/register
进入游戏POSThttps://api.sybw.cc/v1/login
查游戏余额POSThttps://api.sybw.cc/v1/balance
上分POSThttps://api.sybw.cc/v1/deposit
下分POSThttps://api.sybw.cc/v1/withdrawal
查转账订单POSThttps://api.sybw.cc/v1/orderstatus
游戏列表POSThttps://api.sybw.cc/v1/gamelist
厂商列表POSThttps://api.sybw.cc/v1/apilist
游戏注单POSThttps://api.sybw.cc/v1/gamerecord
额度记录POSThttps://api.sybw.cc/v1/orderrecord
进入彩票大厅POSThttps://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/registerData.username。重复注册也成功
进厅POST /v1/loginData.url,60 秒内有效,只能打开一次
余额POST /v1/balanceData.balance 是元
上分 / 下分POST /v1/deposit、/v1/withdrawalData.transferno、Data.amount、Data.balance
查转账POST /v1/orderstatusData.status:success、notfound、pending
注单POST /v1/gamerecordData.data。不填账号则是本商户全部会员
额度记录POST /v1/orderrecordtype 为 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":"你的单号"}'