输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心

实名信息预验证

更新时间: 2026-08-29 09:41
本文导读
展开章节

功能介绍

开发者可以调用该接口发起实名信息预验证，获取预验证ID（preVerifyId）。

场景描述

在接入实名信息验证服务前，开发者需要调用该接口获取到preVerifyId，然后返回给客户端调用验证接口拉起华为支付实名信息验证页面。

接口原型

  • 承载协议： HTTPS POST

  • 接口方向： 开发者服务器 -> 华为支付服务器

  • 接口URL： https://petalpay-developer.cloud.huawei.com.cn/api/v1/realname/verification/preverify

  • 数据格式：

    请求消息：Content-Type: application/json; charset=UTF-8

    响应消息：Content-Type: application/json; charset=UTF-8

请求参数

Request Header

展开
参数 是否必选 参数类型 描述
Content-Type 是 String 取值为：application/json; charset=UTF-8
PayDevAuth 是 String 取值为：PayDevAuth的JSON字符串

Request Body

展开
参数 是否必选 类型 说明
credentialType 是 String

证件类型。

01：身份证
credentialIdNo 是 String 经过sha512做哈希处理后的证件编号。最大长度为128。
realName 是 String 经过sha512做哈希处理后的用户姓名。最大长度为128。
openId 是 String

用户对外展示的ID（获取方式请参见获取用户信息）。长度范围为1-512。

说明： 入参中的实名信息，必须和 openId用户下的实名信息保持一致。

请求示例

收起
自动换行
深色代码主题
复制
  1. POST /api/v1/realname/verification/preverify HTTP/1.1
  2. Content-Type: application/json;charset=UTF-8
  3. PayDevAuth: {"clientId":"10132120***","accessToken":"DQEBALZh0tlSKKiNDJ9lYYg0Du0EB3E6PvcGlFsyB*******************XR+k2EX8ry1IGdDUZG1PjfcWQ94xnK7w3ag==","traceId":"202305151026422776499","time":1684117602555, "developerSignKeyId":"76e5ee072756417a829201fa********************f9a292d23ca949202c3dac548120", "petalpaySignKeyId":"DEVELOPER_SIGN_EB48251AC36***", "headerSign":"u+H3F14Oe3fS34d32S9mGCES89XA7tSjp8+********************lOGS7eADFfw2E45WJu52vY5Ku4KGcSCnSeE6DiKs=", "bodySign":"y3DFDtDLXDBqDoItDgHmFJ343H57LKH6U5G7F/*******************asPj10iDUIFeHaszDFHpiHRT23LGHaxvHJKta6J5UxIUmApL+wGdV/juGEvQ="}
  4. Accept: application/json
  5. {
  6.   "credentialType": "01",
  7.   "credentialIdNo": "a27aad63294be3fbb164e3d3d4634956cc6dc7427860*******************87798851b9fcd0f828ba78cfd99bf3d64bfa83815659e989f50d537",
  8.   "realName": "a24374f8658456db7a20cb73001f28f886c31232097bda8*******************ecbb12eb7db7edb57c507ebefdea4ab66f8f2f6acc835355fbef7299c5c48806a",
  9.   "openId": "88e9eae22447d7a138357cbf0af2d9a3a84819ec18419631c*******************2b9cc4e33ad29e2048318b47ec98be41cecdd4e153e6216a6bd60851"
  10. }

响应参数

Response Header

展开
参数 是否必选 参数类型 描述
Content-Type 是 String 取值为：application/json; charset=UTF-8

Response Body

展开
参数 是否必选 参数类型 描述
resultCode 是 String 返回码，“000000”表示成功，其他表示异常，请参见错误码。
resultDesc 是 String 结果描述。
subCode 否 String 业务错误码。
subDesc 否 String 业务错误描述信息。
sign 是 String 签名值。用于开发者对响应报文进行防篡改验证。
preVerifyId 是 String 预验证ID。

响应示例

收起
自动换行
深色代码主题
复制
  1. HTTP/1.1 200 OK
  2. Content-Type: application/json; charset=UTF-8
  3. {
  4.   "resultCode": "000000",
  5.   "resultDesc": "Success.",
  6.   "sign": "MEQCIEIWzdpziRyTi8vhwWHFu********************0YAMabeCgTDG77e+2XJItvq/ZkIcCN5/B20pQ==",
  7.   "preVerifyId": "12407091401520894056950***"
  8. }

错误码

resultCode非400000的错误码请查看公共错误码说明。

展开
返回码 错误码 错误描述 解决方案
400000 UNKNOW_ERROR 服务暂不可用，请稍后重试 稍后重试。
400000 INVALID_ARGUMENTS 参数不合法 检查请求参数。
400000 CLIENT_ID_PARAM_ERROR CLIENT_ID错误 检查请求头参数clientId参数是否正确。
400000 INVALID_OPENID OPEN_ID错误 检查请求入参openId是否正确。
400000 DAILY_LIMIT_EXCEEDED 调用服务超过当日最大限制，请明天重试或联系开发者 第二天再重试。
400000 ID_TYPE_NOT_SUPPORT 证件类型不支持 检查请求入参是否正确，符合相关枚举定义类型。
400000 RARE_CHARACTERS_NOT_SUPPORTED 不支持生僻字 检查请求参数。
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
请输入您想要搜索的关键词