Mobile Wallet Endpoints

Last-Mile Access

Endpoints are optional. The OS is the product.

Mobile Wallet OS supports multiple last-mile endpoints — ATMs, agent networks, messaging flows, and POS terminals. Each one consumes the OS via the same REST APIs. They are interchangeable and independently configurable per market.

  • Same API for every endpoint type — just change the endpoint_type field
  • Enable or disable endpoints per market in the Operator Dashboard
  • Physical endpoints generate real-world validation data
  • Add new endpoint types without changing your core integration
Endpoint Connection Diagram

How endpoints work

Three principles that make endpoints interchangeable and future-proof.

01
One API for all endpoints

ATMs, agents, and messaging interfaces all consume the same REST API. The endpoint_type field routes behavior — no separate integration needed.

02
Per-market configuration

Enable or disable endpoint types per market in the Operator Dashboard. Run ATMs in Cameroon, agents in Kenya, messaging in Ghana — all from the same platform.

03
Real-world validation

Physical endpoints generate ground-truth data that feeds back into platform abstractions. Edge cases discovered on the ground become product features.

Self-service cash infrastructure

ATMs

Endpoint Type

ATM Network

Self-service cash infrastructure

Networked cash terminals that support both deposits and withdrawals. ATMs consume Mobile Wallet OS as a service — they authenticate users, initiate transactions via API, and receive settlement confirmations over webhooks.

ATMs run the same integration code as any other endpoint. The OS handles compliance, liquidity, and rail selection automatically.

  • Deposits & withdrawals via single API
  • PIN, QR code, and NFC authentication
  • Real-time settlement confirmations
  • Per-market availability configuration
Deploy ATMs
Human-assisted cash access

Agent Networks

Endpoint Type

Agent Network

Human-assisted cash access

Field agents — retail shops, kiosks, mobile operators — who handle cash transactions on behalf of end users. Agents interact via a lightweight mobile or web interface that calls the same OS APIs as any other endpoint.

Float management, commission tracking, and audit trails are handled automatically by the OS Liquidity Router and Compliance Engine.

  • Web + mobile agent interfaces
  • Automated float management
  • Commission tracking per transaction
  • Full audit logs via OS
Deploy Agent Networks
Conversational & retail channels

Messaging & POS

Endpoint Type

Messaging + POS

Conversational & retail channels

WhatsApp-based flows, USSD sessions, and point-of-sale terminals that let users transact without a dedicated app. These interfaces wrap the OS API behind conversational or hardware-driven UIs.

Perfect for feature-phone users, merchant locations, and markets where WhatsApp is the primary digital channel.

  • WhatsApp, USSD, and POS support
  • OTP + session token authentication
  • Multi-language flows
  • Per-channel transaction limits
Deploy Messaging & POS
Market Configuration

Enable what you need. Per market. Per endpoint.

Endpoint availability is managed through the Operator Dashboard — no redeployment required. Activate ATMs in Cameroon, agents in Kenya, and messaging in Ghana from a single interface.

cm
Cameroon
ATMs
Agents
POS
Messaging
4 / 4 active
ke
Kenya
ATMs
Agents
POS
Messaging
4 / 4 active
gh
Ghana
ATMs
Agents
POS
Messaging
4 / 4 active
ng
Nigeria
ATMs
Agents
POS
Messaging
2 / 4 active
sn
Senegal
ATMs
Agents
POS
Messaging
4 / 4 active
tz
Tanzania
ATMs
Agents
POS
Messaging
3 / 4 active
zm
Zambia
ATMs
Agents
POS
Messaging
2 / 4 active
ug
Uganda
ATMs
Agents
POS
Messaging
2 / 4 active
Developer Experience

One API. Every endpoint.

The same REST API that powers fintech integrations also drives ATMs, agent interfaces, and messaging flows. Add a new endpoint type by changing a single field — not rewriting your integration.

  • Single API for all endpoint types
  • endpoint_type field routes behavior
  • Same webhooks for every channel
  • Per-endpoint configuration in Dashboard
endpoint-integration.js
1// Initialize the client 2import { MobileWalletClient } from '@mobilewallet/sdk'; 3 4const client = new MobileWalletClient({ 5 apiKey: 'YOUR_API_KEY', 6 environment: 'sandbox' // or 'production' 7}); 8 9// Create a transfer 10const transfer = await client.transfers.create({ 11 amount: 50000, 12 currency: 'XAF', 13 destination_rail: 'mtn_momo', 14 destination_market: 'CM', 15 recipient: { 16 type: 'mobile_money', 17 phone: '+237612345678', 18 provider: 'mtn' 19 }, 20 reference: 'txn_abc123' 21}); 22 23// Poll for status 24const { status, settled_at } = await transfer.poll();
ATM transaction

Real-world

Validation from every endpoint

Agent with customer
Validation Layer

Endpoints as proof of concept.

Physical endpoints aren't just output channels — they're validation infrastructure. Every real-world ATM or agent transaction generates data that informs the software abstractions in Mobile Wallet OS. Edge cases discovered on the ground become platform features.

  • Live transactions validate platform abstractions
  • Edge cases become product features
  • Real-world settlement conditions tested continuously
  • Software improves from physical deployments
Learn about deployments

FAQ

Questions about endpoints.

Everything you need to know about deploying and managing last-mile interfaces.

Talk about deployment

We help you launch in your first market.

Contact deployment team

Do I need different APIs for different endpoints?

No. All endpoints consume the same REST API. The endpoint_type field tells the OS how to route the transaction — whether it's coming from an ATM, agent interface, POS terminal, or messaging flow.

How do I enable endpoints in new markets?

Endpoint availability is configured per market in the Operator Dashboard. Flip a switch to activate ATMs in Cameroon or agents in Kenya — no code change required.

What happens when an endpoint is offline?

The OS queues transactions and retries automatically. You receive webhooks for every state change. For physical endpoints, the interface displays appropriate offline messaging.

Can I run multiple endpoint types in one market?

Yes. Markets can support any combination of ATMs, agents, POS, and messaging. Each endpoint type is independently configurable.

How do endpoints handle compliance?

The OS handles all compliance per market — KYC tiers, transaction limits, AML screening. Endpoints just collect and forward user data; the OS determines if transactions are allowed.