虚拟充值接口
API 文档
接口定义
当用户下单之后,橙券积分平台会向该接口发起虚拟商品的充值请求,开发者需在收到充值请求后处理该订单,对用户订单进行充值处理。
请求参数(POST/GET请求方式传参)
| 参数名 | 类型 | 是否必须 | 示例值 | 描述 |
|---|---|---|---|---|
| uid | string | 是 | 4839203890302 | 用户唯一性标识,对应唯一一个用户且不可变 |
| app_key | string | 是 | 18888888888 | 接口app_key,会员账号 |
| timestamp | long | 是 | 1557037740232 | 时间戳,13位毫秒数 |
| sign | string | 是 | app_key=x&app_secret= x×tamp= x&uid=x |
签名(带上app_secret,值非空的参数名按照 ASCII 码从小到大排序拼接参数名参数值后 MD5 编码) |
| order_no | string | 是 | J100011908271035 | 橙券订单号 |
| identifier | string | 是 | abc | 商品标识,在自定义充值类商品中唯一能够确定该商品规格属性的标识 |
| description | string | 是 | 充值话费25元,消耗10积分,20元 | 本次充值的描述(带中文,请用 UTF-8 进行 URL 解码) |
| user_order_no | string | 否 | J100011908271042 | 开发者返回的订单号 |
| account | string | 否 | 13888888888 | 用户提交的充值账号 |
| ip | string | 否 | 192.x.x.x | 用户 IP |
响应参数
| 参数名 | 类型 | 是否必须 | 示例值 | 描述 |
|---|---|---|---|---|
| code | int | 是 | 200 | 状态码(200为成功,201充值失败,202充值中) |
| message | string | 是 | 请求通过 | 状态码描述 |
| data | json | 是 | { "user_order_no": "13858334320712", "credits": 100 } |
返回数据 |
data说明
| 参数名 | 类型 | 是否必须 | 示例值 | 描述 |
|---|---|---|---|---|
| user_order_no | string | 是 | 13858334320712 | 开发者订单号 |
| credits | int | 是 | 100 | 用户积分余额 |
请按 JSON 格式返回结果。
响应示例
成功:
{
"code": 200,
"message": "充值成功",
"data": {
"user_order_no": "13858334320712",
"credits": 100
}
}
失败:
{
"code": 201,
"message": "充值失败",
"data": {
"user_order_no": "13858334320712",
"credits": 100
}
}
充值中:
{
"code": 202,
"message": "充值中",
"data": {
"user_order_no": "13858334320712",
"credits": 100
}
}