PUT
/
payout
/
methods
/
wallets
/
{payout_method_id}
Update wallet payout method
curl --request PUT \
  --url https://api-staging.stablestack.xyz/api/payout/methods/wallets/{payout_method_id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "type": "WALLET",
  "customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e",
  "label": "updated usdc wallet",
  "wallet_address": "0x9iu41923E23DcE32d1A346e96558dA89f89DD1aB",
  "network": "erc20",
  "currency": "USDT"
}'
{
  "status": "success",
  "data": {
    "id": "46a75b50-4bdc-4f59-b891-602dc247effe",
    "type": "WALLET",
    "currency": "USDT",
    "label": "updated usdc wallet",
    "wallet_address": "0x9iu41923E23DcE32d1A346e96558dA89f89DD1aB",
    "network": "erc20",
    "created_at": "2025-05-12T15:50:31.679Z",
    "updated_at": "2025-05-20T10:15:45.123Z",
    "customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e"
  },
  "message": "Wallet updated successfully"
}
Updates an existing wallet payout method (either merchant-owned or customer-specific).

​
Key Features:

  • Supports partial updates - only include fields that need to be modified
  • Include customer_id only when updating customer-specific wallets
  • Returns the complete updated wallet object

​
Request Parameters:

  • payout_method_id (path, required): The ID of the wallet to update

​
Request Body:

{
  "customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e", // optional
  "label": "updated usdc wallet", // optional
  "wallet_address": "0x9iu41923E23DcE32d1A346e96558dA89f89DD1aB",
  "network": "erc20",
  "currency": "USDT"
}

Headers

​
x-api-key
string
required

Path Parameters

​
payout_method_id
string<uuid>
required

ID of the wallet to update

Body

application/json

Response

200
application/json

Wallet updated successfully

The response is of type object.