Requesting a Real-Name Authentication Change

Function

This API can be used to submit a real-name authentication change application.

For details about how to change an individual account to an enterprise account through real-name authentication, visit Changing an Individual Account to an Enterprise Account.

Constraints

This API can be invoked only by the partner account AK/SK or token.
To use this API, partners need to enable Upload Photos of Handheld ID Cards Required for Real-Name Authentication on the Benefits and Support > API Configuration > Configure page.
Images for real-name authentication must be uploaded to the download directory of the bucket.
Real-name authentication change through API only supports changing an individual account to an enterprise account.

Debugging

You can debug the API in API Explorer which supports automatic authentication. API Explorer can automatically generate and debug example SDK code.

URI

PUT /v2/customers/realname-auths/enterprise

Request

Request Parameters

Parameter	Mandatory	Type	Value Range	Description
customer_id	Yes	String	A maximum of 64 characters	Customer account ID. You can call the API in Querying Customers to obtain the customer ID.
identify_type	Yes	Integer	-	Authentication method. 1: Using the enterprise's certificate scanned copy
verified_file_url	Yes	List<String>	A maximum of 4 characters	URL of the certificate attachment file used for enterprise certificate authentication. The attachment URL must be entered in sequence. Enter the name of the attachment of the enterprise certificate first. If the enterprise personal information exists, enter the name of the ID card attachment of the enterprise personal information. The order of the enterprise certificate attachments is as follows: First: Picture of the front side of the enterprise certificate Second: Picture of the back side of the enterprise certificate The order of the individual certificate attachments is as follows: First: Picture of the front side of the personal ID card (profile side) Second: Picture of the back side of the personal ID card (national emblem side) If the enterprise does not have a legal entity, and its first attachment is the picture of the front side of the enterprise certificate abc.023, and the second attachment is the back side of the enterprise certificate def004, then upload the attachments in the following sequence: abc023 def004 Enter the URL in the preceding sequence. The file name is case sensitive. Currently, certificate attachments can only be in .jpg, .jpeg, .bmp, .png, .gif, or .pdf format. The maximum size of a single file is 10 MB. The URL is a relative URL and does not need to contain the bucket name or download directory. It only needs to contain the subdirectory and corresponding file name in the download directory. Example: If the uploaded attachments are stored in the following location of the bucket, enter abc023.jpg: https://bucketname.obs.Endpoint.myhuaweicloud.com/download/abc023.jpg If the uploaded attachments are stored in the following location of the bucket, enter test/abc023.jpg: https://bucketname.obs.Endpoint.myhuaweicloud.com/download/test/abc023.jpg
corp_name	Yes	String	A maximum of 255 characters	Organization name. The value cannot contain only digits, special characters, or spaces.
verified_number	Yes	String	A maximum of 32 characters	Enterprise certificate number.
change_type	Yes	Integer	[1]	Change type. 1: Change individual real-name authentication to enterprise real-name authentication.
xaccount_type	Yes	String	A maximum of 64 characters	Platform ID assigned by Huawei to a partner. This value is assigned by Huawei. For details about how to obtain the platform ID, see How Do I Obtain the xaccountType Value?
certificate_type	No	Integer	-	Enterprise certificate type. 0: Enterprise's business license 1: Legal entity certificate 2: Legal entity registration certificate 3: Administrative law enforcement subject certificate 4: Organization code certificate 99: Others If this parameter is not included in the request parameters or is set to null, no value is returned.
reg_country	No	String	A maximum of 10 characters	Registration country entered for real-name authentication. Enter the two-letter code that stands for the country. For example, enter CN for China. If this parameter is not included in the request parameters or is set to null, no value is returned. If this parameter is set to "", "" is returned.
reg_address	No	String	A maximum of 256 characters	Enterprise registration address for real-name authentication. If this parameter is not included in the request parameters or is set to null, no value is returned. If this parameter is set to "", "" is returned.
enterprise_person	No	EnterprisePerson Object	-	Enterprise person information. For details, see Table 1. This parameter is reserved.

**Table 1** EnterprisePerson
Parameter	Mandatory	Type	Value Range	Description
legel_name	Yes	String	A maximum of 255 characters	Legal entity name.
legel_id_number	Yes	String	A maximum of 32 characters	Legal entity card ID.
certifier_role	No	String	A maximum of 32 characters	Legal entity role. legalPerson: Legal representative

