S2S MoMo (TZS and UGX)

Initiate S2S

Authorization	Set to Bearer PUBLIC_KEY
Content-Type	Set value to application/json

The public key can be gotten from the 'Settings' page on your Startbutton dashboard.

Post a request to the URL below, where the base URL is determined by the environment you are in.

BaseUrl

Sandbox/PROD : https://api.startbutton.tech

Endpoint

POST {{baseurl}}/transaction/initialize/s2s/mobile_money

Here's a sample request below

The next step after initiating the transaction is to verify the OTP using this endpoint. Enter any 6-digit number as the OTP to complete the transaction.

To test a success or failure scenario, find a test number here.

Required parameters (TZS)

{
    "phone": "[phone]",
    "email": "[e-mail]",
    "amount": 12000,
    "currency": "TZS"
}

Optional parameters included (TZS)

To mock a failed Scenario (TZS)

Required parameters (UGX)

{
    "phone": "[phone]",
    "email": "[e-mail]",
    "amount": 120000,
    "currency": "UGX"
}

Optional parameters included (UGX)

Failed Scenario (UGX)

The amount should be in fractional units.

Currency	Minimum amount	Maximum amount
TZS	10000	300000000
UGX	50000	500000000

Here's a sample response

Success (TZS)

{
    "success": true,
    "message": "Payment initiated successfully!",
    "data": {
        "reference": "ffeaf8d13f71",
        "nextStep": "PIN"
    }

Success (UGX)

Failed

The next step is always PIN for both TZS and UGX. Your users only need to enter their PIN on the prompt on their phone.