API updates
This section highlights the new releases and improvements for OneKhusa API
11 January 2026
Accept Payments
-
Added request-to-pay feature to enable merchants to associate/link their generated transactions on checkout with OneKhusa so that the customer can finalised the transaction using bank/MNO digital channel.
-
Added a fake accept request-to-pay transaction feature to simulate as if the customer is paying using bank/MNO digital channel such as internet banking, mobile banking etc. Refer to Simulate Accept Request To Pay section.
Webhooks
-
Added
payrequest.success and payrequest.reversed collection events to support request-to-pay transactions under webhook events .
-
Added a section for single disbursement events on how its handled in OneKhusa under webhook events.
-
Added
ResponseCode property under payment success and payment reversed payloads for collection webhooks .
-
Added payloads for request to pay success and request to pay reversed under collection webhooks .
-
Added new webhook events to support single disbursement transactions single disbursement transactions i.e. payout.success, payout.failed and payout.reversed.
-
Added verify webhook endpoint for verifying the authenticity of received webhook notifications.
Authentication Approach
- Added OAuth 2.0 content to add more meaningful context towards OneKhusa authentication approach for consuming API endpoints.
Idempotency
-
Added idempotency feature to avoid processing the same payment API request more than once on OneKhusa platform. The affected endpoints are as follows:
Batch disbursements
- Upload Batch File
- Upload Batch JSON
- Approve Batch
- Review Batch
- Cancel Batch
- Reject Batch
- Transfer Funds
Single disbursements
- Add Single Transaction
- Approve Single Transaction
- Review Single Transaction
- Reject Transaction
Collections
- Request To Pay
- Simulate Accept Request To Pay
