API

The BMONI Embedded REST API — interactive reference hosted at embedded.bmoni.com.

The BMONI API is the backend that powers the embedded wallet product. It exposes endpoints for wallet provisioning, balance queries, transaction history, and money movement across the supported regions — the US, Nigeria, Canada, Europe, Mexico, and wider LATAM.

The full interactive API reference — including all endpoints, request/response schemas, and a live Try it console — is hosted separately at embedded-dev.bmoni.com/docs.

Open the API reference

View all endpoints, schemas, and try requests live in the Scalar API reference.

---

Base URL

Production:

https://embedded.bmoni.com

Development / Sandbox:

https://embedded-dev.bmoni.com

For sandbox testing you can use the shared key pk_a025cacbf33a_76fb864113f3540909de5b1da39cc146906e35b1c6d4d1e4 as your x-api-key. It only works against the development base URL — get your own key before you touch production.

---

Authentication

All API requests require your partner API key in the x-api-key header:

x-api-key: <your_api_key>

Organizations should email [e-mail] to get their own sandbox API key. Individuals exploring the API can use the shared sandbox key above instead.

---

Implementing EmbeddedWalletReadDataSource

If you are using bmoni_embedded_wallets_cards, implement EmbeddedWalletReadDataSource against the API endpoints documented at the reference link above. The contract interface is defined in Data contracts.