Utility Payment

Scope

This applies to scenarios where end users are making:

1. Utility bill payments

2. 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

Status