甬易支付文档中心

主题

余额退款 ​

接口描述 ​

客户调用甬易接口进行余额退款。

请求URL ​

  • /his/account/balance/refund

请求方式 ​

  • POST

公共请求参数 ​

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

请求参数 ​

参数名必选类型最大长度说明示例
custFlag是string客户输入凭证：0-身份证；1-甬易支付登陆用户名0
customerId是string凭证信息（身份证号码或甬易支付登陆用户名），AES加密encrypted_xxx
customerPwd是string医疗密码pwd123
mcryptKey是string密码随机数key123
outRefundNo是string退款订单号REFUND20260415001
outTradeNo是string原消费订单号ORD20260415001
refundAmt是string退款金额，单位分5000
transIP是string交易IP192.168.1.1

请求报文示例 ​

json
{
  "appId": "app123",
  "signature": "xxx",
  "transNonce": "req20260415004",
  "transDate": "1731406784607",
  "custFlag": "0",
  "customerId": "encrypted_xxx",
  "customerPwd": "pwd123",
  "mcryptKey": "key123",
  "outRefundNo": "REFUND20260415001",
  "outTradeNo": "ORD20260415001",
  "refundAmt": "5000",
  "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"
}

备注 ​