# 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.

***

## Recommended Merchant Workflow

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.

***

## Recommended Best Practices

* 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.kwikpaisa.com/v3-guide/payout-integration/cancel-payout.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.