上报订单结果
POST
/userapi/sgd/updateStatus
接口说明
请求参数
| 参数名称 | 参数类型 | 是否必须 | 参数描述 |
|---|---|---|---|
| user_order_id | int | 是 | 用户订单ID |
响应报文
| 参数名称 | 参数类型 | 是否必须 | 参数描述 |
|---|---|---|---|
| code | int | 是 | 状态码，0表示请求接口成功，非0代表请求接口异常 |
| message | string | 是 | 返回文本信息 |
| data | array | 是 | 具体返回内容数据包 |
data数据
| 参数名称 | 参数类型 | 是否必须 | 参数描述 |
|---|---|---|---|
| status | int | 是 | 处理状态， 1充值中，2充值成功，3充值失败，4订单不存在 |
| rsp_info | string | 否 | 处理结果信息 |
| rsp_time | int | 否 | 处理时间戳，当有处理结果时必须返回(单位:秒) |
| ys_cards | array | 是 | 扩展参数内容，详情请看下方 |
一手卡密订单 ys_cards item 数据结构
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| card_type | number | 是 | 卡类型、1:普通类型,返回卡号卡密、2:兑换码,返回卡密、3:链接类型，返回卡链接、4:二维码 返回二维码地址 |
| card_no | string | 是 | 卡号 ，卡类型普通类型该字段必填 |
| card_pwd | string | 是 | 卡密，卡类型 2,3,5 时候，该字段必填 卡密、卡链接、二维码地址统一使用此字段 |
data请求参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_order_id | string | 是 | 用户订单ID |
| rsp_info | string | 否 | 备注信息 |
| status | int | 是 | 订单状态，只允许上报成功和失败两种状态（8充值失败，9充值成功） |
| voucher | string | 否 | 凭证图片；如果上报凭证图片，请上报Base64图片 |
| extend_info | array | 否 | 扩展参数内容，详情请看下方 |
| profit_share_info | array | 否 | 分润信息参数，具体信息请看子菜单 上报分润 |
| order_query_info | string | 否 | 话费第三方查单信息，具体信息请看子菜单 上报API查单 |
| ys_cards | array | 否 | 一手卡面卡密信息、一手卡密业务该字段必传 是二位数组 具体信息请看子菜单 上报API查单 |
上报请求参数示例：
上报凭证类型结构示例
{
"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\",\"profit_share_remark\":\"5566778899\"}}"
}
上报带卡密信息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 参数multipart/form-data
请求示例代码
返回响应
修改于 2026-01-16 07:19:44