How to connect M-Pesa¶
Who can do this: The company owner or a full-access administrator · Available on: Mobile · Web
Preview: this setup flow saves your details on this device but doesn't send them to Safaricom yet. It isn't available in the released app yet.
Once M-Pesa is connected, you can send a payment prompt (STK push) to a customer's phone at checkout, and payments to your till are matched to sales without typing the confirmation code.
Before you start¶
- You need an existing Buy Goods till or paybill number. If you don't have one, apply at a Safaricom shop or through a Safaricom partner. It usually takes 2–4 working days.
- Have the till owner's M-Pesa phone nearby. We send it a code.
- Have your KRA PIN and your ID or business registration certificate ready.
Steps¶
- Go to Settings → Payments & tax → M-Pesa. (It's also under Optional on the setup checklist, and on the Payment modes screen.)
- Read what you get, then tap Get started.
- Your M-Pesa account: choose Buy Goods (Till) or Paybill.
- For a till, enter the till number and store number. The store number is the head office number on your M-Pesa statement.
- For a paybill, enter the paybill number and choose what customers type as the account number.
- Business details: check the business name, business type, KRA PIN and the owner's phone. They must match what Safaricom has for the till.
- Where you'll use it: pick the branches that take M-Pesa on this number. Turn on Payment prompts, Match till payments to sales, or both, and choose the payment mode that M-Pesa money is recorded in.
- Confirm it's your till: tap Send code, then enter the 6-digit code texted to the owner's phone. Upload the documents listed for your business type. You can also add them later.
- Review and submit: check everything, then tap Submit for activation.
You can tap Save & exit at any step. Next time you open M-Pesa, you carry on where you left off.
What happens next¶
The status page shows each stage: Submitted → Verifying ownership → Activating with Safaricom → Test payment → Live.
- Activation usually takes 2–4 working days once your documents are in.
- When the status shows Action needed, tap Send KSh 1 prompt and approve it on the owner's phone. M-Pesa then goes Live.
- Once it's live, you can switch payment prompts and till matching on or off, send a test prompt, or disconnect M-Pesa.