API updates
This section highlights the new releases and improvements for OneKhusa API11 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.successandpayrequest.reversedcollection 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
ResponseCodeproperty 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