创建直充订单 - 闲管家虚拟货源标准接口

请求参数

Query 参数

mch_id

string

必需

货源平台商户ID（AppKey）

默认值:

timestamp

integer

必需

当前时间戳（单位秒，5分钟内有效）

默认值:

sign

string

必需

签名MD5值（参考签名说明）

默认值:

Body 参数application/json

order_no

string

管家订单号

必需

示例值:

1929063817978999932

goods_no

string

商品编码

必需

示例值:

12344532

biz_content

object (业务参数)

直充参数

必需

仅用于直充订单

account

string

充值账号

必需

示例值:

13800138000

game_name

string

游戏名称

可选

示例值:

王者荣耀

game_role

string

游戏角色

可选

示例值:

貂蝉

game_area

string

游戏区

可选

示例值:

A区

game_server

string

游戏服

可选

示例值:

国服

buyer_ip

string

买家下单IP

可选

示例值:

113.87.236.130

buyer_area

string

买家所在区

可选

示例值:

深圳市

buy_quantity

integer <int32>

购买数量

必需

示例值:

max_amount

integer <int64>

最大金额（分）

可选

注意：该金额为订单总价，也是商家可接受最大成本金额，用于防止商家亏损。如该字段未传入时则不要校验安全价

示例值:

1000

notify_url

string

回调地址

必需

针对需要异步处理的订单

示例值:

https://open.goofish.pro/api/open/callback/virtual/order/notify/{token}

biz_order_no

string

业务订单号

必需

示例值:

1929063817978999932

示例

{
  "order_no": "1929063817978999932",
  "goods_no": "12344532",
  "biz_content": {
    "account": "13800138000",
    "game_name": "王者荣耀",
    "game_role": "貂蝉",
    "game_area": "A区",
    "game_server": "国服",
    "buyer_ip": "113.87.236.130",
    "buyer_area": "深圳市"
  },
  "buy_quantity": 1,
  "max_amount": 1000,
  "notify_url": "https://open.goofish.pro/api/open/callback/virtual/order/notify/{token}",
  "biz_order_no": "1929063817978999932"
}

返回响应

🟢200成功

application/json

Body

code

enum<integer> <int32>

必需

>= 0<= 0

默认值:

示例值:

固定值:

msg

string

必需

默认值:

data

object

必需

order_no

string

管家订单号

必需

示例值:

1929063817978999932

out_order_no

string

货源订单号

必需

示例值:

API2024123012834901444

order_status

enum<integer> <int32>

订单状态

必需

10：处理中
20：已成功
30：已失败

注意：订单状态为处理中，表示异步处理，后续通过回调地址通知结果

枚举值:

102030

示例值:

order_amount

integer <int64>

订单金额（分）

必需

示例值:

1000

goods_name

string

商品名称

必需

示例值:

【自动充值】哔哩哔哩大会员『7天』

order_time

integer <int32>

下单时间

必需

示例值:

1725349041

end_time

integer <int32>

完结时间

可选

订单状态为已成功或已失败时，必须返回完结时间

示例值:

1723870189

remark

string

订单备注

可选

如下单失败原因

示例值:

该运营商地区不支持充值

示例

{
  "code": 0,
  "msg": "OK",
  "data": {
    "order_no": "1929063817978999932",
    "out_order_no": "API2024123012834901444",
    "order_status": 10,
    "order_amount": 1000,
    "goods_name": "【自动充值】哔哩哔哩大会员『7天』",
    "order_time": 1725349041,
    "end_time": 1723870189,
    "remark": "该运营商地区不支持充值"
  }
}

🟢200失败