TriggerPayPalReal-timeUpdated May 2026
When does PayPal fire on refunds?
Short answer: Drop the "PayPal → PayPal Payment Refunded" trigger on your workflow canvas, add filters if you want them, and publish. It fires within seconds of the event in PayPal, 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
PayPal Payment Refunded
When the matching event happens
watch for payment refundedwhen a paypal payment is refundedon payment refundednew payment refundedwhen payment refunded
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": "refund_123","amount": {"value": "99.99","currency_code": "USD"},"status": "COMPLETED","create_time": "2026-04-11T10:00:00Z"}
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 | "refund_123" |
| amount | object | { … } |
| amount.value | string | "99.99" |
| amount.currency_code | string | "USD" |
| status | string | "COMPLETED" |
| create_time | string | "2026-04-11T10:00:00Z" |
Pairs with
Drop these actions after PayPal Payment Refunded.
FAQ
Questions about PayPal Payment Refunded.
How does the PayPal Payment Refunded trigger work in PayPal?
Fires when a refund is processed. For "revoke product access on refund", "update customer record", "log to refund tracking" workflows.
Is the PayPal Payment Refunded trigger real-time?
Yes. PayPal Payment Refunded uses webhooks or push subscriptions, not polling. Your workflow fires within seconds of the event happening in PayPal.
What data does PayPal Payment Refunded return?
The full event payload from PayPal. 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 PayPal Payment Refunded 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 PayPal admin permissions to use PayPal Payment Refunded?
For most PayPal accounts a standard user can authorize the trigger. Some PayPal plans require an admin to enable third-party webhooks. Check PayPal's docs if the trigger fails to register.
More triggers
Other PayPal triggers.
Trigger
PayPal Order Approved
Fires when the buyer approves an order (but before capture). For "buyer approved → trigger auto-capture" workflows.
TriggerPayPal Payment Completed
Fires when a payment is captured. Payload includes amount, currency, payer info. The revenue-event hook for fulfilment, accounting sync, customer-onboarding.
TriggerPayPal Subscription Cancelled
Fires when a PayPal recurring billing agreement cancels. For churn-tracking workflows and for revoking subscription access.
TriggerPayPal Subscription Created
Fires when a new subscription/billing agreement is created. For "auto-provision subscription access" customer-onboarding workflows.
Build a workflow on this trigger.
One trigger. 4+ downstream actions. Zero glue.
