Offline paymentsLive

Payments that keep working when the network doesn't.

Load a device online, pay offline, settle in batches when it reconnects, with replay protection.

Illustrative
Why it matters

What it changes for you.

In a market, on a bus, at a crowded event, the network is what fails before anything else. Card machines stop, transfers hang, and the sale moves to cash or doesn't happen.

Offline payments let a customer move value onto their device while they're online, then pay another device phone to phone or at a POS with no network at all. Both devices sign the payment. When either reconnects, the batch settles and the payee is credited.

The money never lives on the phone. It sits in a device account on the ledger, which the device can spend against while disconnected. Bridge always knows the true balance, and a device can't create value.

How it works

Step by step.

  1. Load the device

    Online, the customer moves value from their main account into a device account on the ledger.

  2. Pay with no network

    Phone to phone or at a POS, over QR, NFC or Bluetooth. Both devices sign the payment.

  3. Hold the receipt

    Both devices keep the signed payment until one of them is back online.

  4. Settle

    The batch settles; replays are rejected and caps are enforced from settled history.

  5. Credit the payee

    The payee's account is credited, and you get a signed webhook.

What you can switch on

Built in, not bolted on.

Value stays on the ledger

The device holds a claim and a signing key, not money. It can't mint value.

Signed by both devices

Every payment carries both signatures, verified at settlement.

Replay protection

A payment presented twice settles once.

Caps from settled history

How much a device can hold and spend offline is derived from what it has settled before.

Freeze a lost device

From any other device. Caps keep the value on any one device small.

Phone or POS

Customer phones pay each other or pay a merchant's terminal.

  • Load value onto a device while it is online
  • Phone-to-phone or POS payments with no network
  • Batch settlement when either device reconnects
  • Replay protection, and caps derived from settled history
  • Freeze a lost device from anywhere
Use cases

How businesses use it.

Illustrative businesses, not customers. Figures are made up to show the flow.

A wallet app for traders at Balogun Market · Merchants & e-commerce

Market stalls when the network jams

On busy days the network jams by mid-morning. Traders lose sales to customers without cash.

  1. Customers keep a little on their phone while online
  2. At the stall, they tap the trader's phone and enter their PIN
  3. Both phones sign and keep the payment
  4. It settles when either phone gets signal

Sales don't wait for the network.

Illustrative

A transport company running Lagos–Ibadan routes · Transit

Fares on intercity buses

Conductors collect cash fares between towns where there's no signal, and cash goes missing.

  1. Conductors carry a POS loaded as a payee device
  2. Passengers tap their phones to pay fares on board
  3. The POS keeps the signed fares
  4. At the depot, the day's fares settle in one batch

Fares are collected without cash, even with no signal on the road.

Illustrative

A microfinance bank's agent network in rural Niger State · Banks, MFBs & PSBs

Agents in areas with weak coverage

Agents' POS terminals fail when coverage drops, and customers walk away.

  1. The bank integrates offline payments into its agent app
  2. Customers pay agents phone to phone with no network
  3. Agents settle when they reach coverage
  4. The bank sees every settled payment on its ledger

Agents keep serving customers when the network doesn't.

Illustrative
What it won't do

Honest limits.

  • Value on a device is held in a device ledger account at the bank; it is never created offline.
  • Mobile and POS SDKs are on the way: see SDKs.
For developers

Deposit into the caller's device wallet from their own main account.

Endpoints in the Offline payments API reference, with every parameter and response.

State changes arrive as signed webhooks. How webhooks work

POST /offline/deposit

curl -X POST "https://api.bridgemoni.com/offline/deposit" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "X-Idempotency-Key: a-unique-key-per-intent" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": {
      "amount": "250000.00",
      "currencyCode": "NGN"
    },
    "narration": "March payroll",
    "deviceId": "a7f3-k2m9-4c1d-8e5b"
  }'

Questions about offline payments

Where is the money while the phone is offline?

In a device account on the ledger. The phone holds a claim on it and a signing key, not the money.

What if the same balance is spent twice?

Both payments look valid offline, but whichever settles first succeeds and the other is rejected. Caps limit the exposure.

Is there an SDK?

The offline endpoints are live. Mobile and POS SDKs are on the way: see SDKs.

What if a phone is lost?

Freeze it from another device. Value already on it that hasn't settled can be lost, which is why caps keep it small.

Bridge for Business

Tell us what you're building.

We'll come back with what's live for you today, and what's next.