Example Request

PUT  https://bss-intl.myhuaweicloud.com/v2/customers/realname-auths/enterprise HTTP/1.1
Content-Type: application/json
X-Auth-Token: MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
    "verified_number": "371812********8888",
    "verified_file_url": [
        "gerenshiming/zhengmian001.jpg",
        "gerenshiming/fanmian002.jpg",
        "gerenshiming/chizheng003.jpg"
    ],
    "reg_address": "Beijing"
    "reg_country": "CN",
    "customer_id": "4505ce********de8263e33b57e76abc",
    "certificate_type": 0,
    "corp_name": "test001",
    "enterprise_person": {
        "certifier_role": "legalPerson",
        "legel_name": "wangmoumou",
        "legel_id_number": "371812********8888"
    },
    "identify_type": 1,
    "xaccount_type": "***_IDP",
    "change_type":1
}

Response

Response Parameters

Status code: 200

Parameter	Type	Value Range	Description
is_review	Integer	-	Whether to transfer to manual review. This parameter is returned only when the status code is 200. 0: No 1: Yes

Parameter

Type

Value Range

Description

is_review

Integer

Whether to transfer to manual review. This parameter is returned only when the status code is 200.

0: No
1: Yes

Status code: 400

Parameter	Type	Value Range	Description
error_code	String	A maximum of 16 characters	Error code. For details, see Returned Values. This parameter is returned only when a failure occurs.
error_msg	String	A maximum of 1024 characters	Error description. This parameter is returned only when a failure occurs.
is_review	Integer	-	Whether to transfer to manual review. This parameter is returned only when the status code is 200. 0: No 1: Yes
fail_check_items	List<String>	-	Error list. This parameter is displayed only when error code CBC.99007004 is returned. For details, see Table 2.

**Table 2** failCheckItems list
Item	Description
IS_DEBT	The customer's account is in arrears.
IS_CREDIT_ACCOUNT	The customer has a credit account and has a credit outstanding amount.
IS_ORG_ACCOUNT	The customer account is an enterprise master account or member account.
MEM_OF_ORG	Your account and the associated master account belong to the same legal entity. Please cancel the association before performing real-name authentication.
MEN_ANSWERING_ORG	You have received an invitation to associate with another account as a member account. Please reject the invitation and then perform real-name authentication.
ORG_INVITING_MEM	Your account is a master account and has invited another member account for association. Please cancel the invitation and then perform real-name authentication.
ORG_HAVE_MEM_EQUITY_APPLYING	Your account is a master account. The equity certificate is being reviewed. Please wait for the certificate to be approved, and then perform real-name authentication.
MEM_OF_ORG_EQUITY_APPLYING	Your account is a member account. The equity certificate of the associated master account is being reviewed. Please wait for the certificate to be approved, and then perform real-name authentication.
ORG_HAVE_MEM_EQUITY_APPROVED	Your account is a master account and already has an equity certificate. Please cancel the member account that as the equity certificate and then perform real-name authentication.
MEM_OF_ORG_EQUITY_APPROVED	Your account is a member account and already has an equity certificate. Please cancel the association with the master account and then perform real-name authentication.

Example Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time  
{
  "is_review": "1"
}

Returned Values

4xx: This class of HTTP status code is intended for situations in which the error seems to have been caused by the client, for example, the request contains bad syntax or incorrect parameters. You must ensure the request is correct.
5xx: This class of HTTP status code is intended for cases in which the Huawei Cloud server is aware that it has encountered an error or is otherwise incapable of performing the request. In this case, contact Huawei Cloud customer service.

HTTP Value	Error Code	Description
400	CBC.0100	Parameter error.
400	CBC.99000035	You are not a customer of a partner yet.
400	CBC.99000099	The certificate attachment the customer submitted for real-name authentication exceeded the maximum size allowed.
400	CBC.99000100	Incorrect format of the certificate attachment the customer submitted for real-name authentication.
400	CBC.99007004	The initiated service operation does not meet the service check item requirement.
400	CBC.99007188	The customer has passed real-name authentication or is being reviewed.
400	CBC.99007191	The number of real-name authentication times of the customer exceeds the upper limit.
400	CBC.70600026	Huawei Cloud cannot review the information you submitted for real-name authentication. Contact your account manager.
403	CBC.0151	Access denied.
500	CBC.0999	Unknown error occurred.