Page

Payment gateways

Manual payments, Stripe, PayPal, Square, sandbox testing, webhooks, and failure reasons.

Available checkout methods

• Manual payment lets an order be placed without an online gateway. Use it for invoices, pay-by-phone, local pickup, or early testing.
• Stripe uses a secure embedded card form that stays on the checkout page. Stripe can mark orders paid through the success return or webhook.
• PayPal approval starts from the checkout page and captures the payment when the customer returns successfully.
• Square uses a secure embedded card form that stays on the checkout page.

Sandbox before live

• Test gateway credentials in sandbox or test mode before entering live credentials.
• Place one successful order, one cancelled order, and one failed payment if the processor gives you test cards or test accounts for failure cases.
• Payment failure messages can include the reason returned by Stripe, PayPal, or Square, such as invalid credentials, declined card, or API validation details.

Stripe webhook

• The Stripe webhook endpoint is /payments/stripe/webhook.
• A webhook helps mark orders paid even if the customer closes the browser before returning to the store.
• Save the Stripe webhook signing secret in Payment Settings so webhook requests can be verified.