Customer Flow — Connect, Choose Billing & Add Money

This page follows a customer (a workspace user) end to end through pay-per-message billing: connecting a WhatsApp number, choosing how they want to pay for messages, topping up their wallet, and then spending it as they send. Every money value the customer sees is shown in the platform currency.

Background reading. For the big picture of how BSP billing works see the Overview, and for the admin side see Admin Pages. URLs below use the example base http://192.168.1.189:8008 — that is the admin's own domain; your customers use your real domain.

1. Connect a WhatsApp number

URL: http://192.168.1.189:8008/devices

The customer connects a WhatsApp number on the Devices page as usual. As soon as the number connects, they are asked “How do you want to be billed for messages?” and shown two cards:

CardWhat it means for the customer
Card A — “I pay Meta directly”The customer's own Meta payment method is billed by Meta for messages. WaDesk does not charge a per-message wallet fee — they only need an active plan for the platform features.
Card B — “Bill me through [Brand]”The customer tops up a wallet inside WaDesk, and each message is charged from that wallet at your rate. They need no Meta payment method — you handle the Meta billing on your credit line.
When Card B is unavailable. If the platform's Meta credit line has not been set up (see Reseller billing), Card B is shown disabled with a “Not available yet” note, because there is nothing to bill messages against.

Choosing Card B does two things: it saves the customer's billing choice, and it auto-attaches the platform's credit line to that number so messages can start being billed immediately.

2. Add money to the wallet

URL: http://192.168.1.189:8008/account?tab=wallet

On the wallet tab there is an “Add money to your wallet” box. The customer can:

  • Type any amount, or tap a quick chip — 500 / 1000 / 2000 / 5000.
  • Pay through a payment gateway.
  • See the money land in their wallet balance (the top-up runs through the checkout route /checkout/wallet).

All amounts are shown in the platform currency. The older fixed credit bundles are still available as a secondary “Or buy a bundle” option beneath the free-amount box, for customers who prefer preset packs.

3. Spend it

Once there is money in the wallet, every message the customer sends deducts from it at the per-destination price (the country + category rate you set on Message pricing). The wallet tab shows:

  • Balance — how much money is left.
  • Spent (30 days) — how much has been used recently.
  • A “how billing works” explainer so the customer understands per-message charging.

When the balance runs low the customer gets a low-balance alert. If it reaches zero, the next campaign or broadcast is blocked at launch with a “top up to send” message, so no sending happens without funds.

4. Test it end to end

Use this checklist to confirm the whole funnel works before going live:

  1. Enable a gateway at http://192.168.1.189:8008/admin/settings/payment-gateways — the Offline / Manual gateway is ideal for testing without real money.
  2. Connect a number at /devices.
  3. Pick Card B (“Bill me through us”) so the credit line attaches.
  4. Add money on /account?tab=wallet.
  5. Send a message.
  6. Watch the balance drop on the wallet tab, and the profit appear on http://192.168.1.189:8008/admin/bsp (Message income).
Related. See the Overview for how the pieces fit together and Admin Pages for the pricing, income and reseller-billing screens behind this flow.
WaDesk Documentation