企迈云-开放平台

API 2.0

API 2.0 > 5.2 会员查询 > 5.2.5 会员余额充值

5.2.5 会员余额充值

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

场景描述：根据企迈云商用户ID，对该会员进行余额充值。

零售

请求地址

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

公共参数

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

请求参数

参数	参数类型	是否必填	描述
user_id	int	是	用户id
amount	float	是	充值金额，单位元
give_amount	float	是	赠送金额，单位元
recharge_type_code	int	是	充值方式 1线上储值卡 2pos直充 3 pos扫描实体储值卡
recharge_card	string	否	实体卡卡号当充值方式为3时卡号必填，请确保唯一
remarks	string	是	备注信息
multi_store_sn	string	是	门店编码
card_key	string	否	实体卡密钥当充值方式为3时实体卡密钥必填
order_no	string	是	订单号，请确保唯一

响应参数

参数	参数类型	描述
status	bool	请求成功或者失败
code	int	成功/错误编码
message	string	成功/错误描述

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "user.amount-charge",
    "Params": {
        "user_id": "",
        "amount": "",
        "give_amount": "",
        "recharge_type_code": "",
        "recharge_card": "",
        "remarks": "",
        "multi_store_sn": "",
        "card_key": "",
        "order_no": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "status": "",
        "code": "50001，代表实体卡之前已绑定过",
        "message": ""
    }
}

异常示例

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

错误码

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