← All insightsINSIGHTS / PAYMENTS

We already have a mobile money merchant number. Why integrate payments?

“Why can't we just put our mobile money merchant number on the website?”

Imagine you run a business in Uganda and want customers to pay for your services online. Some would use mobile money; others would prefer a debit or credit card. But now there is talk of extra setup, opening another account and supplying business documents again.

For mobile money, you already have something that works: a merchant number, the number customers enter to pay your business. Why should taking payments through your website involve more work?

That number can go on the website. The difference is what happens after someone pays. If a person checks the payment and provides the service, the mobile money merchant number may be enough. If the website needs to handle those steps, it needs payment information too: It needs to know that a customer has successfully paid for something. That is payment integration: connecting payment information to the website so it can act on the result.

The learner has paid, but the course is still locked

To see why the merchant number alone may not be enough, suppose the business sells access to an online course. A learner registers, pays using its merchant number and then has to send a message asking for access. The staff member who handles enrolments is away, so the learner waits.

When the staff member returns, they check the business's payment record, work out which learner and course the payment belongs to, and open access. They (the staff member) then add the payment and enrolment to the stored records used for reports.

The money arrived, but the course website did not know which purchase it belonged to. Displaying a merchant number gives the learner payment instructions. It does not tell the website that this learner has paid for this course.

Manual checks can work when learners know when to expect access. Here, though, the business wants learners to pay and begin without waiting for staff.

Connecting payment to course access

With payment integration, the website creates an order for the learner's chosen course. It includes an identifying number with the payment request, so the answer can be matched to the right order.

The website checks the payment service's answer: did the payment succeed, and was it for the expected order and amount? Once those checks pass, it opens the course and saves the payment and enrolment details. Staff can see who paid and received access without copying each purchase into another record.

Two ways to open the course after payment. With staff checks, the learner waits until someone returns to check payment, match the order and open access. With a working connection, the website checks the payment answer, matches the order and opens access.
Both routes need payment checks. The connection removes the wait for a staff member when payment succeeds.

These steps must be set up and tested. Opening a payment account alone does not make the course website do them.

Does that mean using another payment company?

The course website needs reliable payment confirmation before it opens access. That raises the next question: where does the confirmation come from? The business may connect directly to its mobile money provider, where that option is offered, or use a payment gateway — a service that connects the website to the payment methods it supports.

A direct connection covers the provider's supported services. For example, if your business is registered as a merchant for MTN Mobile Money, a direct connection covers the payment services MTN enables for that account. It does not automatically add card payments or other networks. A payment gateway on the other hand, may bring mobile money (of multiple networks) and cards into one arrangement, which matters to this course seller. Available methods depend on the gateway and what it supports for that business in Uganda. Choosing who handles the payment is separate from connecting the result to the website.

A direct connection needs the provider's approval and setup. Having a merchant number allows the business to receive payments, but a separate connection is needed for the website to receive payment information.

An API can provide that connection. It is a way for two computer systems to send requests and replies. Here, the course website asks the chosen payment service whether a payment succeeded, and the service sends back its status. The website still checks the order and amount before opening access.

An API request and reply: the course website asks the payment service whether payment for order A12 succeeded. The payment service replies that it succeeded. The website then checks the order and amount before opening access.
Illustrative API exchange after a successful payment. The API carries information; the course website controls access.

The learner also needs somewhere to enter payment details. A hosted checkout is a payment page run by the payment company. It is the page the learner sees; the API carries information between systems. A hosted page can be used with staff checks or connected to the course website. The page alone does not open the course.

“We've already been checked. Why does another provider ask again?”

The business already supplied documents for its merchant account. Being asked again can feel like repeating work.

The new payment gateway company needs to carry out its own checks. It may ask who owns or runs the business, what it sells and where the collected money should be sent. Depending on the company and business type, this may mean identity documents, business registration papers, a description of the services and proof of the receiving account. One gateway's Uganda onboarding guide gives examples for different business types; it is not a checklist for every provider.

Checks by one provider do not automatically meet another's requirements. Merchant accounts also involve checks, and a direct connection to a mobile money provider can require further approval. The documents needed depend on the arrangement.

Is the extra work worthwhile?

For this course seller, the benefit is clear: learners can pay through supported methods and begin once payment is confirmed, even while staff are away.

That has to be weighed against setup, testing, fees and ongoing support. When and where the provider sends the collected money matters too.

There will still be cases needing help. While a payment is waiting for confirmation, the learner needs a clear update. If it fails, they need to know what to do next. Staff must be able to investigate when payment succeeds but course access does not open.

This is one use of custom software. An owner can describe what happens after customers pay without knowing how the connection should be built. Enquiries are welcome at inquiries@crownzcom.tech.

A short checklist can help frame the conversation:

  • What should happen after payment?
  • How is it handled today?
  • Where do customers wait or staff repeat work?
  • Which payment methods are needed?
  • Is the benefit worth the setup and ongoing costs?
  • What happens if payment succeeds but the service or course access is not provided?
← Back to insightsExplore custom software ↗