You can update the wallet address and token details for any recipient associated with your project. 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 AuthenticationCopied!

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 guide for help generating the correct signature.

Common IssuesCopied!

• 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 AuthenticationCopied!

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.