S2S MoMo (RWF)

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-dev.startbutton.tech

Endpoint

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

Sample code:

Required parameters

{
    "provider": "MTN",
    "phone": "250123123123",
    "amount": 2000,
    "email": "[e-mail]",
    "currency": "RWF"
}

To simulate a failed scenario

{
    "provider": "MTN",
    "phone": "250998998998",
    "amount": 2000,
    "email": "[e-mail]",
    "currency": "RWF"
}

Optional parameters

{
    "provider": "MTN",
    "phone": "250785283918",
    "amount": 2000,
    "email": "[e-mail]",
    "currency": "RWF",
    "reference": "eybr34muxk"
}

We support only two Mobile money providers: MTN & Airtel and as the case may be, you are expected to pass any of the 2 as the provider.

Sample response:

Success

{
    "success": true,
    "message": "Payment Request Successful",
    "data": {
        "reference": "a76b2d362692",
        "nextStep": "PIN"
    }
}

Failed response

{
    "success": false,
    "message": "Payment failed",
    "data": {}
}