主题
甬易账户查询
接口描述
客户在医疗终端输入身份证信息，商户系统负责按数据规格将客户信息发往甬易支付平台，甬易平台返回相应的客户在甬易端的信息。
请求URL
/his/customer/query
请求方式
- POST
公共请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| appId | 是 | string | 应用ID | app123 | |
| signature | 是 | string | 签名 | xxx | |
| transNonce | 是 | string | 32 | 请求流水号 | req20260415004 |
| transDate | 是 | string | 请求时间，13位时间戳 | 1731406784607 |
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| custFlag | 是 | string | 1 | 客户输入凭证：0-身份证 1-甬易支付登陆用户名 | 0 |
| customerId | 是 | string | 32 | 身份证号码或甬易支付登陆用户名 | 431223200301231256 |
| customerName | 是 | string | 128 | 客户姓名 | 杨过 |
| customerPwd | 否 | string | 50 | 医疗密码，密码为通过密码随机数加密的6位数字 | TPe/2ULX2oDJwLQoBYCQpw== |
| mcryptKey | 否 | string | 32 | 32位密码随机数 | g61kjqi0hmrx6c0ggyo0q3x4zkdjoi7z |
请求报文示例
json
{
"appId": "app123",
"signature": "xxx",
"transNonce": "req20260415004",
"transDate": "1731406784607",
"custFlag": "0",
"customerId": "431223200301231256",
"customerName": "杨过",
"customerPwd": "TPe/2ULX2oDJwLQoBYCQpw==",
"mcryptKey": "g61kjqi0hmrx6c0ggyo0q3x4zkdjoi7z"
}公共响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码：000000000-成功，非000000000-失败，具体原因取message | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | xxx | |
| transNonce | 是 | string | 32 | 请求流水号(同入参) | req20260415001 |
| transDate | 是 | string | 响应时间，13位时间戳 | 1731406784607 |
响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| custPhoneNo | 否 | string | 11 | 客户在甬易登录的手机号 | 18209172356 |
| balance | 是 | decimal(18,0) | 18 | 甬易账户余额，单位：分 | 5500000 |
| avlBalance | 是 | decimal(18,0) | 18 | 可用余额，单位：分 | 100 |
响应示例
json
{
"code": "00000000",
"message": "成功",
"signature": "xxx",
"transNonce": "req20260415001",
"transDate": "1731406784607",
"custPhoneNo": "18209172356",
"balance": 5500000,
"avlBalance": 100
}备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述