Skip to main content
v2026-01-01 introduces a controlled payment flow for UPI mandate subscriptions, giving you explicit control over when your customers are notified and when the debit is executed. This is a significant change if you need to comply with NPCI pre-debit notification rules.
The controlled flow supports UPI mandates only. eNACH and Physical NACH (PNACH) mandates are not supported. Card support is planned for a future release.

​
How it works

The controlled flow replaces the automatic charge trigger with a two-step process you drive:
  1. Send a pre-debit notification: Notify your customer of the upcoming charge amount before the debit window opens.
  2. Execute the charge: Trigger the mandate debit after the compliance window elapses. The debit amount must exactly match the notified amount; a mismatch causes the issuing bank to decline the transaction.
Controlled charging is a two-step flow in which you send the pre-debit notification and trigger the debit. Cashfree does not automatically retry a failed attempt. You must trigger each attempt yourself.

​
API endpoints

The following endpoints support the controlled notification and execution flow: NPCI enforces blackout windows during which attempts are rejected. When this happens, the error response tells you the next permitted timestamp. Use it rather than retrying blindly.

​
Webhooks

Subscribe to both events rather than polling:
  • SUBSCRIPTION_PAYMENT_CONTROLLED_NOTIFICATION_STATUS: A notification attempt reached a terminal state.
  • SUBSCRIPTION_PAYMENT_CONTROLLED_EXECUTION_STATUS: A charge attempt reached a terminal state.