更新个人签署账号信息

更新时间:2025-05-28 16:55:57

接口描述

通过此接口可以更新个人姓名信息。

开发者在对接过程中,需注意:

只有该账号所属的平台方(账号对应的应用ID)才有权限更改账户信息,用户证件类型(idNoType)和身份证号(idNo)不允许修改,如果证件信息错误只能注销签署账号重新创建。

接口名称

AccountService.updateAccount(UpdatePersonParam person)

请求参数

展开全部参数参数名称

类型

必选

参数说明

person(点击“+”展开详情)

UpdatePersonParam

更新的个人信息详情

accountId

String

待更新的个人账号ID

name

String

姓名

encrypt

boolean

用户信息是否加密传输,默认 false

  • true - 加密
  • false - 不加密

identityAuthId

String

个人认证流程ID(通过 【个人核身认证服务】 任意一种方式完成认证后的flowId

注:

  • 做个人认证确认变更后的信息没有问题后,需要在这里传入认证流程id绑定SDK签署账号,并确保当前传入的更新姓名、账号中的证件号与认证流程ID中的信息一致
  • 认证流程使用时间限制在30分钟内,可以跟《个人用户PDF文件签署》接口共用一个认证流程ID
  • Jar包在3.0.17及以上版本并使用新版发放数字证书逻辑时必传(需联系e签宝技术人员开启配置)
  • 该字段的认证方式暂不支持纯API版本发起的支付宝刷脸、小程序刷脸和智能视频认证

realnameEvidencePointId

String

实名证据点ID(通过《创建个人实名证据点》接口获取)

注:

  • 当不使用e签宝实名认证,需要将证据点上传到e签宝后,才能创建e签宝签署账号
  • 需确保证据点内的姓名和证件号和当前账号信息保持一致
  • 需联系e签宝技术人员开启后才可使用

响应参数

展开全部参数参数名称

类型

必选

参数说明

result(点击“+”展开详情)

Result

响应结果类


errCode

int

错误码,0标识成功,其他均标识失败

msg

String

错误信息,错误码对应的说明信息

errorShow

boolean

错误信息是否建议显示

请求示例  

public static void main(String[] args) {
    // 获取客户端的代码:
    ServiceClient getKHD = ServiceClientManager.get("您的pojectId");

    AccountService service = getKHD.accountService();

    Result resultupdateAccount = service.updateAccount(updatePerson());
    if (resultupdateAccount.getErrCode() != 0)
        System.out.println("更新个人账号失败:" + resultupdateAccount.getMsg());
    else
        System.out.println("更新个人账号成功" + JSONObject.fromObject(resultupdateAccount));
}

/**
* 更新个人签署账号信息
*/
public static UpdatePersonParam updatePerson() {
    UpdatePersonParam person = new UpdatePersonParam();
    person.setAccountId("EFB2ECB52F23425F111A11BD57701D60");//账号ID
    person.setName("李四");// 姓名
    person.setIdentityAuthId("3838184766290004923");//个人认证流程ID(通过【个人核身认证服务】任意一种方式完成认证后的flowId)
    return person;

}

响应示例

{
    "msg": "成功",
    "errCode": 0,
    "errShow": false
}


我要纠错