支付宝实名认证申请单申请

沙箱环境

https://sandbox.yeepay.com/yop-center

POST

/rest/v1.0/mer/alipayauth/apply

mer

支付宝实名认证申请单申请

请求参数

Header 参数

x-yop-sdk-version

string

可选

默认值:

4.0.0

Body 参数application/json

实名认证入参

merchantNo

string

必需

商户编号

<= 64 字符

requestNo

string

必需

请求号

<= 128 字符

channelId

string

可选

渠道号

<= 64 字符

reportFee

string

可选

报备费率：

ALIPUTONG：支付宝普通

<= 32 字符

示例值:

ALIPUTONG

contactInfo

object (mer.IdentityAuthContactInfo)

联系人信息

必需

contactType

string

必需

联系人类型：

LEGAL 法人/经营人

SUPER 其他经办人

<= 32 字符

示例值:

LEGAL

contactPhone

string

必需

联系人手机号

1、用于接收支付宝支付的重要管理信息及日常操作验证码。

2、填写11位数字的手机号码。

<= 32 字符

contactName

string

可选

联系人名称

1、若联系人类型为“法人/经营人”，则该姓名需与法人姓名一致。
2、若联系人类型为“其他经办人”，必传，需填写实际经办人的姓名；

<= 128 字符

contactIdCard

string

可选

联系人证件号码

1、若联系人类型为“其他经办人”，必传，需填写实际经办人的身份证号码。
2、可传身份证、来往内地通行证、来往大陆通行证、护照等证件号码，可参考联系人证件类型。
3、联系人签约时，校验支付宝绑定的银行卡实名信息，是否与该证件号码一致。

<= 64 字符

contactIdentificationType

string

可选

联系人证件类型（如果联系人类型是其他经办人的话，必填）

IDENTIFICATION_TYPE_IDCARD：身份证

IDENTIFICATION_TYPE_OVERSEA_PASSPORT：护照 IDENTIFICATION_TYPE_HONGKONG_PASSPORT：来往内地通行证（中国香港居民） IDENTIFICATION_TYPE_MACAO_PASSPORT：来往内地通行证（中国澳门居民） IDENTIFICATION_TYPE_TAIWAN_PASSPORT：来往内地通行证（中国台湾居民） IDENTIFICATION_TYPE_FOREIGN_RESIDENT：外国人居留证 IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT：港澳居民证 IDENTIFICATION_TYPE_TAIWAN_RESIDENT：台湾居民证

<= 64 字符

contactIdentificationFrontCopy

string

可选

联系人证件正面照片：

1、当联系人类型是其他经办人时，请上传联系人证件的正面照片。
2、若证件类型为身份证，请上传人像面照片。

<= 256 字符

contactIdentificationBackCopy

string

可选

联系人证件反面照片：

1、当联系人类型是其他经办人时，请上传联系人证件的反面照片。
2、若证件类型为护照，无需上传反面照片。

<= 256 字符

contactIdentificationStartTime

string

可选

联系人证件开始时间

格式：yyyy-MM-dd

如果联系人类型是其他经办人的话，必填

<= 32 字符

contactIdentificationEndTime

string

可选

联系人证件结束时间

格式：yyyy-MM-dd 如果是长期的话，请填写 forever

如果联系人类型是其他经办人的话，必填

<= 32 字符

businessAuthorizationLetter

string

可选

业务授权函

1、如果联系人类型是其他经办人的话，必填

2、请参照[示例图]打印授权函，全部信息需打印，不支持手写商户信息，并加盖公章。

<= 256 字符

subjectInfo

object (mer.IdentityAuthSubjectInfo)

主体信息

必需

licenceNumber

string

可选

证件编号

未上传时：系统默认自动取商户信息上送支付宝

<= 64 字符

certCopy

string

可选

证书照片

未上传时：系统默认自动取商户信息上送支付宝

<= 256 字符

companyProveCopy

string

可选

单位证明函照片

事业单位必填

<= 256 字符

companyAddress

string

必需

证件注册地址

<= 1024 字符

licenceValidStartDate

string

必需

证件有效期开始时间

格式：yyyy-MM-dd

<= 32 字符

licenceValidEndDate

string

必需

证件有效期结束时间

格式：yyyy-MM-dd 如果是长期，请填写 forever

<= 32 字符

isFinanceInstitution

boolean

可选

是否金融机构

true false

默认为false

financeInstitutionInfo

object (mer.IdentityAuthFinanceInstitutionInfo)

金融机构信息

可选

specialOperationInfos

object (mer.IdentityAuthSpecialOperationInfo)

经营许可证信息

可选

identificationInfo

object (mer.IdentityAuthIdentificationInfo)

法人身份信息

必需

identificationType

string

可选

法人证件类型

IDENTIFICATION_TYPE_IDCARD：身份证

<= 64 字符

示例值:

IDENTIFICATION_TYPE_IDCARD

identificationName

string

可选

法人证件姓名

未上传时：系统默认自动取商户信息上送支付宝

<= 128 字符

identificationNumber

string

可选

法人证件号码

未上传时：系统默认自动取商户信息上送支付宝

<= 32 字符

identificationStartTime

string

必需

法人证件开始时间

格式：yyyy-MM-dd

<= 32 字符

identificationEndTime

string

必需

法人证件结束时间

格式：yyyy-MM-dd 如果是长期，请填写 forever

<= 32 字符

identificationFrontCopy

string

可选

法人正面照片

未上传时：系统默认自动取商户信息上送支付宝

<= 256 字符

identificationBackCopy

string

可选

法人反面照片

未上传时：系统默认自动取商户信息上送支付宝

<= 256 字符

identificationAddress

string

证件居住地址

可选

证件居住地址

