Skip to main content

​
Overview

Token endpoints let merchants list supported tokens and (optionally) block specific tokens for their account.

​
Authentication

Merchant auth (API key or bearer JWT).

​
Request

Endpoints:
  • GET /api/v1/merchant/tokens
  • GET /api/v1/merchant/tokens/search
  • POST /api/v1/merchant/tokens/{tokenId}/block
Playground (interactive reference): Example (list tokens): 
BASE_URL=${PEPAY_API_URL}

curl "$BASE_URL/api/v1/merchant/tokens?environment=mainnet" \
  -H "x-api-key: sk_live_..."
Example (search tokens): 
BASE_URL=${PEPAY_API_URL}

curl "$BASE_URL/api/v1/merchant/tokens/search?environment=mainnet&search=usdc&network=base&limit=25" \
  -H "x-api-key: sk_live_..."

​
Response

{
  "acceptance_policy": "selective",
  "environment": "mainnet",
  "tokens": [
    {
      "id": 123,
      "token_symbol": "USDC",
      "token_name": "USD Coin",
      "network": "base",
      "network_environment": "mainnet",
      "is_blocked": false
    }
  ]
}

​
Errors

  • 401/403 missing/invalid auth
  • 400 invalid token id or environment

​
Examples

Example (block a token): 
BASE_URL=${PEPAY_API_URL}

curl -X POST "$BASE_URL/api/v1/merchant/tokens/123/block" \
  -H "x-api-key: sk_live_..."
Next: Invoices