A Biti wallet for every customer of your business.

Your customers pay, get paid and cash out inside your own app. Biti runs the wallet.

Biti home screen
Biti Your wallets screen
For business

What you get as a Biti Partner

You keep your app and your customers. Biti gives each of them a real wallet and moves the money.

A wallet for each customer

Every customer gets their own Biti wallet in US dollars. You do not build or run a wallet.

Inside your own app

Customers sign up and pay without leaving your app, with your name and your screens.

Local money in and out

They top up and cash out with EVC Plus, Zaad, eDahab and the other methods Biti supports.

Biti does the checks

Biti checks the phone, reviews identity and asks for the customer's PIN on every payment.

Who it is for

For apps whose users hold and move money

Marketplaces

Buyers pay from their wallet, sellers get paid into theirs.

Delivery and transport

Drivers and couriers get paid and cash out to their own mobile money.

Schools

Each student or parent has a wallet for fees, books and trips.

Employers

Staff get salaries and advances into a wallet they control.

NGOs and aid

People receive support into a wallet, even before they install Biti.

Groups and members

Members of a group get their own limits through member groups.

How to start

Three steps to go live

STEP 1

Talk to us

Tell us about your business and your customers. We agree on what you need.

STEP 2

We set you up

Biti opens your business account and gives your developer the keys to connect your app.

STEP 3

Go live

Your customers open their wallet in your app and start paying and getting paid.

What it costs

Clear fees on the payments you take

You pay a small fee on payments you take. All amounts are in US dollars.

  • Biti wallet0.1% of the amount
  • Mobile money2% of the amount
  • Bulk send, $1 to $2,0001% of the amount
  • Bulk send, $2,000 to $5,0000.5% of the amount
  • Bulk send, over $5,000Contact us
  • Visa and MastercardComing soon

Order payments, through the API or in the app, include a 5% Somali government fee. Other transactions do not.

See all fees and limits

Our partners

Businesses that build on Biti

Diyaar

Delivery app: stores sell, drivers deliver.
Live

Customers pay Diyaar orders from their Biti wallet inside Biti. Biti holds each order's split for the store and the driver, and Diyaar releases it.

  • Mini app
  • Orders
  • Order splits
  • Webhooks

Want to be next? Talk to us

How it works

From sign-up to a ready wallet

Two calls from your server, one SMS code for your customer.

Your appBitiCustomer1. onboard-customerphone, your reference, scopes2. SMS codevalid for 10 minutes3. Types the codein your app4. onboard-verifyonboarding id and code5. wallet_id and access_tokenreturned once6. Sets a PINthe first time they open Biti7. customer.onboardedwebhook

Phone already on Biti? onboard-customer returns existing_customer and Biti sends a connect request instead. The customer approves it in Biti, and your app gets access to the wallet they pick.

  1. Your app

    Send the phone number

    Call onboard-customer with the phone, your own reference, the name and the access you need (scopes). You can also send identity data you checked.

  2. Biti

    Send an SMS code

    Biti sends its own code to the phone. The code is valid for 10 minutes. If the phone already has a Biti account, Biti makes a connect request instead.

  3. Customer

    Type the code in your app

    Your app passes it to onboard-verify. After 5 wrong codes the onboarding fails, so you can start a new one.

  4. Biti

    Open the wallet

    Biti creates the account and returns the wallet id and an access token with the approved scopes. You can check progress at any time with onboard-status.

  5. Customer

    Set a PIN in Biti

    The answer says needs_pin: true. The customer sets their PIN the first time they open Biti. Every payment then needs that PIN.

What your app can do

Use the wallet from your server

Send the client headers X-Biti-Client-Id and X-Biti-Client-Secret on every call, and the customer's X-Biti-Token on wallet calls.

Read the wallet wallet.read
POST /partner/v1/connected-wallet

→ 200
{
  "wallet_label": "Main Wallet",
  "currency": "USD",
  "balance": 412.50,
  "status": "Active"
}
Top up the wallet wallet.topup
POST /partner/v1/create-topup
{ "method_id": "LA-0012", "amount": 20,
  "currency": "USD", "reference": "TU-1042" }

→ 200
{ "topup_id": "TOPUP-00014", "status": "pending",
  "fee": 0.20, "total": 20.20,
  "instructions": { "type": "pay_merchant_code",
                    "ussd": "*712*123456*20#" } }
