Payment

The RequestPayment is a request to debit mobile money from subscribers account. Partners must code the App based on the API field requirements so that the App can send correct requests accordingly.

BENIN

Endpoint URI:

Mtn

POST {baseUrl}/QosicBridge/user/requestpayment

Moov

POST {baseUrl}/QosicBridge/user/requestpaymentmv

Celtiis

POST {baseUrl}/QosicBridge/sb/v1/requestpayment

---

TOGO

Togocel

POST {baseUrl}/QosicBridge/user/requestpayment

Moov Togo

POST {baseUrl}/QosicBridge/tg/v1/requestpayment

---

Body request and response format

Request

Content-Type: application/json[Basic Authentication headers]

{     	
     "msisdn": "22967370249",
     "amount": "100",
     "firstname":"Fabro",
     "lastname":"Bi",
     "transref" :"12340890000",
     "clientid": "*****" 
}

Response format

{
    "responsecode": number,
    "responsemsg": string,
    "transref": number | string,
    "serviceref": null, (this line is not include in Togo response format)
    "comment": string | null
}

Success response format

{
    "responsecode": "01",
    "responsemsg": "Succesfull",
    "transref": "12340890r000",
    "serviceref": "7427291567",
    "comment": null
}

Error response format

{
  
    "title": "Internal Server Error",
    "status": 500,
    "detail": "message"
}

Element	Type	Decription
msisdn	string:MANDATORY	Subscriber’s account i.e. 229 67******
amount	string:MANDATORY	Transaction amount i.e. 100
firstname	string:OPTIONAL	Firstname of the subscribe
lastname	string:OPTIONAL	Lastname of the subscriber
transref	string:MANDATORY	Unique transaction reference. To be used as unique identifier in call to request for a payment.
clientid	string:MANDATORY	A unique generated id for each third-party application. This id is generated by Qos and should be included in all payment requests.