自然人已使用额度查询接口

功能概述

本接口用于商户查询自然人已使用额度。

接口地址

https://webox-api.5upay.com/webox/wallet/queryUserQuota

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一 id，可在商户后台查看 M
requestId 订单号 varchar(50) 提交的订单号必须在账户交易中唯一；首信易数据支付系统中对于已创建的订单，商户端不能重复提交。 M
name 姓名 varchar(32) 自然人姓名（当不传自然人 ID 时，此项必传） C
idCardNo 身份证号 varchar(18) 自然人身份证号（当不传自然人 ID时，此项必传） C
userId 自然人 ID varchar(19) 自然人 ID，商户可通过钱包 id 在商户后台-微包-账户管理-账户信息处查到具体记录，通过最右侧操作按钮点击查看，即可查到自然人 ID。（当不传自然人姓名、身份证号时，此项必传） C
hmac 参数签名 varchar(500) 商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 M

参数示例

{ "hmac": "j9dIfu/5xhbT7CMcJpW3X21yHLOA+xpJC9svIfUXfxCOzhokEKy+sDoASXC5AlV0nZaC+xJx FOyGkvq9mlDh0nxSaXaI4G9q2QMhD5HytUSvprjbjgX2QRmHAqZ6aP/R7GZEnFi+UUui1l21 2No4wRSbidVN5uyRx/h9aaefxT+1OmvQRF4q8zn74Xoj9xCu2Vhlj/ES9LPqBW6iItf++IfclVzQ FgGNo3b7Gk8Vw5zY7+8BK8TJsdJoh2w1gGaQ9qizsZA/7Wr7VQ7Q6JkDp34MWQ+jrelbr8F MuEpl5dz9RQHILEpIZLfs3bBxlmzH1HeBatJWSWZMwDZxwL/NNw==", "idCardNo": "210*******", "merchantId": "890000593", "name": "王**", "requestId": "2022391646816026900", "userId": "1352162287103909888" }

同步返回参数列表

参数名称 参数中文名称 参数说明
status 响应状态 SUCCESS 响应正常
FAIL 响应异常
merchantId 商户编号 同请求参数
idCardNo 身份证号 同请求参数
name 姓名 同请求参数
userId 自然人 ID 同请求参数
userAmount 已用额度 该自然人已经使用的额度，单位：分
hmac 参数签名 商户生成的参数签名结果，获取hmac的方法请参考请求加密流程

参数示例

{ "merchantId": "890000593", "hmac": "cbSZmj2U3CqDtYTg+XSRnpNPLfwbQFPYua7EVTxSrKCKsooa7c9rB2dvvbaRufGiMLf JiTQ9SibP+m3X9dVmjpkW3ilutfO0l5LNkW8WGSeJi/pIRluhLRvC/jFUqigAoBuSpQLWEn M3FYUx+iOvwQG3r8zFR9crOZj9BgZKt0XidcTIIGFo+7GaX8VmP8H2cPjpzyb3FrCPw5X X+6B+CdR140S+4KUPM7pCICKfq5coebt9O14oRxPmE8yjMjU+WnNGdzfnO9xIK7I4qM 64X5xz91usPUpfilMvusOoP1kQ4YxZ9c/r9CNlkrNf/NiGC0r7ykerFslqDq7N/NFooQ==", "idCardNo": "210******", "name": "王**", "userAmount": 0, "userId": "1352162287103909888", "status": "SUCCESS" }