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

# Tokens

> List supported tokens and block/unblock tokens for your merchant.

## Overview

Use the Tokens resource to list what your merchant can accept and to block/unblock specific tokens.

## Authentication

Merchant token management uses merchant auth (API key or bearer JWT).

## Request

### List supported tokens

```ts theme={null}
const tokens = await pepay.tokens.listMerchantSupported({ environment: 'mainnet' });
```

### Search tokens (large catalogs)

```ts theme={null}
const tokens = await pepay.tokens.searchMerchantTokens({
  environment: 'mainnet',
  search: 'usdc',
  network: 'base',
  token_type: 'erc20',
  limit: 50,
  offset: 0
});
```

### Block or unblock a token

```ts theme={null}
await pepay.tokens.blockOrUnblock(123, { blocked: true });
```

## Response

Example list response (truncated):

```json theme={null}
{
  "acceptance_policy": "selective",
  "environment": "mainnet",
  "tokens": [
    {
      "id": 123,
      "token_symbol": "USDC",
      "network": "base",
      "network_environment": "mainnet",
      "photo_uri": "https://assets.coingecko.com/coins/images/6319/small/USD_Coin_icon.png",
      "is_blocked": false
    }
  ]
}
```

## Errors

* `401` missing/invalid auth
* `400` invalid token id or request body (block/unblock)

## Examples

* Keep token acceptance stable by managing a short allowlist and explicitly blocking unsupported tokens.

Next: [Access](/sdk/merchants/access)