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

SDKs

BitMomo has official server-side SDKs in four languages. They cover the same merchant API, verify webhooks the same way and follow the same safety rules, so you can pick whichever matches your stack.

Language Install Runtime Guide
Node.js / TypeScript npm install @bitmomo/merchant-sdk Node.js 18+ Node.js SDK
Python pip install bitmomo Python 3.10+ Python SDK
Go go get go.bitmomo.app/merchant Go 1.22+ Go SDK
Rust cargo add bitmomo Rust 1.88+ Rust SDK
  • Covers the merchant API: payments (create, get, status, list), payouts, rates, balances, webhook settings and secret rotation, and payment links. See Node.js SDK for the endpoint and scope of each call.
  • Verifies webhooks: signature, freshness and the signed headers, with versioned secrets for rotation, and an in-memory delivery dedupe helper. See Webhooks.
  • Keeps money exact: amounts are decimal strings or exact decimal types, never binary floats. Sending a float amount is refused.
  • Retries safely: reads retry on 429 and 5xx (up to 3 attempts, honouring Retry-After); writes are never retried automatically. Payouts refuse to send without an idempotency key.
  • Protects your key: the base URL must be an https:// origin (plain http:// only for localhost), and redirects are refused, so your key is never sent to another host.
  • Fails loudly: a response that breaks the API contract becomes a schema error instead of a half-filled object. Every failure has a status, code, message, request_id and retriable flag. See Errors.

All four SDKs run against the same shared test cases (webhook signatures, error handling and every API request and response), so they behave the same way.

Every SDK call is a plain HTTPS request with an x-api-key header. The API reference documents each endpoint, and Webhooks explains how to verify signatures yourself.