Every webhook notification on the OneKhusa platform has an associated event code that identifies the type of event that occurred. These event codes allow you to handle different transaction outcomes and batch processing events appropriately in your integration. The following are the supported webhook event codes:
Event CodeEvent NameEvent Description
batch.failedBatch Disbursements FailedTriggered when a batch disbursement processing has failed. This occurs when the entire batch cannot be processed due to system errors, insufficient funds, or other critical issues. Individual transactions within the batch are marked as failed and funds are refunded to the merchant account.
batch.receivedBatch Disbursements ReceivedTriggered when a batch disbursement file has been successfully received and accepted by the system. This confirms that the batch has passed initial validation checks and has been queued for processing. The batch will proceed through the approval workflow based on the merchant’s authorization level.
payment.reversedReversed Collection (Payment)Triggered when a previously successful payment collection has been reversed. This occurs due to disputes or other reversal requests. The funds that were collected are returned to the payer’s account.
payment.successSuccessful Collection (Payment)Triggered when a payment collection transaction has been completed successfully. This indicates that funds have been successfully collected from the payer and credited to the merchant account.
payout.failedFailed Disbursement (Payout)Triggered when a disbursement (payout) transaction has failed. This occurs when funds cannot be transferred to the beneficiary due to invalid account details, insufficient merchant balance, gateway errors, or beneficiary account issues. The transaction amount is automatically refunded to the merchant account.
payout.reversedReversed Disbursement (Payout)Triggered when a previously successful disbursement has been reversed. This occurs due to beneficiary disputes, compliance issues, or other reversal scenarios. The funds are returned to the merchant account and the transaction status is updated accordingly.
payout.successSuccessful Disbursement (Payout)Triggered when a disbursement (payout) transaction has been completed successfully. This indicates that funds have been successfully transferred from the merchant account to the beneficiary’s account. The transaction is finalized and cannot be modified.