虚拟充值接口

API 文档

接口定义

当用户下单之后,橙券积分平台会向该接口发起虚拟商品的充值请求,开发者需在收到充值请求后处理该订单,对用户订单进行充值处理。

请求参数(POST/GET请求方式传参)

参数名 类型 是否必须 示例值 描述
uid string 4839203890302 用户唯一性标识,对应唯一一个用户且不可变
app_key string 18888888888 接口app_key,会员账号
timestamp long 1557037740232 时间戳,13位毫秒数
sign string app_key=x&app_secret=
x&timestamp=
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
    }
}

results matching ""

    No results matching ""