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.

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

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

Required Parameters (XAF)

To simulate a Failed response

Here's a sample response:

Sample Response (XOF and XAF)

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

Failed response

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