APapiqik
IdentityService

POST /v1/me/identity/verification

SubmitVerification 校验实名信息与授权，并按选定的支付宝 OpenAPI v3 方式初始化核身单据。

Request

Request body

agreementAcceptedboolean

是否已单独同意实名认证服务协议与个人信息处理授权。

agreementVersionstring

协议版本，留空时服务端使用当前默认版本。

documentNostring

证件号码；新客户端应使用此字段，idCardNo 仅保留旧客户端兼容。

documentTypestring

证件类型；当前支持 IDENTITY_CARD / RESIDENCE_HK_MC / RESIDENCE_TAIWAN。

idCardNostring

旧客户端身份证号字段；仅在 documentType=IDENTITY_CARD 时兼容读取。

realNamestring

与所选证件一致的真实姓名，2-30 个字符。

returnUrlstring

认证完成后的前端回跳地址；服务端只允许配置基准 URL 的同源地址。

verifyMethodstring

支付宝核身方式：alipay_certify_qr / alipay_id_two_meta；留空使用默认方式。

Response

OK

Changes

No recorded changes to this operation across all 11 revisions of this API.