用户供应API接口文档
  1. 上报订单
用户供应API接口文档
  • 开发指南
    • 接口签名介绍
    • 常见问题
  • 接口文档
    • 手工单取单API-供应文档
      • 概述
      • 渠道说明
      • 获取订单
        • 话费
        • 权益
        • 直播/游戏娱币
        • 流量
      • 上报订单
        • 上报API查单
          • 查单简介
        • 上报订单结果
          POST
      • 查询订单
        • 通过用户订单ID查询
        • 通过订单状态查询(默认只查询近2天)
        • 通过用户订单ID和订单状态查询
      • 获取渠道风控
        • 获取用户渠道定时风控信息
      • 渠道报价
        • 获取渠道报价信息
          • 话费
          • 权益
          • 直播/游戏娱币
        • 上报渠道报价信息
          • 话费
          • 权益
          • 直播/游戏娱币
    • 手工单推单API-供应文档
      • 渠道说明
      • 手工单推单开关配置
        • 推单开关查询
        • 推单开关修改
      • 手工单推单报价设置
        • 电影票
          • 获取省份和城市列表信息
          • 获取院线/影片/影厅信息接口
          • 获取影院列表接口
          • 获取报价规则列表
          • 获取报价规则详情信息
          • 保存报价规则信息
          • 更新报价规则供应状态
          • 删除报价规则信息
        • 获取商品(全部)接口
        • 修改商品报价(已供应)接口
        • 修改商品报价(话费省份报价)接口
        • 修改商品省份(仅适用于话费订单)接口
        • 修改供应商品终端限制(已供应)接口
      • 无服务器推单模式
        • 获取已经分配给用户的订单
      • 服务器推单模式-推单接口
        • 话费推单
        • 权益推单
        • 直播币/游戏币推单
        • 一手卡密推单
        • 电影票推单
        • 流量推单
      • 服务器推单模式-查单接口
        • 查单(话费、权益、直播币)
        • 电影票查单
        • 一手卡密查单
      • 上报订单
        • 上报API查单
          • 查单简介
        • 上报订单分润
          • 分润简介
        • 上报订单结果
    • 卡密卡券-供应文档
      • 提交卡密接口例子
      • 提交卡密
      • 订单查询
      • 修改折扣
      • 取消订单
      • 订单回调
      • 查询卡种各面值折扣
      • 查询卡种列表
      • 查询卡种详情信息
  1. 上报订单

上报订单结果

POST
/userapi/sgd/updateStatus

接口说明#

上报订单充值结果
注意:请先在测试环境调通接口

上报请求参数示例:#

上报凭证类型结构示例#

{
    "app_key": "1135130452",
    "timestamp": "1671090001",
    "sign": "90e750aa39d3121f787b9273bdd18cb5",
    "data" : "{\"user_order_id\":\"24080700000008\",\"status\":9,\"rsp_info\":\"做单成功\",\"voucher\":\"data:image\/png;base64,iVBORw0KGgoAAAANSUhEUgAABgAAAATMCAYAAABBW0yNAAAABHNCSVQICAgIfAhkiAAAIABJREFUeJzs3Xl4VPXZ\/\/HPLNkm+0LCFoKEVYUg4sIiVKlYK2p\/WrG1LrSVWlq1FaptqdanFf392kd8WpeqLVZtqfaxtlWB9gHFp6IE\"}"
}

上报带extend_info参数的成功示例#

{
    "app_key": "1135130452",
    "timestamp": "1671090001",
    "sign": "90e750aa39d3121f787b9273bdd18cb5",
    "data" : "{\"user_order_id\":\"24080700000008\",\"status\":9,\"rsp_info\":\"做单成功\",\"extend_info\":{\"card_no\":\"11223344\",\"card_pwd\":\"aabbcc\",\"url\":\"http:\\/\\/www.baidu.com\"}}"
}

上报带分润信息profit_share_info参数成功请求示例#

