Test money only. BitMomo currently runs on test networks. Payments use testnet coins and no real
money moves. Live keys are not available yet.
- Published to npm as
@bitmomo/merchant-sdk. Earlier builds were never published; inside the BitMomo repository the package was previously named @cryptopos/merchant-sdk.
- Breaking:
baseURL is required and must be an HTTPS origin (plain HTTP only for localhost). There is no default host, and redirects are refused.
- Payments expose
environment, order_terms, pricing_terms, exact economics, risk_status and a separate payout view.
- Balances include exact decimal-string values (
*_exact), per-currency and per-asset balances.
verifyWebhookEvent checks the complete signed envelope and distinguishes the fresh signing time (sent_at) from the event time (occurred_at).- Ships a durable reference merchant (
guides/reference-merchant.sql and .cjs).
- The
User-Agent header is bitmomo-merchant-sdk/<version>.
- Pass
baseURL explicitly.
- Read the
*_exact balance strings instead of the numeric fields, which remain for display only.
- Use
economics, order_terms, environment and payout instead of inferring them.
- Full webhook verification requires a complete signed
_meta envelope; deliveries from BitMomo always include one.
- API-key-only client: every method maps to an endpoint an API key can call.
requestPayout requires an idempotency_key.- Reads retry on
429 and 5xx with backoff (up to 3 attempts, honouring Retry-After); writes never retry automatically.
PaymentStatus includes cancelled, distinct from expired.