简要描述
- 充值下单操作为异步请求，报文返回成功，则表示受理成功，具体充值是否成功，则需要我方发起异步通知，或者下游发起查询请求来判断
请求URL
http://ip:port/order/interest
请求方式
- POST
- application/json;charset=UTF-8
请求参数说明
| 参数名 |
必选 |
类型 |
说明 |
| productId |
是 |
Long |
平台商品id |
| requestId |
是 |
string |
流水Id，下游生成，不可重复 |
| number |
是 |
string |
充值号码 |
| checkPrice |
否 |
BigDecimal |
校验价格，单位元，保留四位小数。我方平台提供该商品的代理价格(售价 x 折扣) 。<font color=LightCoral >校验价格与面额必传其一 </font> |
| faceValue |
否 |
Integer |
面额，单位月。<font color=LightCoral >校验价格与面额必传其一 </font> |
| timeOut |
否 |
Integer |
超时时间，单位秒。 |
| callbackUrl |
是 |
String |
回调地址 |
| productOperator |
否 |
int |
产品运营商，枚举值见文档底部 |
| sign |
是 |
String |
签名,MD5(userId+key+productId+ requestId + number) |
请求示例
{
"number":"13966666666",
"productId":10015,
"requestId":"6607378090040",
"checkPrice":"10.0900",
"callbackUrl":"http://127.0.0.1:8080/callback",
"productOperator": 9,
"sign":"6848b1f4a28a67aa203ae1038113ec90"
}
返回参数说明
| 参数名 |
类型 |
说明 |
| code |
Integer |
返回结果码 |
| msg |
String |
返回结果信息 |
| success |
Boolean |
code为200返回true，其他false |
| data |
Map |
数据集合，提单成功返回 |
| data. orderId |
Long |
我方平台订单id，提单成功返回 |
返回示例
{
"code":200,
"msg":"订单提交成功",
"data":{
"orderId":"1407727321389207552"
},
"success":true
}
{
"code":413,
"msg":"订单号重复",
"success":false
}
| 错误码 |
结果 |
注释 |
| 200 |
受理成功 |
<font color=LightCoral >受理成功，但不代理充值成功。充值结果以平台回调结果或通过订单查询接口结果为准</font> |
| 400 |
失败 |
参数有误(失败) |
| 410 |
失败 |
用户不存在(检查请求头是否传了Authorization-User并且是否正确) (失败) |
| 412 |
失败 |
白名单校验失败(失败) |
| 413 |
人工确认 |
<font color=LightCoral >流水号重复(每次请求都要求唯一) (人工确认，如果确实重复提交了，重复的订单也可以当失败处理) </font> |
| 414 |
失败 |
产品不存在(失败) |
| 415 |
失败 |
用户没有配置该产品(请联系平台工作人员进行配置) (失败) |
| 416 |
失败 |
校验价格校验失败，输入价格与实际代理价格不一致(失败) |
| 417 |
失败 |
账户余额不足(失败) |
| 418 |
失败 |
用户没有配置供货商通道(请联系平台工作人员进行配置) (失败) |
| 419 |
失败 |
供货商没有配置产品信息(请联系平台工作人员进行配置) (失败) |
| 422 |
失败 |
验签失败(请检查加签参数与顺序是否正确) (失败) |
| 423 |
失败 |
充值失败,流控不通过 |
| 500 |
人工确认 |
<font color=LightCoral >服务异常(请检查请求方式，参数格式，类型是否正确) (请求格式没问题需人工确认，或者调订单查询接口查看结果，不可当失败处理)</font> |
| 505 |
失败 |
充值失败 |
| 运营商 |
枚举 |
| 京东 |
9 |
| 饿了么 |
10 |
| 美团 |
11 |
| 麦当劳 |
12 |
| 必胜客 |
13 |
| 哔哩哔哩 |
14 |
| QQ音乐 |
15 |
| 肯德基 |
16 |
| 芒果视频 |
17 |
| 滴滴出行 |
18 |
| 猫眼电影 |
19 |
| 网易云 |
20 |
| pp视频 |
21 |
| 腾讯黄钻 |
22 |
| QQ会员 |
23 |
| 瑞幸咖啡 |
24 |
| 搜狐视频黄金会员 |
25 |
| 芒果TV会员 |
26 |
| 优酷 |
27 |
| 腾讯视频 |
28 |
| 酷喵 |
29 |
| 风行视频 |
30 |
| 暴风影音 |
31 |
| 爱奇艺视频 |
32 |
| 搜狐视频 |
33 |
| 迅雷 |
34 |
| 爱奇艺 |
35 |
| 天猫 |
36 |