Skip to main content

​
Overview

Use this method to list tokens the payor can use for the current invoice/session context.

​
Authentication

Requires x-session-token + x-signature.

​
Request

​
List available tokens (payor/session)

const tokens = await pepay.paymentSessions.listAvailableTokens({ mode: 'checkout', network: 'base' });

​
Response

Example response (truncated): 
[
  {
    "id": 123,
    "token_symbol": "USDC",
    "token_name": "USD Coin",
    "token_type": "erc20",
    "network": "base",
    "token_decimals": 6,
    "token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "requires_memo": false
  }
]

​
Underpaid behavior

If the invoice is underpaid, this endpoint returns only the locked token for the original network.

​
Errors

  • 401 invalid session token/signature

​
Examples

  • Use network + mode filters to keep the list aligned to your checkout UI and the invoice’s active network.
Next: Payment status