Payment Request
Initiate a payment request that sends a USSD prompt to the Customer for Payment
Step 1 - Initiating the payment request
Step 2 - Verifying the payee's number
Step 3 - Pushing the payment request to the payee
The customer will receive a prompt on their device asking them to approve the payment by entering their mobile money pincode.
You will receive a callback in the format below to your callback URL when the payment is successful
In the event of manual transaction status check, txstatus = 2 with code = SS07and message=Transaction not found will be returned if the transaction is not found or is not yet completed and approved by the customer. Payment Request transactions are recorded only after they are successful.
Never assume a payment is successful unless the payment callback or status check response txstatus indicates success.
Parameters | Description | Data Type |
---|---|---|
status | Status of the api request
| Int |
code | Unique Identifier for the different possible responses | String |
message | Endpoint response message | String/Array |
go | Not applicable to this endpoint | null |
data | An object that contains below parameters | Object |
txstatus | Status of the transfer
| Double |
payer | Transaction Type | String |
accountnumber | Account number of the wallet used for the transfer | Array |
amount | Recipient of the transfer | String |
value | Amount transfered | String |
transactionid | Moolre generated transaction ID | String |
externalref | This is the externalrefyou provided | String |
thirdpartyref | Transaction ID generated by the transfer network | String |
secret | A secret to help verify the source of the callback | String |
ts | Date and Time of the Transaction in EST | String |