{
    "app_key": "1135130452",
    "timestamp": "1671090001",
    "sign": "90e750aa39d3121f787b9273bdd18cb5",
    "data" : "{\"user_order_id\":\"24080700000008\",\"status\":9,\"rsp_info\":\"做单成功\",\"profit_share_info\":{\"profit_share_u_id\":\"11223344\",\"profit_share_money\":\"0.2\"}}"
}

上报带卡密信息ys_cards参数成功请求示例#

{
    "app_key": "649756020",
    "sign": "c776ca15fef11fa187ac954daa1dfb8d",
    "data": "{\"user_order_id\":\"24112600000604\",\"rsp_info\":\"做单成功\",\"status\":9,\"ys_cards\":[{\"card_type\":1,\"card_no\":\"241126CARDAAAAA\",\"card_pwd\":\"AAAA-BBBB-DDDD-KKKL\"}]}",
    "timestamp": 1732612226
}

请求参数

Body 参数application/json
app_key
string 
必需
【公共参数】系统分配给用户的秘钥
timestamp
string 
必需
【公共参数】Unix时间戳
sign
string 
【公共参数】签名
必需
data
object 
上报订单参数
必需
格式为序列号后的 json字符串
user_order_id
string 
用户订单ID
必需
rsp_info
string 
备注信息
可选
status
enum<string> 
订单状态
必需
只允许上报成功和失败两种状态,API取单模式下订单不会超时失败,所以上报7时,必须上报查单信息,由系统自动查询确认订单最终状态
枚举值:
789
voucher
string 
voucher
可选
如果上报凭证图片,请上报Base64图片
extend_info
string 
extend_info
可选
详情请文档说明
profit_share_info
object 
可选
order_query_info
string 
话费第三方查单信息
可选
详细信息参考查单简介
ys_cards
array [object {3}] 
必需
示例
{
    "app_key": "",
    "timestamp": "",
    "sign": "97125fe05f95a64b909a8a9dad0b3591",
       "data": "{\"user_order_id\":\"25061900000274\",\"rsp_info\":\"做单成功\",\"status\":9,\"ys_cards\":[{\"card_type\":2,\"card_pwd\":\"AAAA-BBBB-DDDD-KKKL\"}],[{\"card_type\":2,\"card_pwd\":\"AAAA-BBBB-DDDD-KKK8\"}]}"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://test.shop.center.mf178.cn/userapi/sgd/updateStatus' \
--header 'Content-Type: application/json' \
--data-raw '{
    "app_key": "",
    "timestamp": "",
    "sign": "97125fe05f95a64b909a8a9dad0b3591",
       "data": "{\"user_order_id\":\"25061900000274\",\"rsp_info\":\"做单成功\",\"status\":9,\"ys_cards\":[{\"card_type\":2,\"card_pwd\":\"AAAA-BBBB-DDDD-KKKL\"}],[{\"card_type\":2,\"card_pwd\":\"AAAA-BBBB-DDDD-KKK8\"}]}"
}'

返回响应

⚪0成功
application/json
Body
code
string 
必需
返回状态码;详细信息参考概述
message
string 
返回信息
必需
data
array [object {7}]  | null 
返回数据
必需
user_order_id
string 
用户订单ID
必需
create_time
string 
订单创建时间
必需
status
string 
订单状态
必需
status_name
string 
订单状态说明
必需
rsp_info
string 
上报信息
必需
rsp_time
string 
上报时间
必需
username
string 
获取订单账号名称
必需
示例
{
    "code": 0,
    "message": "success",
    "stime": 1680055314.060426,
    "etime": 1680055315.960003,
    "data" {
        "status": 8,
        "rsp_info": "做单失败",
        "rsp_time": 1720609867,
        "user_order_id": 24071000000137,
        "status_name": "充值失败",
        "username": "17716792068",
        "create_time": 1720604961
     }
}
⚪0失败
修改于 2025-06-19 09:18:46
上一页
查单简介
下一页
通过用户订单ID查询
Built with