> For the complete documentation index, see [llms.txt](https://docs.orda.network/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.orda.network/developers/api/recipients/updating-recipient-details.md).

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