PayPal Integration

PayPal is an alternative payment method offered alongside Stripe at checkout.

Setup

1. Create a PayPal business account at paypal.com (opens in a new tab)
2. Go to developer.paypal.com (opens in a new tab) → create a REST API app
3. In admin → Settings → Payment:
   • Enter client ID from your app
   • Enter client secret
   • Toggle Sandbox mode for testing
4. Configure webhook in PayPal developer console:
   • Endpoint: https://your-domain.com/commerce-api/v1/webhooks/paypal
   • Subscribe to: PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.REFUNDED

Supported features

• Checkout payments — customer pays via PayPal
• PayPal Credit / Pay in 4 — surfaced automatically when eligible
• Refunds — triggered from return processing

Flow

1. Customer picks PayPal at checkout
2. Frontend opens PayPal approval popup
3. Customer approves in PayPal
4. On return, POST /payment/paypal/capture completes the order
5. Webhook confirms capture

Sandbox

Use sandbox credentials with PayPal sandbox accounts (opens in a new tab). Test buyer accounts let you simulate the full flow without real money.

Related features

• Stripe
• Cart & Checkout