虚拟充值接口
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.168.0.1 | 用户 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
}
}