S2S MoMo XOF and XAF

You can receive payments using our S2S integration from these countries; Benin, Côte d’Ivoire, Togo, Senegal, Mali, Burkina Faso (XOF), and Cameroun (XAF).

TO GET STARTED:

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 on.

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 (XOF)

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

Required Parameters (XAF)

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

To simulate a Failed response

{
    "phone": "[phone]",
    "amount": 50000,
    "email": "[e-mail]",
    "currency": "XOF"
}

Here's a sample response:

Sample Response (XOF and XAF)

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

Failed response

{
    "success": false,
    "message": "Failed to process payment request"
}

The next step can either be OTP or PIN. If your customer is new to the service, they'll receive an OTP initially. Afterwards, for subsequent transactions, they'll be provided with a PIN.

When it is an OTP; you need to present the User with a screen to enter OTP and then call the endpoint below.

To verify OTP: use this guide.

The amount should be in fractional units.

Currency	Minimum amount	Maximum amount
XOF	200	1500000
XAF	200	1500000