Ask the customer to pay PIN in Biti
POST /partner/v1/create-payment-request
{ "amount": 24.50, "currency": "USD",
  "reference": "ORD-1042", "mode": "request",
  "description": "Order ORD-1042" }

→ 200  { "order_id": "MPO-00041", "status": "pending" }
// The customer gets a notification and pays with their PIN.
Cash out to mobile money customer approves
POST /partner/v1/create-withdrawal
{ "method_id": "LA-0012", "amount": 84,
  "currency": "USD", "reference": "CASHOUT-D1042-7" }

// Nothing moves until the customer approves:
// with the PIN in Biti, or with an SMS code
// on the Biti page in approval_url.
Send a notification notifications.send
POST /partner/v1/notify
{ "title": "Order ORD-1042",
  "message": "Your order is on the way." }

→ 200
Disconnect any time
POST /partner/v1/disconnect

→ 200
// The access token stops working. The customer can also
// disconnect in Biti: Settings, Connected apps.

Also available: profile, get-topup-methods, auto-pay with create-mandate, and orders with create-order. See every endpoint.

Security and control

Safe for your customer, simple for you

Biti checks the phone

Biti sends its own SMS code. Your app never makes or sees that code before the customer types it.

PIN on every payment

The customer sets a PIN in Biti. Payments and cash-outs need it, or an approval they gave.

Identity reviewed by Biti

Identity data you send is reviewed by Biti staff. It never sets a verification level by itself.

Scopes the customer approves

profile.read, wallet.read, wallet.topup, wallet.withdraw, notifications.send: your app gets only what it asked for.

One-time token

The access token is returned once. You can get one new token within 10 minutes if you lose it.

Leave at any time

The customer can disconnect your app or freeze their wallet in one tap.

The customer's verification level sets the limits, and their plan sets the fees. See fees and limits.

Full example

Open a wallet in two calls

The whole onboarding from your server. Keep your client secret on the server, never in the app.

  • Your app must have Can Onboard Customers turned on by Biti
  • Use your own customer id as the reference, so a repeat is safe
  • Store the access token with the customer in your database
API=https://api.biti.so/partner/v1

# 1. Start the onboarding
curl -X POST $API/onboard-customer \
  -H "X-Biti-Client-Id: $CLIENT_ID" \
  -H "X-Biti-Client-Secret: $CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+252615551234",
    "reference": "CUS-8841",
    "full_name": "Abdi Hassan",
    "scopes": ["profile.read", "wallet.read"]
  }'
# → { "onboarding_id": "ONB-00021", "status": "otp_sent" }

# 2. Send the code the customer typed
curl -X POST $API/onboard-verify \
  -H "X-Biti-Client-Id: $CLIENT_ID" \
  -H "X-Biti-Client-Secret: $CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{ "onboarding_id": "ONB-00021", "otp": "482913" }'
# → { "status": "completed", "access_token": "…",
#     "wallet": { "id": "618629126@biti", "currency": "USD" },
#     "needs_pin": true }
Questions

Hosted wallets in a few answers

More in the API docs or the help centre.

Is a hosted wallet a real Biti wallet?

Yes. Your customer gets a normal Biti account and wallet in US dollars. They can use it in your app through the API, and in the Biti app with their own PIN.

What if my customer already has Biti?

onboard-customer sees the existing account and makes a connect request instead. The customer approves it in the Biti app or on a Biti web page, and your app gets access to the wallet they pick.

Who checks the identity of the customer?

Biti checks the phone number with its own SMS code. Identity data that you send goes to Biti staff for review and never sets a verification level by itself. The customer can raise their level in the Biti app.

Can my app move money without the customer?

No. A payment request needs the customer's PIN, a charge needs an auto-pay mandate that the customer approved, and a withdrawal needs the customer's approval.

What if I lose the access token?

The token is returned once. Within 10 minutes after the onboarding, call onboard-verify again with the same onboarding id and code. Biti returns one new token and revokes the earlier ones. This works once.

Which apps can open hosted wallets?

Apps that Biti trusts for onboarding. Biti turns on Can Onboard Customers for your app after a review. Contact us to start.

Which fees and limits apply?

The limits of the customer's verification level and the fees of their plan apply, the same as for any Biti customer. See the fees and limits page.

Ready to become a Biti Partner?

Talk to us about your business, or send your developer to the API docs.