Overview
Refund webhooks are how Stripe tells PayPress that a refund was created, updated, succeeded, or failed. PayPress relies on these events to keep local order status synchronized.
Requirements
- Stripe webhook configured.
- Refund-related events enabled.
- A refund request or refund event in Stripe.
Steps
- Submit a refund from PayPress or Stripe.
- Stripe sends refund-related webhook events.
- PayPress verifies and processes the events.
- PayPress updates the local order refund totals and status.
- Review Diagnostics for refund processing entries.
Expected Result
Local order status and refunded amount update after Stripe sends the appropriate refund events.
Important Notes
PayPress intentionally waits for webhooks instead of manually forcing final refund status immediately. This keeps Stripe as the source of truth.
Troubleshooting
If refund status does not update, check webhook delivery. If the refund was made directly in Stripe, PayPress still needs the related webhook events. If an event is ignored as foreign, confirm installation ownership.