QueryBidUserCertifiedInfo

更新时间:
复制 MD 格式

Call the QueryBidUserCertifiedInfo operation to query the identity verification information of a channel partner's customer.

Description

When you call the QueryBidUserCertifiedInfo operation, the AccessKeyId in the common request parameters must be the key ID of the channel partner's root account.

Request parameters

Name Type Required Example Description
Action String Yes QueryBidUserCertifiedInfo A required parameter. Set the value to QueryBidUserCertifiedInfo.
PK String Yes 123******567 The numeric ID of an Alibaba Cloud account that has passed identity verification
bidType String Yes LIGHTWEIGHT The type of the channel partner. Valid values:
  • NORMAL: A BID service channel partner.
  • LIGHTWEIGHT: A lightweight channel partner.

Return values

Name Type Example Description
aliyunPk String 175*******787 The UID of the channel partner's customer account that is verified.
isCertified String 1 Indicates whether the account is verified.
  • 0: The account is not verified.
  • 1: The account is verified.
phone String 158******** The phone number.
accountCertType String enterprise The type of the verified entity.
  • personal: An individual.
  • enterprise indicates an enterprise.
name String John Doe The name of the verified entity.
certType String 0 The encoding of the certificate type. Example: 0.
certNumber String 340321******** The certificate number.
Table 1. Certificate types
Name Description Encoding (return value)
ID ID card "0"
BUSINESS Business license "9"
ORGANIZATION_CODE Organization code certificate "12"
INSTITUTION_LEGAL_PERSON Public institution legal person certificate "13"

Request example

https://crm-cn-hangzhou.aliyuncs.com/?Action=QueryBidUserCertifiedInfo
&PK=123******567
&<Common request parameters>
			

Response examples

Example 1: Unverified customer

{
"requestId": "90B72FBF-D299-4D17-B84C-9954B45AFE65",
"result": "{\"aliyunPk\":\"175*******787\",\"isCertified\":\"0\"}"
}            

Example 2: Verified customer

{
"requestId": "53AA9A73-BD88-43C1-8AB5-390A875F6976",
"result": "{\"aliyunPk\":\"175*******787\",\"isCertified\":\"1\",\"certNumber\":\"fffffff\",\"phone\":\"9999\",\"certType\":\"0\",\"name\":\"xxxxxxxx\",\"accountCertType\":\"enterprise\"}"
}            

Error codes

HTTP Code Error code Error message Description
400 Empty PK The input parameter 'PK' mandatory for processing this request is not supplied. The PK parameter is required.
403 Not Bid The interface can not be called by a non-bid account. The caller is not a reseller.
403 Bid Mismatch Pk is not belong to the Bid. The specified account does not belong to this channel partner. This means the Alibaba Cloud account specified by PK was not created by this channel partner.
404 Invalid PK The specified parameter 'PK' does not exist in our records. The account that corresponds to the specified PK does not exist.