# Deactivating a Recipient

Deactivating a recipients ensures that the recipient no longer receives payouts or processes transactions. This is particularly useful when a recipient is no longer active or needs to be disabled for security or operational reasons.

#### Authentication <a href="#authentication" id="authentication"></a>

To deactivate a recipient, you must authenticate your request using your project’s **client ID** and **secret**. Each request must include:

* An `x-signature` header that is generated using your client secret.
* An `x-client-id` header containing your project’s client ID.

Refer to the [authentication guide](/developers/authentication.md) for detailed instructions on generating the correct signature.

#### Common Issues <a href="#common-issues" id="common-issues"></a>

* **Missing or Invalid Signature:** Ensure that every deactivation request is properly signed with an `x-signature` derived from your client secret.
* **Incorrect Recipient Identification:** Double-check that the recipient you are deactivating is the intended one to prevent accidental deactivation.
* **Mismatched Client ID:** Verify that the `x-client-id` provided in the request corresponds to the correct project.

#### When to use this endpoint <a href="#when-to-use-this-endpoint" id="when-to-use-this-endpoint"></a>

Deactivating a recipient is recommended when:

* An entity (such as a vendor or partner) no longer requires settlement services.
* Security or compliance reasons necessitate revoking a recipient’s ability to process payouts.
* You need to manage recipients’ activity through your administrative controls rather than manual intervention.

For implementation details, including the precise request format, please refer to the [API reference](https://orda.gitbook.io/orda-docs/api-reference/).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.orda.network/developers/api/recipients/deactivating-a-recipient.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.