Initiate One-Time Payment
Last updated March 3rd, 2025
post api.withmono.com/v2/payments/initiateThis resource is to initiate a one-time payment. To initiate a one-time payment, an amount, type, reference etc can be populated on the Initiate endpoint. Once this is provided, a payment link is generated, which your customers can open in their browsers or mobile app in form of a web view.
A more detailed guide on using this resource can be found here.
Please ensure to verify the payment status via the verify payment endpoint before proceeding to give value for the payment.
Split Payments
You can seamlessly allocate or split payments into multiple accounts in a single transaction by passing a split object in your body request.
We also provide flexibility in setting up both percentage-based and fixed-amount splits. To know more, please refer to this guide here.
Request
curl --request POST \
--url https://api.withmono.com/v2/payments/initiate \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'mono-sec-key: string' \
--data '{
"amount": 20000,
"type": "onetime-debit",
"method": "account" //transfer,
"account": "678f7bc977eb9afb06fff11f",
"description": "testing",
"reference": "testing10039819098",
"redirect_url": "https://mono.co",
"customer": {
"email": "samuel@neem.com",
"phone": "08122334455",
"address": "home address",
"identity": {
"type": "bvn",
"number": "22110033445"
},
"name": "Samuel Olamide"
},
"meta": {}
}
'
Response
Choose an option from the drop down or click one of these buttons to see an example: