Overview
Use this guide when a customer completed payment in Stripe but no matching order appears in PayPress.
Symptoms
- Stripe shows a successful payment.
- PayPress Orders does not show a new order.
- The success page says order details are still being finalized.
- Diagnostics may show webhook, ownership, or duplicate messages.
Likely Causes
- Webhook did not arrive.
- Webhook signature validation failed.
- The event was ignored as foreign because it belonged to another PayPress installation.
- The order is delayed because related webhook events are still processing.
- The payment was created manually in Stripe without PayPress ownership metadata.
Resolution Steps
- Confirm the payment exists in the same Stripe mode PayPress is using.
- Check PayPress Event Timeline for
checkout.session.completed. - If no webhook appears, troubleshoot webhook delivery.
- If the event says Foreign Event Ignored, review installation ownership.
- If the event processed but no order appears, check Diagnostics for database or duplicate-prevention entries.
- Refresh the Orders table after a few seconds.
- If testing a manually created Stripe subscription, confirm PayPress ownership metadata exists.
Expected Result
A valid PayPress-created payment should produce a local order after webhook processing finishes.
Additional Notes
PayPress creates orders from Stripe webhooks, not merely from the customer returning to the success page.