> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payluk.ng/llms.txt
> Use this file to discover all available pages before exploring further.

# Crypto whitelist overview

> Manage the crypto addresses a customer is allowed to deposit from.

For crypto deposits, Payluk only credits funds that arrive from a **whitelisted**
address; deposits from unknown addresses are rejected (and reverted). This group
manages a customer's allowed addresses. All routes need the **`customer-id`**
header, and pair with [Get master wallet address](/api-reference/payments/get-master-wallet-address)
(the destination customers deposit to).

## Endpoints

| Route                                                                                    | Method & path                              | What it does                                                                                                                                                    |
| ---------------------------------------------------------------------------------------- | ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [List whitelisted addresses](/api-reference/crypto-whitelist/list-whitelisted-addresses) | `GET /v1/whitelist-address`                | Returns the customer's whitelisted addresses (`id`, `walletAddress`, `network`, `label`). **`customer-id` required.**                                           |
| [Add whitelisted address](/api-reference/crypto-whitelist/add-whitelisted-address)       | `POST /v1/whitelist-address`               | Whitelists an address. Body: `walletAddress`, `network` (`BSC`), optional `label`. Returns `400` if the whitelist limit is reached. **`customer-id` required.** |
| [Remove whitelisted address](/api-reference/crypto-whitelist/remove-whitelisted-address) | `DELETE /v1/whitelist-address/{addressId}` | Removes a whitelisted address by `addressId`. **`customer-id` required.**                                                                                       |

<Warning>
  A deposit from a non-whitelisted address is **not** credited; it is reverted to
  the sender. Whitelist the address **before** the customer sends funds.
</Warning>