Partner CenterPartner Center

Compute
Elastic Cloud Server
Bare Metal Server
Auto Scaling
Image Management Service
Dedicated Host
FunctionGraph
Networking
Virtual Private Cloud
Elastic IP
Elastic Load Balance
NAT Gateway
Direct Connect
Virtual Private Network
Domain Name Service
VPC Endpoint
Cloud Connect
Enterprise Switch
Security & Compliance
Anti-DDoS
Web Application Firewall
Host Security Service
Data Encryption Workshop
Database Security Service
Advanced Anti-DDoS
Data Security Center
Container Guard Service
Situation Awareness
Managed Threat Detection
Compass
Cloud Certificate Manager
Anti-DDoS Service
Databases
Relational Database Service
Document Database Service
Data Admin Service
Data Replication Service
GaussDB NoSQL
GaussDB(for MySQL)
Distributed Database Middleware
GaussDB(for openGauss)
Developer Services
ServiceStage
Distributed Cache Service
Simple Message Notification
Application Performance Management
Application Operations Management
Blockchain Service
API Gateway
Cloud Performance Test Service
Distributed Message Service for Kafka
Distributed Message Service for RabbitMQ
Distributed Message Service for RocketMQ
Cloud Service Engine
DevCloud
ProjectMan
CodeHub
CloudRelease
CloudPipeline
CloudBuild
CloudDeploy
Cloud Communications
Message & SMS
Cloud Ecosystem
Marketplace
Partner Center
User Support
My Account
Billing Center
Cost Center
Resource Center
Enterprise Management
Service Tickets
HUAWEI CLOUD (International) FAQs
ICP License Service
Support Plans
Customer Operation Capabilities
Partner Support Plans
Professional Services
enterprise-collaboration
Meeting
IoT
IoT
Intelligent EdgeFabric
DeveloperTools
SDK Developer Guide
API Request Signing Guide
Terraform
HCloud CLI
Help Center> Partner Center> API Reference> Customer Management> Real-Name Authentication> Requesting an Enterprise Real-Name Authentication
Updated at: Apr 27, 2022 GMT+08:00

Requesting an Enterprise Real-Name Authentication

Function

This API can be used to submit an enterprise real-name authentication application.

An enterprise customer can refer to the instructions described in Overall Process to complete the real-name authentication.

Constraints

  • This API can be invoked only by the partner account's 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.
  • Only enterprise certificate authentication can be performed using APIs.

URI

POST /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

  1. 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 is specified in the request, enter the name of the ID card attachment of the enterprise personal information.

    The sequence 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 sequence of the individual certificate attachments is as follows:

    First: picture of the profile side of the personal ID card

    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 is the back side of the enterprise certificate def004, and then upload the attachments in the following sequence:

    abc023

    def004

    The file name is case sensitive.

  2. Currently, certificate attachments must be in .jpg, .jpeg, .bmp, .png, .gif, or .pdf format. The maximum size of a single file is 10 MB.
  3. 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.

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

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.

reg_address

No

String

A maximum of 256 characters

Enterprise registration address for real-name authentication.

enterprise_person

No

EnterprisePerson Object

-

Enterprise person information. For details, see Table 1.

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

POST  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"
}

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

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.99000000

You do not have the operation permission to the customer.

400

CBC.99000035

You are not a customer of a partner yet.

400

CBC.99005030

The partner does not enable the option of uploading the attachment for real-name authentication.

For details about how to enable the option, click here.

400

CBC.99007004

The initiated service operation does not meet the service check item requirement.

400

CBC.99007202

Real-name authentication failed.

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.99007253

The picture of the ID card is invalid or blurred.

400

CBC.99007256

The legal entity information is incorrect.

400

CBC.99007257

The enterprise information is incorrect.

400

CBC.99007267

The member account is being associated with a master account and cannot perform real-name authentication again.

403

CBC.0151

Access denied.

500

CBC.0999

Unknown error occurred.

Did you find this page helpful?

Failed to submit the feedback. Please try again later.

Which of the following issues have you encountered?







Please complete at least one feedback item.

Content most length 200 character

Content is empty.

OK Cancel