甬易支付文档中心

主题

余额支付 ​

接口描述 ​

接入方能通过此接口使用患者账户余额完成消费付款，具备小额免密功能。

请求URL ​

  • /his/account/balance/pay

请求方式 ​

  • POST

公共请求参数 ​

参数名必选类型最大长度说明示例
appId是string应用IDapp123
signature是string签名xxx
transNonce是string32请求流水号req20260415003
transDate是string请求时间，13位时间戳1731406784607

请求参数 ​

参数名必选类型最大长度说明示例
custFlag是string客户输入凭证：0-身份证；1-甬易支付登陆用户名0
customerId是string凭证信息（身份证号码或甬易支付登陆用户名），AES加密encrypted_xxx
pwdFlag是string免密标识：0-需要密码；1-不需要密码（默认0）0
customerPwd否string医疗密码，小额免密不传pwd123
mcryptKey否string密码随机数，小额免密不传key123
outTradeNo是string消费订单号ORD20260415001
costAmount是string消费金额，单位分10000
transIP是string交易IP192.168.1.1

请求报文示例 ​

json
{
  "appId": "app123",
  "signature": "xxx",
  "transNonce": "req20260415003",
  "transDate": "1731406784607",
  "custFlag": "0",
  "customerId": "encrypted_xxx",
  "pwdFlag": "0",
  "customerPwd": "pwd123",
  "mcryptKey": "key123",
  "outTradeNo": "ORD20260415001",
  "costAmount": "10000",
  "transIP": "192.168.1.1"
}

公共响应参数 ​

参数名必选类型最大长度说明示例
code是string响应编码00000000
message是string响应信息成功
signature是string签名xxx
transNonce是string32请求流水号(同入参)req20260415001
transDate是string响应时间，13位时间戳1731406784607

响应参数 ​

参数名必选类型最大长度说明示例
balance是string甬易余额，单位分60000
avlBalance是string甬易可用余额，单位分60000
tradeNo是string甬易订单流水号TRAN20260415001

响应示例 ​

json
{
  "code": "00000000",
  "message": "成功",
  "signature": "xxx",
  "transNonce": "req20260415001",
  "transDate": "1731406784607",
  "balance": "60000",
  "avlBalance": "60000",
  "tradeNo": "TRAN20260415001"
}

备注 ​