Bead Developers
  • Introduction
  • Quick Start
  • Authentication
  • Payments
    • Create Payment
    • Payment Statuses
    • Payment Webhooks
    • Test Transactions - Crypto
    • Changelog
  • Entity Management
    • Onboarding
    • Merchant Management
      • Get Merchant
      • Changelog
    • Location Management
      • Create Location
      • Get Location
      • List Locations
      • Update Location
      • Delete Location
      • Changelog
    • Terminal Management
      • Terminal Lifecycle (Concepts)
      • Create Terminal
      • Get Terminal
      • List Terminals
      • Update Terminal
      • Delete Terminal
      • Webhook Management
      • Changelog
  • Settlement
    • Batches
    • Settlement Details
  • Reporting
    • Payment History Concepts
      • Pagination and Sorting
    • Partner Payments
    • Merchant Payments
    • Terminal Payments
    • Changelog
  • Reference Guide
    • Core Concepts
      • Environments & Base URLs
      • Authentication
      • Error Codes
    • Enumerations & Schemas
      • Tender Types
        • Crypto
        • Alternative Payments
      • Settlement Currencies
      • Common Field Types
    • Endpoint Index
      • Table View (All APIs)
      • Download OpenAPI / Postman
    • Payment Scenarios
      • Under- and Over-Payment Handling
      • Reclaiming Unconverted Crypto
    • Operational Guides
      • Compatible Crypto Wallets
      • Webhook Event Reference
    • Support & Contacts
      • Integration Support
      • Escalation Contacts
    • Changelog
  • FAQs & Troubleshooting
    • Authentication FAQs
    • Payments FAQs
      • Resolving “403 Forbidden” When Creating Payments
    • Environment & Testing
      • How to Test Klarna Payments
      • How to Prepare for USDC Testing
      • How to Test Klarna Payments
    • Webhooks & Error Codes
Powered by GitBook
On this page
  1. Reference Guide
  2. Enumerations & Schemas

Settlement Currencies

Settlement Currencies

The table lists every currency currently enabled for settlement or payment conversion. Fields shown match the /currencies endpoint; use the Code column when you build payment requests or price quotes.

Code
Name
Currency type
Tender type
Decimals
Enabled

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 – ISO 4217 for fiat or platform-specific symbol for crypto / wallet apps

  • Currency type – fiat, crypto, or walletApps

  • Network / Subtype – blockchain network, Lightning, or QR platform ID

  • Tender type – value used in tenderTypes arrays when limiting payment methods

  • Decimals – number of minor-unit places the platform accepts and returns

  • Enabled – currencies marked ✓ are live in both Sandbox and Production

Notes

  • All crypto rows point to testnets in Sandbox; Production uses mainnet equivalents.

  • New currencies follow the same schema and will appear in this table when enabled.

PreviousAlternative PaymentsNextCommon Field Types

Last updated 10 days ago