Currency Configuration

Configure which cryptocurrencies your payment application accepts. The currencyWhitelist on your payment application determines what payment methods are available to customers on the checkout page.

Available Cryptocurrencies

The following cryptocurrencies are currently available on this payment gateway instance:

Loading currencies...

How It Works

  1. You set the currencyWhitelist on your payment application
  2. When a customer opens a checkout link, they see only the whitelisted currencies
  3. The customer selects their preferred cryptocurrency
  4. The system generates a payment address for the selected currency
  5. The customer sends the exact amount to the provided address

Checking Available Payment Methods

For a specific payment, you can check which payment methods are available via the public checkout endpoint:

GET /api/checkout/{paymentId}/payment-methods

This returns the available cryptocurrencies based on the application's currencyWhitelist.

Best Practices

  1. Start with major currencies — BTC, ETH, and stablecoins (USDT, USDC) are the most widely used
  2. Consider your audience — different regions prefer different cryptocurrencies
  3. Include stablecoins — they minimize exchange rate volatility for both you and the customer
  4. Keep the list focused — too many options can overwhelm customers

Next Steps