主题
支付宝开户认证申请
接口描述
- 开户认证申请。
请求URL
/alipay/merchant/authApply
请求方式
- POST
公共请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| appId | 是 | string | appId | 202415629590370906 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 43e2c287-24b1-4cd1-b3d2-e40e7840cc40 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| alipaySubMchId | 否 | string | 32 | 支付宝商户号 | - |
| source | 否 | string | 32 | 此字段填写单个服务商pid信息 | |
| outBizNo | 是 | string | 32 | 外部业务号 | |
| contactPersonInfo | 是 | string | 32 | 联系人信息(JSON字符串密文) | |
| authIdentityInfo | 是 | string | 32 | 主体信息(JSON字符串) | |
| financialOrgInfo | 否 | string | 32 | 金融机构信息(JSON字符串)，当主体为金融机构时，必填 | |
| certificateInfo | 否 | string | 32 | 证件信息(JSON字符串密文) ，主体类型为企业/个体户/政府机关/事业单位/社会组织时，必填 | |
| supportCredentials | 否 | string | 32 | 辅助证明材料信息(JSON字符串)，主体类型为小微商户时，辅助证明材料信息必填 | |
| qualificationInfoList | 否 | string | 32 | 特殊行业经营许可证(JSON数组字符串) | |
| legalPersonInfo | 是 | string | 32 | 法人身份信息(JSON字符串密文) | - |
| benefitPersonInfo | 否 | string | 32 | 受益人信息(JSON字符串密文),如下情况时必填：主体类型为企业，且其法人/经营者不为最终受益所有人 | - |
联系人信息（contactPersonInfo）
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| contactName | string(64) | 必填 | 联系人姓名 |
| contactPhoneNo | string(32) | 必填 | 联系人手机 |
| contactCardNo | string(64) | 必填 | 联系人身份证件号 |
| contactCertType | string(32) | 选填 | 联系人证件类型，居民身份证: RESIDENT，港澳居民(往来大陆通行证): PASSPORT_HK_MO，台湾居民(往来大陆通行证): PASSPORT_TWN，护照: PASSPORT，港澳居民居住证: RESIDENCE_PERMIT_HM，台湾居民居住证: RESIDENCE_PERMIT_TW，外国人永久居住证: PERMANENT_RESIDENCE_FOREIGNER |
主体信息（authIdentityInfo）
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| identityType | string(20) | 必填 | 主体类型，企业: ENTERPRISE，个体工商户: IND_BIZ，事业单位: INST，党政机关: GOV，社会组织: ORG，小微商户: MSE |
| isFinancialOrg | boolean(10) | 选填 | 是否金融机构 |
| certificateType | string(50) | 选填 | 证照类型，营业执照: BUSINESS_CERT，登记证书: REGISTER_CERT |
| employerLetterImg | string(50) | 选填 | 单位证明函照片（使用图片上传接口）主体类型为政府机关/事业单位时，单位证明函照片必填 |
金融机构信息（financialOrgInfo）
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| financialOrgType | string(64) | 条件 | 金融机构类型，银行业(BANK)、支付机构(PAYMENT)、保险业(INSURANCE)、交易及结算类金融机构(SETTLE)、OTHER(OTHER) |
| financialOrgCertImg | string | 条件 | 金融机构许可证图片 |
证件信息（certificateInfo）
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| certType | string(50) | 条件 | 登记证书类型，统一社会信用代码证书: UNIT_SOCIAL_CREDIT，慈善组织公开募捐资格证书: CHARITY_ORG_SOLICIT，社会团体法人登记证书: SOCIAL_ORG_LEGAL，民办非企业单位登记证书: CIVIL_UN_ENT，基金会法人登记证书: FOUNDATION_LEGAL_PERSON，农民专业合作社法人营业执照: FARMERS_COOPERATE，宗教活动场所登记证: RELIGION_PLACES，其他证书/批文/证明: OTHER_REG_CERT |
| certNo | string(50) | 条件 | 证件编号 |
| certImage | string(256) | 条件 | 证照图片 |
| merchantName | string(256) | 条件 | 证照商户名称 |
| legalPersonName | string(128) | 条件 | 法人姓名 |
| registerAddress | string(512) | 条件 | 注册地址 |
| effectTime | string(10) | 条件 | 证照生效时间 yyyy-mm-dd |
| expireTime | string(10) | 条件 | 证照过期时间 yyyy-mm-dd |
| employerLetterImg | string(256) | 选填 | 单位证明函照片 |
辅助证明材料（supportCredentials）
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| merchantType | string(50) | 必填 | 小微商户经营类型，门店场所: STORE，流动经营: STALL |
| storeName | string(64) | 必填 | 门店名称 |
| provinceCode | string(32) | 必填 | 门店省行政区号 |
| cityCode | string(32) | 必填 | 门店市行政区号 |
| districtCode | string(32) | 必填 | 门店街道区号 |
| storeDoorImg | string(256) | 必填 | 门店门头照信息 |
| storeInnerImg | string(256) | 必填 | 门店店内照片 |
| storeAddress | string(512) | 条件 | 门店详细地址 |
经营许可证（qualificationInfoList）
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| mccCode | string(32) | 必填 | 行业类目编号 |
| imageList | string | 必填 | 行业经营许可证资质照片 |
法人身份信息（legalPersonInfo）
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| cardType | string(50) | 必填 | 证件类型，中国大陆居民-身份证(RESIDENT)、其他国家或地区居民-护照(PASSPORT)、中国港澳居民-来往内地通行证(PASSPORT_HK_MO)、中国台湾居民-来往大陆通行证(PASSPORT_TWN)、港澳居民居住证（RESIDENCE_PERMIT_HM）、台湾居民居住证（RESIDENCE_PERMIT_TW）、外国人永久居住证（PERMANENT_RESIDENCE_FOREIGNER）。个体户/企业/事业单位/社会组织：可选择任一证件类型，政府机关、小微商户仅支持身份证类型。 |
| personName | string(64) | 必填 | 法人姓名 |
| cardNo | string(64) | 必填 | 证件号码 |
| effectTime | string(32) | 必填 | 证件生效时间 2000-11-01 |
| expireTime | string(32) | 必填 | 证件过期时间 2000-11-01，长期有效时传“forever |
| cardFrontImg | string(256) | 必填 | 证件正面照 |
| legalType | string(50) | 选填 | 证件持有人类型 |
| cardBackImg | string(256) | 选填 | 证件反面照 |
| authLetterImg | string(64) | 选填 | 授权函照片 |
| isBenefitPerson | boolean(10) | 选填 | 是否为受益人 |
受益人信息（benefitPersonInfo）
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| personName | string(64) | 必填 | 受益人姓名 |
| cardNo | string(64) | 必填 | 证件号码 |
| cardType | string(50) | 必填 | 证件类型，中国大陆居民-身份证(RESIDENT)、其他国家或地区居民-护照(PASSPORT)、中国港澳居民-来往内地通行证(PASSPORT_HK_MO)、中国台湾居民-来往大陆通行证(PASSPORT_TWN)、港澳居民居住证（RESIDENCE_PERMIT_HM）、台湾居民居住证（RESIDENCE_PERMIT_TW）、外国人永久居住证（PERMANENT_RESIDENCE_FOREIGNER）。个体户/企业/事业单位/社会组织：可选择任一证件类型，政府机关、小微商户仅支持身份证类型。 |
| effectTime | string(32) | 必填 | 证件生效时间 2000-11-01 |
| expireTime | string(32) | 必填 | 证件过期时间 2000-11-01，长期有效时传“forever |
| cardFrontImg | string(256) | 必填 | 证件正面照 |
| cardBackImg | string(256) | 选填 | 证件反面照 |
公共响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| orderNo | 是 | string | 支付宝申请单编号 | ||
| orderStatus | 是 | string | 意愿申请单状态，审核中(AUDITING)、待联系人确认（CONTACT_CONFIRM），待法人确认（LEGAL_CONFIRM）、审核通过(AUDIT_PASS)、审核驳回(AUDIT_REJECT)、已冻结(AUDIT_FREEZE)、已撤回(CANCELED)、联系人处理中(CONTACT_PROCESSING) | ||
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号(同入参) | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
响应示例
json
{
"code": "00000000",
"message": "成功",
"applymentId": "adadasdasdas",
"transDate": "1731469621597",
"transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40",
"signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g=="
}备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述