甬易支付文档中心

主题

甬易账户创建 ​

接口描述 ​

客户在医疗终端输入身份证信息、手机号码、医疗端密码（经过甬易密码控件加密后）发送到甬易，甬易建立相应的客户账户。实名认证由医院方完成，创建的甬易账户默认通过实名认证，最好有标识能确认该用户是不是医疗用户。

请求URL ​

  • /his/customer/regist

请求方式 ​

  • POST

公共请求参数 ​

参数名必选类型最大长度说明示例
appId是string应用ID，甬易提供，一个固定的值app123
signature是string签名xxx
transNonce是string32请求流水号req20260415001
transDate是string请求时间，13位时间戳1731406784607

请求参数 ​

参数名必选类型最大长度说明示例
custFlag是Integer客户输入凭证：0-身份证0
customerId是string身份证号码或甬易支付登陆用户名330200199001011234
certExpireDate是string身份证到期日，格式yyyyMMdd20300101
customerName是string客户姓名pmhlOwnviIRt/x9K7ZZbUITGm3ddHg==
customerPwd是string医疗密码TPe/2ULX2oDJwLQoBYCQpw==
mcryptKey是string32位密码随机数g61kjqi0hmrx6c0ggyo0q3x4zkdjoi7z
customerPhone是string手机号码cuf974FXHqJ6rjN0LZqAOuox5BOZ7Q/Xilaa

请求报文示例 ​

json
{
  "appId": "app123",
  "signature": "xxx",
  "transNonce": "req20260415001",
  "transDate": "1731406784607",
  "custFlag": 0,
  "customerId": "330200199001011234",
  "certExpireDate": "20300101",
  "customerName": "pmhlOwnviIRt/x9K7ZZbUITGm3ddHg==",
  "customerPwd": "TPe/2ULX2oDJwLQoBYCQpw==",
  "mcryptKey": "g61kjqi0hmrx6c0ggyo0q3x4zkdjoi7z",
  "customerPhone": "cuf974FXHqJ6rjN0LZqAOuox5BOZ7Q/Xilaa"
}

公共响应参数 ​

参数名必选类型最大长度说明示例
code是string响应编码：000000000-成功，非000000000-失败，具体原因取message00000000
message是string响应信息成功
signature是string签名xxx
transNonce是string32请求流水号(同入参)req20260415001
transDate是string响应时间，13位时间戳1731406784607

响应示例 ​

json
{
  "code": "00000000",
  "message": "成功",
  "signature": "xxx",
  "transNonce": "req20260415001",
  "transDate": "1731406784607"
}

备注 ​