TriggerRazorPayReal-timeUpdated May 2026
When does RazorPay fire on failed payments?
Short answer: Drop the "RazorPay → RazorPay Payment Failed" trigger on your workflow canvas, add filters if you want them, and publish. It fires within seconds of the event in RazorPay, not on a polling schedule.
Anatomy
What this trigger looks like in a workflow.
Drop it on the canvas. Configure a couple of fields. Publish.
In the builder
Trigger
RazorPay Payment Failed
When the matching event happens
when payment failspayment failedpayment failureon payment failedwatch for failed paymentpayment declinedwhen payment is rejected
What this trigger returns
for the curiousYou don’t need to read this. Tiny Command auto-maps every field into the visual picker so downstream nodes can pull values by clicking. We show it here for power users who want to know what’s on the wire.
{"id": "pay_fail123def456","email": "customer@example.com","amount": 30000,"method": "card","status": "failed","currency": "INR","error_description": "Payment was declined by the bank"}
Output shape
Fields available to downstream nodes.
Every field below can be referenced by name in any action or filter that comes after this trigger.
| Field | Type | Example |
|---|---|---|
| id | string | "pay_fail123def456" |
| string | "customer@example.com" | |
| amount | number | 30000 |
| method | string | "card" |
| status | string | "failed" |
| currency | string | "INR" |
| error_description | string | "Payment was declined by the bank" |
Pairs with
Drop these actions after RazorPay Payment Failed.
FAQ
Questions about RazorPay Payment Failed.
How does the RazorPay Payment Failed trigger work in RazorPay?
Fires when a payment fails. Payload includes reason code and human-readable message. For dunning workflows that branch on failure reason (soft decline → retry email, hard decline → payment-method update prompt).
Is the RazorPay Payment Failed trigger real-time?
Yes. RazorPay Payment Failed uses webhooks or push subscriptions, not polling. Your workflow fires within seconds of the event happening in RazorPay.
What data does RazorPay Payment Failed return?
The full event payload from RazorPay. The output shape table on this page lists every field, its type, and an example value so you can map fields into downstream nodes.
Can I filter RazorPay Payment Failed so only some events start a workflow?
Yes. Add a Filter node right after the trigger and match on any field, whether that's subject, sender, status, or anything else in the payload. Workflows only continue when the filter passes.
Do I need RazorPay admin permissions to use RazorPay Payment Failed?
For most RazorPay accounts a standard user can authorize the trigger. Some RazorPay plans require an admin to enable third-party webhooks. Check RazorPay's docs if the trigger fails to register.
More triggers
Other RazorPay triggers.
Trigger
RazorPay Payment Captured
Fires when a payment auth-and-captures successfully. Payload includes amount, method (UPI/card/netbanking), customer, notes. The revenue-event hook for India-focused commerce workflows.
TriggerRazorPay Refund Processed
Fires when a refund clears (UPI is sub-minute, cards can take days). For "refund processed → revoke product access, update customer record, log to refund tracking" workflows.
Build a workflow on this trigger.
One trigger. 4+ downstream actions. Zero glue.
