Shopify and M-Pesa in Kenya: What to Check Before Launch
By Joseph Maina · · 4 min read
For a Shopify store serving Kenyan customers, payment planning belongs near the start of the project. You need to know how a customer pays, how your team confirms the money arrived, and what happens when payment fails. Adding an M-Pesa logo to a page does not answer any of those questions.
Can your business use the proposed M-Pesa integration?
Verify the provider's current Shopify integration and eligibility for your business before approving it. Availability can depend on store location and the provider's own requirements. Ask the provider to confirm the specific M-Pesa payment flow it supports; do not assume that every gateway accepts the same methods.
Request written answers about onboarding documents, settlement timing, refunds, support and the currencies supported for your account. These are provider-specific questions. A recommendation made for a different merchant or country may not fit your store.
- Is this integration currently available for my store and business location?
- What does the customer see on a phone during payment?
- How does a successful payment update the Shopify order?
- What happens after a timeout, cancellation or duplicate attempt?
- Which provider charges and Shopify transaction fees apply?
Sources and further reading
How is a manual M-Pesa payment different?
A manual arrangement gives the customer instructions for paying outside the checkout payment flow. Shopify supports custom manual payment methods: the order remains unpaid until the merchant confirms receipt and marks it paid. This does not automatically verify an M-Pesa transaction.
If you use this approach, write instructions around an approved business payment channel, the order reference and the person responsible for checking receipts. Confirm the transaction against your business records before dispatch. A screenshot sent in a message should not be your only reconciliation process.
Choose the workflow your team can operate consistently. A manual process needs someone available to match payments to orders. An integrated process still needs a plan for exceptions. Ask about both the usual checkout and the cases where the customer needs help.
Sources and further reading
Test payment, order status and delivery together
Write a test sheet before launch. Start from a product page on a phone, choose an option, add it to the cart and enter a delivery address. Check that the customer understands the total and the next step before attempting payment.
Then inspect the order from your team's side. Does the status match the payment outcome? Are the confirmation messages understandable? Can staff identify what to dispatch and where? Follow the provider's testing instructions. A simulated Shopify checkout test alone does not prove that a separate M-Pesa integration settles correctly.
Shopify recommends placing test orders during setup and after payment-setting changes. If a live transaction is needed to validate a provider, agree the amount and refund process with the merchant first; real processing fees may apply. Make sure test mode is turned off before accepting customer orders.
Sources and further reading
What should you send when asking for checkout help?
Share your store link, business location, required payment methods, delivery areas and the provider you are considering. If checkout is already failing, describe the step where it fails and whether an order appears in Shopify. Remove customer details from any examples you share.
I scope payment and shipping setup as part of Shopify store work. The first step is checking the available integration and your operating process, then agreeing the build and testing tasks. Use the enquiry below if you want to talk through a new checkout or an existing payment problem.
A launch-ready checkout needs a clear payment outcome for the customer and a reliable order status for your team.