This applies to scenarios where end users are making:
Utility bill payments
Airtime purchases
Steps - Airtime Purchase
1
Initiate Airtime Purchase Request
Call endpoint /utilityPayment/v2/airtimePayment to initiate an airtime purchase request
Status: 1-Waiting
2
Confirm OTP
Call endpoint /common/sendOtp to request for OTP, filling the value of paymentId to businessId parameter. Call endpoint /common/confirmOperation to confirm the OTP code received.
Status: 2-PROCESSING
The endpoint /common/sendOtp can also be used to resend OTP.
3
Payment Processing
Status: 2-PROCESSING
4
Get Payment Result
Get it from 0007 - Utility Payment Result Notification
Query transaction status by calling the endpoint /utilityPayment/paymentQuery
Steps - Bulk Airtime Purchase
1
Initiate Bulk Airtime Purchase Request
Call endpoint /utilityPayment/v2/airtimeBulkPayment to initiate an airtime purchase request
Status: 1-Waiting
2
Confirm OTP
Call endpoint /common/sendOtp to request for OTP, filling the value of bulkPaymentOrderId to businessId parameter. Call endpoint /common/confirmOperation to confirm the OTP code received.
Status: 2-PROCESSING
The endpoint /common/sendOtp can also be used to resend OTP.
3
Payment Processing
Status: 2-PROCESSING
4
Get Payment Result
Get it from 0014 - Bulk Airtime Purchase Notification
Query transaction status by calling the endpoint /utilityPayment/bulkPaymentQuery
Steps - Utility Bill
1
Query Utility Bill Due Information
Call endpoint /utilityPayment/billQuery to initiate an airtime purchase request
2
Initiate Utility Bill Payment Request
Call endpoint /utilityPayment/v2/billPayment to initiate an airtime purchase request
Status: 1-Waiting
3
Confirm OTP
Call endpoint /common/sendOtp to request for OTP, filling the value of paymentId to businessId parameter. Call endpoint /common/confirmOperation to confirm the OTP code received.
Status: 2-PROCESSING
The endpoint /common/sendOtp can also be used to resend OTP.
4
Payment Processing
Status: 2-PROCESSING
5
Get Payment Result
Get it from 0007 - Utility Payment Result Notification
Query transaction status by calling the endpoint /utilityPayment/paymentQuery