商户主体类型为企业时必填

<= 1024 字符

owner

boolean

可选

经营者/法人是否为受益人

true false

不传默认为false

uboInfoList

array[object (mer.IdentityAuthUboInfo) {8}]

受益人信息

可选

企业类型并且法人非受益人时，必填

uboIdDocType

string

必需

受益人证件类型

IDENTIFICATION_TYPE_IDCARD：身份证

<= 64 字符

示例值:

IDENTIFICATION_TYPE_IDCARD

uboIdDocName

string

必需

受益人姓名

受益人的姓名，传实际受益人姓名

<= 128 字符

uboIdDocNumber

string

必需

受益人证件号码

受益人的证件编号，传实际受益人证件编号

<= 256 字符

uboIdDocCopy

string

必需

受益人证件正面照片

1、请上传受益人证件的正面照片。
2、若证件类型为身份证，请上传人像面照片。
3、可上传1张图片。

<= 256 字符

uboIdDocCopyBack

string

可选

受益人证件反面照片

1、请上传受益人证件的反面照片。
2、若证件类型为护照，无需上传反面照片。
3、可上传1张图片。

<= 256 字符

uboIdDocAddress

string

必需

受益人证件居住地址

1、请按照证件上住址填写，若证件上无住址则按照实际住址填写，如广东省深圳市南山区xx路xx号xx室。

<= 1024 字符

uboPeriodBeginTime

string

必需

受益人证件有效开始日期

格式：yyyy-MM-dd

<= 32 字符

uboPeriodEndTime

string

必需

受益人证件有效结束日期

格式：yyyy-MM-dd 如果是长期，请填写 forever

<= 32 字符

assistProveInfo

object (mer.IdentityAuthAssistProveInfo)

小微辅助材料信息

可选

microBizType

string

必需

MICRO_TYPE_STORE：门店场所 MICRO_TYPE_MOBILE：流动经营/便民服务

<= 32 字符

storeName

string

必需

门店名称

<= 128 字符

provinceCode

string

必需

门店省行政区号

详细参见地区码：支付宝地区码

<= 32 字符

cityCode

string

必需

门店城市区号

详细参见地区码：支付宝地区码

<= 32 字符

disitrictCode

string

必需

门店街道区号

详细参见地区码：支付宝地区码

<= 32 字符

storeAddress

string

必需

门店地址

1、门店场所：填写店铺详细地址，具体区/县及街道门牌号或大厦楼层。

2、流动经营/便民服务：填写“无"。

<= 1024 字符

storeHeaderCopy

string

必需

门店门头照片

填写规范：
门店场所：提交门店门口照片，要求招牌清晰可见
流动经营/便民服务：提交经营/服务现场照片

<= 256 字符

storeIndoorCopy

string

必需

店内环境照片

填写规范：

门店场所：提交店内环境照片
流动经营/便民服务：可提交另一张经营/服务现场照片

<= 256 字符

示例

{
  "merchantNo": "string",
  "requestNo": "string",
  "channelId": "string",
  "reportFee": "ALIPUTONG",
  "contactInfo": {
    "contactType": "LEGAL",
    "contactPhone": "string",
    "contactName": "string",
    "contactIdCard": "string",
    "contactIdentificationType": "string",
    "contactIdentificationFrontCopy": "string",
    "contactIdentificationBackCopy": "string",
    "contactIdentificationStartTime": "string",
    "contactIdentificationEndTime": "string",
    "businessAuthorizationLetter": "string"
  },
  "subjectInfo": {
    "licenceNumber": "string",
    "certCopy": "string",
    "companyProveCopy": "string",
    "companyAddress": "string",
    "licenceValidStartDate": "string",
    "licenceValidEndDate": "string",
    "isFinanceInstitution": true,
    "financeInstitutionInfo": {
      "financeType": "string",
      "financeLicensePics": [
        "string"
      ]
    },
    "specialOperationInfos": {
      "categoryId": "string",
      "operationCopyList": [
        "string"
      ]
    }
  },
  "identificationInfo": {
    "identificationType": "IDENTIFICATION_TYPE_IDCARD",
    "identificationName": "string",
    "identificationNumber": "string",
    "identificationStartTime": "string",
    "identificationEndTime": "string",
    "identificationFrontCopy": "string",
    "identificationBackCopy": "string",
    "identificationAddress": "string",
    "owner": true
  },
  "uboInfoList": [
    {
      "uboIdDocType": "IDENTIFICATION_TYPE_IDCARD",
      "uboIdDocName": "string",
      "uboIdDocNumber": "string",
      "uboIdDocCopy": "string",
      "uboIdDocCopyBack": "string",
      "uboIdDocAddress": "string",
      "uboPeriodBeginTime": "string",
      "uboPeriodEndTime": "string"
    }
  ],
  "assistProveInfo": {
    "microBizType": "string",
    "storeName": "string",
    "provinceCode": "string",
    "cityCode": "string",
    "disitrictCode": "string",
    "storeAddress": "string",
    "storeHeaderCopy": "string",
    "storeIndoorCopy": "string"
  }
}

返回响应

🟢200成功

application/json

Body

result

object (mer.IdentityAuthApplymentRespDto)

实名认证申请结果

可选

returnCode

string

必需

BMS00000 为成功

其他均为失败

<= 64 字符

示例值:

BMS00000

returnMsg

string

可选

applymentId

string

必需

申请单编号

<= 32 字符

requestNo

string

必需

请求号

<= 128 字符

示例

{
  "result": {
    "returnCode": "BMS00000",
    "returnMsg": "string",
    "applymentId": "string",
    "requestNo": "string"
  }
}

🔴500服务器错误

撤销支付宝实名认证

绑卡支付-支付下单