Settlement Currencies
Settlement currencies list every currency currently enabled for settlement or payment conversion. Fields shown match the /currencies endpoint. Use the Code column when you build payment requests, quotes, and when you interpret settlement and reporting responses.
This table applies to:
Payments created through the Payments APIs
Settlement records in the Settlement APIs
Reporting endpoints that expose currency codes and amounts
Currency table
USD
US Dollar
fiat
ethereum
2
✓
BTC
Bitcoin (Lightning)
crypto
bitcoin_Lightning
8
✓
USDC
USDC Ethereum
crypto
usdC_Ethereum
6
✓
USDC_NPL
USDC Polygon
crypto
usdC_Polygon
6
✓
ETH
Ethereum
crypto
ethereum
18
✓
BTC
Bitcoin (on-chain)
crypto
bitcoin
8
✓
CIT_USD_ALI
Alipay USD
walletApps
alipay
2
✓
CIT_USD_PPAL
PayPal USD
walletApps
paypal
2
✓
CUS_USD_VENMO
Venmo USD
walletApps
venmo
2
✓
CUS_USD_WECHAT
WeChat Pay USD
walletApps
weChatPay
2
✓
USD_KLARNA
Klarna USD
walletApps
klarna
2
✓
Column definitions
Code Identifier for the currency. Uses ISO 4217 for fiat or a platform specific symbol for crypto and wallet apps. This value appears in payment requests, settlement records, and reporting responses.
Name Human readable name for the currency and where relevant the network or platform. For example, USDC Ethereum or Bitcoin Lightning.
Currency type
High level category for the currency. Values include fiat, crypto, and walletApps. This indicates whether the currency represents traditional money, a digital asset, or a wallet application balance.
Tender type
Value used in tenderTypes arrays when limiting payment methods or interpreting how a payment will be routed. For crypto and wallet entries this typically maps to a specific network, Lightning configuration, or QR platform identifier.
Decimals Number of minor unit decimal places the platform accepts and returns for this currency. For example, USD has 2 decimals and Ethereum has 18.
Enabled Indicates whether the currency is currently live for both Sandbox and Production. Currencies marked with a check mark are fully enabled. If a currency is not enabled it may be present in schemas but blocked for use.
Notes
All crypto rows map to testnets in Sandbox environments. Production uses mainnet equivalents for the same codes.
New currencies follow the same schema and will appear in this table when they are enabled. If you see a currency code in an API response that is not listed here, contact the Bead team before relying on it in production.
Last updated