---
title: "Update Referral Payout Method"
method: PUT
path: "/users/me/referral-payout-method"
tags: ["General APIs with JWT"]
---

# Update Referral Payout Method

`PUT /users/me/referral-payout-method`

Update the user's preferred referral payout method (balance, USD via Stripe Connect, or crypto)

## Request body

- ReferralPayoutMethodUpdateDto
  - `referral_payout_method` 'balance' | 'usd' | 'crypto', required
  - `wallet_id` string, uuid, nullable

## Response `200`

Successful Response

- UserResponseDto — The user account in the shape a client may see. Endpoints that hand a User row back go through this DTO, so the bcrypt hash never leaves the server. The signup forensics — ``ip_address``, ``signup_attribution``, ``referred_by_miner_id`` — stay out for the same reason: no client reads them.
  - `id` string, uuid, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, nullable, required
  - `name` string, required
  - `email` string, nullable, required
  - `stripe_customer_id` string, nullable, required
  - `stripe_connect_account_id` string, nullable, required
  - `stripe_onboarding_completed` boolean, nullable, required
  - `referral_payout_method` 'balance' | 'usd' | 'crypto', required
  - `referral_payout_wallet_id` string, uuid, nullable, required
  - `balance` number, nullable, required
  - `pending_referral_balance` number, nullable, required
  - `email_verified` boolean, nullable, required
  - `avatar_url` string, nullable, required
  - `company_name` string, nullable, required
  - `discord_id` string, nullable, required
  - `disable_incoming_connections` boolean, required
  - `deleted_at` string, date-time, nullable, required
  - `validator_hotkey` string, nullable, required
  - `archive_hints` string[], nullable, required
  - `admin` boolean, nullable, required
  - `internal_member` boolean, nullable, required
  - `referral_code` string, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/lium/apis/lium-backend-api.md) · [All operations](https://skmtc.dev/lium/apis/lium-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lium/lium-backend-api/revisions/57db0a9348db/schema)