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.

BaseUrls

PROD : https://api.startbutton.tech

DEV/ Staging: https://api.startbutton.builditdigital.co

Endpoint

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

Here's a sample request below

Required parameters (TZS)

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

Optional parameters included (TZS)

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

To mock a failed Scenario (TZS)

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

Required parameters (UGX)

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

Optional parameters included (UGX)

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

Failed Scenario (UGX)

{
    "phone": "[phone]",
    "email": "[e-mail]",
    "amount": 120000,
    "currency": "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)

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

Failed

{
    "success": false,
    "message": "unknown provider"
}

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.