---
title: "Set Withdrawal Fee Bearer"
method: PUT
path: "/users/withdrawal-fee-bearer"
tags: ["Account"]
---

# Set Withdrawal Fee Bearer

`PUT /users/withdrawal-fee-bearer`

## Request

- Base URL: `https://api.breet.io/v1`
- URL: `https://api.breet.io/v1/users/withdrawal-fee-bearer`
- Auth: API key in header `x-app-id` and API key in header `x-app-secret` and API key in header `X-Breet-Env`
- TypeScript: <https://skmtc.dev/breet/apis/breet-public-api/docs/users/withdrawal-fee-bearer/put.ts> (a function with typed inputs; its response is checked against the schema)

Choose who absorbs the fee on every withdrawal: bank (NGN | GHS), stablecoin, UTXO, and auto-settlement payouts. On crypto withdrawals the fee is the network fee. With `user`, the fee is deducted from the payout and the recipient gets `amount - fee`. With `business`, the fee is added to the amount debited from your balance and the recipient gets the full `amount`. Defaults to `user`.

## Request body

- object
  - `withdrawalFeeBearer` 'user' | 'business', required: Who absorbs the withdrawal fee. `user` deducts it from the payout; `business` adds it to the amount debited from your balance.

## Response `200`

Withdrawal fee bearer set successfully

## Other responses

- `401`: Integration is inactive or API access is not enabled
- `422`: Request validation failed — check the errors array for field-level details
- `500`: An unexpected server error occurred

## Changes

- **2026-11-03** `41450811e16e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/breet/apis/breet-public-api/changes/users/withdrawal-fee-bearer/put.md)

---

[API](https://skmtc.dev/breet/apis/breet-public-api.md) - [All operations](https://skmtc.dev/breet/apis/breet-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/breet/apis/breet-public-api/revisions/a2559b3ef61f?raw)