企迈云-开放平台

API 2.0

API 2.0 > 7.7 会员交易 > 7.7.4 会员充值接口

7.7.4 会员充值接口

开启令牌和权限后可调用。签名方式请查看开发指南

会员充值接口支持按规则充值和手动充值（自动兼容规则充值）

餐饮

请求地址

请求方式	版本信息	请求地址
POST	V2	http://openapi.zvcms.com/api/v2

公共参数

参数	参数类型	是否必填	默认值	描述
OpenId	string	是		密钥Id
GrantCode	string	是		授权code
Token	string	是		签名，参考《数字签名sign》
Timestamp	string	是		当前时间戳
Nonce	string	是		随机正整数
Action	string	是	communal.user.recharge	接口方法
Params	array	是		业务参数

请求参数

参数	参数类型	是否必填	描述
user_id	string	是	用户id
password	string	是	商家充值密码(MD5加密)
amount	int	否	充值金额（entity为0时，必传，代表手动充值，entity和amount都存在时，默认根据entity充值）
entity	string	否	储值规则id（amount为0时，必传，代表选择储值规则充值）
balance	string	否	赠送金额
multi_store_id	string	否	门店id
bizId	string	是	业务id，唯一，储值退款需要用到
mobile	string	是	商家充值密码绑定的手机号
pay_type	int	否	支付方式 0-其他，4-现金，5-微信，6-支付宝
multi_mark	string	否	门店编码

响应参数

参数	参数类型	描述
status	bool	成功或失败标识
code	int	成功失败状态
data	array
├recharge_order_no	string	数据集

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "communal.user.recharge",
    "Params": {
        "user_id": "",
        "password": "",
        "amount": "",
        "entity": "",
        "balance": "",
        "multi_store_id": "",
        "bizId": "",
        "mobile": "",
        "pay_type": "",
        "multi_mark": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "recharge_order_no": "储值退款需要用到"
    }
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}