Help Center > > API Reference> Customer Management> Customer Management> Freezing a Customer Account

Freezing a Customer Account

Updated at: Nov 30, 2021 GMT+08:00

Function

A partner can freeze an account of a customer associated with the partner by reseller model.

Visit Freezing a Customer Account to learn about how to freeze a customer account.

Constraints

This API can be invoked using the partner AK/SK or token only.

URI

POST /v2/partners/sub-customers/freeze

Request

Request Parameters

Parameter

Mandatory

Type

Value Range

Description

customer_ids

Yes

List<String>

A maximum of 10 IDs

IDs of customers whose accounts are to be frozen.

You can call the API in Querying Customers to obtain the customer ID.

reason

Yes

String

A maximum of 256 characters

Account freezing reason.

Example Request

POST https://bss-intl.myhuaweicloud.com/v2/partners/sub-customers/freeze HTTP/1.1
Content-Type: application/json
X-Auth-Token: MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

{
	"customer_ids": [
		"065024********e90f44c01cbccfa280",
		"065faa********ce0fddc007a6cb6f40"
	],
	"reason": "Arrears"
}

Response

Response Parameters

Parameter

Type

Value Range

Description

error_code

String

A maximum of 20 characters

Error code. This field is not returned when the operation is successful or partially failed.

For details, see Returned Values.

error_msg

String

A maximum of 2,000 characters

Error description. This field is not returned when the operation is successful or partially failed.

error_details

List<ErrorDetail>

-

Error cause description. This field is returned only when the operation is partially failed.

For details, see Table 1.

Table 1 ErrorDetail

Parameter

Type

Value Range

Description

error_code

String

A maximum of 20 characters

Error code.

For details, see Returned Values. The returned status code is 200.

error_msg

String

A maximum of 2,000 characters

Error message.

id

String

A maximum of 256 characters

ID. This parameter corresponds to customer_ids.

Example Response

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

Returned Values

HTTP Value

Error Code

Description

400

CBC.0100

Parameter error.

400

CBC.99000000

You do not have the operation permission to this customer.

400

CBC.99005024

This API cannot be invoked because the association type of the customer is incorrect.

403

CBC.0150

Invalid operation.

403

CBC.0151

Access denied.

500

CBC.0999

Other errors.

Did you find this page helpful?

Submit successfully!

Thank you for your feedback. Your feedback helps make our documentation better.

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