# Updating Recipient Details

This is useful in cases where the settlement destination changes - such as when a vendor switches wallets or chooses to receive payouts on a different chain.

Example: *A marketplace user changes their preferred payout token from USDC on Base to ETH on mainnet.*

#### API Authentication <a href="#api-authentication" id="api-authentication"></a>

To update an recipient's settlement details via the API, you must authenticate your request using your **client ID** and **secret**. Specifically:

* Sign requests with the `x-signature` header derived from your client secret.
* Include your `x-client-id` in the headers.

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

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

* **Missing or invalid signature**: All API requests must be signed using your generated signature.
* **Invalid blockchain or token values**: Ensure the `toChain` and `toToken` correspond to supported networks and contract addresses.
* **Incorrect** `toAddress`: Make sure this wallet is valid and can receive the specified token on the chosen chain.

#### API Authentication <a href="#api-authentication" id="api-authentication"></a>

Updating settlement details is helpful when:

* A vendor updates their wallet for security reasons.
* A payout recipient wants to switch to a faster or cheaper chain.
* You need to correct setup mistakes from initial onboarding.


---

# 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/updating-recipient-details.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.