Skip to content
BitMomo Developers
Test money only. BitMomo currently runs on test networks. Payments use testnet coins and no real money moves. Live keys are not available yet.

Environments

Base URL

Section titled “Base URL”
Purpose URL
API https://api.dev.bitmomo.app/api/v1
Merchant dashboard https://merchant.dev.bitmomo.app
Hosted checkout https://customer.dev.bitmomo.app/pay/{payment_id}

The SDK has no default host. Always pass baseURL (for example https://api.dev.bitmomo.app). Remote origins must use HTTPS; plain HTTP is accepted only for localhost during development.

Test money only

Section titled “Test money only”

BitMomo currently accepts test money only:

  • API keys start with bm_test_, and every payment and balance is in the test environment.
  • Customers pay with testnet coins (for example USDT on Tron Nile or USDC on Base Sepolia). No real money moves.
  • Live keys (bm_live_) cannot be created yet. When live payments open, keys and data will stay separated by environment: a test key never sees live payments, and the reverse.

Check what an environment supports at runtime:

Terminal window
curl https://api.dev.bitmomo.app/api/v1/capabilities

Supported coins

Section titled “Supported coins”

The enabled coins and networks can change, so read them from the API rather than hard-coding a list:

Terminal window
curl https://api.dev.bitmomo.app/api/v1/tokens   # enabled coins and networks
curl https://api.dev.bitmomo.app/api/v1/rates    # indicative GHS prices

Pass the coin’s code as crypto_type when you create a payment, for example USDT_TRC20, USDC, BASE_USDC or SOL_USDC. Prices are always quoted from Ghana cedis (GHS), the only accepted fiat currency.

Not available yet

Section titled “Not available yet”
  • Live payments and live keys.
  • Webhook configuration per endpoint: one configuration applies to the whole merchant account.
  • Payout keys and webhook-admin keys are not yet offered in the dashboard; manage webhooks in Settings → Webhooks.