Skip to main content

​
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

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

​
Search tokens (large catalogs)

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

​
Block or unblock a token

await pepay.tokens.blockOrUnblock(123, { blocked: true });

​
Response

Example list response (truncated): 
{
  "acceptance_policy": "selective",
  "environment": "mainnet",
  "tokens": [
    {
      "id": 123,
      "token_symbol": "USDC",
      "network": "base",
      "network_environment": "mainnet",
      "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