---
title: "Set wallet for customer fees"
method: PUT
path: "/platform/v1/fees/customer-fee-wallets"
tags: ["Wallets"]
---

# Set wallet for customer fees

`PUT /platform/v1/fees/customer-fee-wallets`

## Request

- Base URL: `https://api.sandbox.bvnk.com`
- URL: `https://api.sandbox.bvnk.com/platform/v1/fees/customer-fee-wallets`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/docs/platform/v1/fees/customer-fee-wallets/put.ts> (a function with typed inputs; its response is checked against the schema)

Sets up the customer fee wallet for a specific currency. The customer fee wallet is where the collected customer fees will be credited when processing transactions. For more information, refer to [Customer fees](https://docs.bvnk.com/bvnk/get-started/charge-customer-fees).

## Request body

- object
  - `currency` string, required: The three-letter currency code of the wallet in the ISO 4217 format.
  - `destinationWalletId` string, required: The `lsid` of the wallet where customer fees will be credited.

## Response `200`

Successfully retrieved customer fee wallets

- object
  - `content` object[]: The customer fee wallets now configured, one per currency.
    - `currency` string: The three-letter currency code of the wallet in the ISO 4217 format.
    - `destinationWalletId` string: The ID of the wallet where customer fees for the specified currency will be credited.

## Other responses

- `403`: Forbidden - Authorization token not found
- `404`: Not Found - Wallet not found
- `422`: Unprocessable Entity - Invalid input parameters

## Changes

- **2026-11-06** `c386d436bf2c`: 1 warning, 1 info
  - removed the optional property `customerFeeWallets` from the response with the `200` status
  - added the optional property `content` to the response with the `200` status

[Operation history](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/changes/platform/v1/fees/customer-fee-wallets/put.md)

---

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