For the complete documentation index, see llms.txt. This page is also available as Markdown.

Cancel Payout

The Cancel Payout feature allows merchants to stop or revoke payout transactions before they are processed successfully by the banking system.

This functionality is designed for:

  • Scheduled payouts

  • Queued transactions

  • Delayed settlement workflows

  • Bulk payout management systems

Currently, payout cancellation support is limited and available only for eligible payout states.


Current Availability

The Cancel Payout feature is currently under development and may not be available for all merchants or payout modes.

At present:

  • Instant payouts generally cannot be cancelled once initiated

  • Successfully processed payouts cannot be reversed using this API

  • Only queued or scheduled payouts may support cancellation

Availability depends on:

  • Transfer mode

  • Banking partner

  • Processing stage

  • Merchant configuration


When Payouts Can Be Cancelled

Payouts may be cancellable only when they are:

Status
Cancellation Support

QUEUED

Supported

SCHEDULED

Supported

PROCESSING

Limited support

SUCCESS

Not supported

FAILED

Not required

REVERSED

Not supported


Queued Payout Cancellation

Queued payouts are transactions that are accepted by the system but not yet processed by banking infrastructure.

These transactions may be cancelled before:

  • Bank submission

  • Settlement processing

  • Fund debit confirmation

Cancellation success depends on whether the payout has already entered the bank processing pipeline.


Scheduled Payout Cancellation

Scheduled payouts are future-dated payout instructions configured for execution at a later date or time.

These payouts can generally be:

  • Cancelled

  • Modified

  • Rescheduled

before the scheduled execution window begins.

Scheduled payout support is useful for:

  • Salary disbursement systems

  • Vendor settlement scheduling

  • Subscription payouts

  • Bulk settlement operations


Instant Payout Limitations

Most real-time payout modes such as:

  • IMPS

  • UPI

  • RTGS (post-processing)

  • Instant bank transfers

are processed immediately after initiation.

Once a payout enters active banking rails:

  • Cancellation may no longer be possible

  • Funds may already be debited

  • Bank processing may already be completed

For this reason, instant payout cancellation is generally not supported.


Before initiating payouts:

  1. Validate beneficiary details

  2. Verify payout amount

  3. Check wallet balance

  4. Validate duplicate payout IDs

  5. Confirm transfer mode carefully

After payout initiation:

  1. Track payout status

  2. Monitor processing state

  3. Attempt cancellation only for eligible payouts

  4. Verify final payout outcome using Payout Status API


Important Notes

  • Payout cancellation is not guaranteed

  • Successful cancellation depends on payout state

  • Processed payouts cannot be reversed automatically

  • Merchants should validate transactions carefully before initiation

  • Some banking partners may not support payout cancellation


Future Enhancements

KwikPaisa is actively working on:

  • Scheduled payout management

  • Advanced payout queue controls

  • Bulk payout cancellation

  • Payout pause/resume workflows

  • Real-time payout orchestration controls

These features will be introduced gradually based on infrastructure and banking partner support.


  • Use scheduled payouts for large settlement operations

  • Avoid initiating duplicate payout requests

  • Implement internal payout approval workflows

  • Verify beneficiary details before payout execution

  • Monitor payout statuses continuously


Security & Compliance Notes

For security and regulatory reasons:

  • Completed payouts cannot be forcefully reversed

  • Banking settlements are governed by partner bank rules

  • Certain payout modes may have irreversible processing behavior

Merchants are responsible for validating:

  • Beneficiary details

  • Transfer amounts

  • Transaction references

  • Approval workflows

before initiating payouts.


Need Help?

If you require:

  • Scheduled payout enablement

  • Queue management support

  • Bulk payout orchestration

  • Advanced payout controls

please contact the KwikPaisa integration and onboarding team.

Last updated