​
Status Overview

StatusDescription
SUCCESSReceived payment that has not been settled to the merchant account yet.
SETTLEDFunds are already settled to the merchant account.
PROCESSINGPayment is currently being processed.
PENDINGPayment is pending and awaiting further action from the customer.
FAILEDPayment was not successful.
ON-HOLDPayment is on hold and requires further action from the merchant.
REFUNDEDPayment was not settled to merchant account and funds returned to the customer
REVERSEDPayment was settled to merchant account and then funds were returned to the customer

​
Payment Status in the ClickPesa Dashboard

  • You can view the payment status in the ClickPesa Dashboard under the Transactions section.
  • The payment statuses are updated in real-time as the payment progresses through different stages.

​
Payment Status In Your Application

There are two ways to receive payment statuses in your application:

  1. Webhooks - ClickPesa sends real-time updates to your server when a payment status changes. You can use webhooks to receive these updates.
  2. Querying - Alternatively, you can make API calls periodically to Payment API query payment endpoint.

​
Payment Status for Customers

  • In both Hosted and Embedded Checkouts, payment status is displayed to the customer in real-time.
  • Additionally, the final payment notificationSuccessfully made payment is sent to the customer via their registered email or mobile phone number.