Overview
PayPress sends customers to Stripe Checkout to complete payment securely. Stripe Checkout handles card entry, supported payment methods, authentication, and payment confirmation. PayPress then uses Stripe webhooks to create or update the local WordPress order.
Requirements
- Stripe API keys saved in PayPress.
- Webhook configured.
- Active PayPress plan.
- Payment page with a PayPress shortcode.
Steps
- Customer views a PayPress payment offer on your site.
- Customer clicks the payment button.
- PayPress validates the plan and request.
- PayPress creates a Stripe Checkout Session.
- Customer pays on Stripe Checkout.
- Stripe sends webhook events to PayPress.
- PayPress creates or updates the local order.
- Customer returns to the success page.
Expected Result
The customer experiences a secure Stripe-hosted checkout. The merchant sees the completed order in WordPress after Stripe webhook processing finishes.
Important Notes
The page that displays the PayPress offer can usually remain cacheable. Checkout initiation happens through PayPress launcher behavior and is validated server-side. The success page and webhook endpoint should not be cached.
Troubleshooting
If Checkout does not open, confirm the plan is active and configured. If the customer pays but WordPress does not show the order, the webhook is the first place to check. If a customer returns to the payment page using the browser Back button, the payment button should reset so a new attempt can be started.