PayPal
Walley Checkout supports PayPal as a redirect-based payment method for private customers. The customer approves the payment in PayPal and then returns to Walley Checkout while the result is confirmed.
Availability
| Property | Value |
|---|---|
| Customer type | Private customers (B2C) |
| Checkout flow | One-time purchases |
| Markets | All markets where Walley Checkout is available. PayPal is enabled by default for new merchants in Germany and the Netherlands. Contact Walley Merchant Services to activate it in other markets. |
| Currency | The currency configured for the selected store and market |
| Minimum amount | 0.01 in the checkout currency, with a maximum of two decimal places |
PayPal appears in the checkout only when it is enabled in the selected settings profile and the store has completed PayPal onboarding. It is not available for business customers, tokenized payments, or subscriptions.
Prerequisites
Before PayPal can be activated for your store, you need:
- A PayPal Business account onboarded through Walley's PayPal partner setup.
- A PayPal merchant payer ID registered on your Walley store.
- PayPal enabled in the settings profile used by the store.
The merchant payer ID is store configuration. Do not include it in Checkout API requests or expose it in client-side code.
How to get started
- Contact Walley Merchant Services to confirm that PayPal is included in your agreement and available for your market.
- Complete the PayPal merchant onboarding coordinated by Walley.
- Provide the resulting PayPal merchant payer ID through the agreed onboarding channel.
- Ask Merchant Services to configure PayPal for your test and production stores and settings profiles.
- Complete a test purchase and verify the result through the standard Checkout notification flow before going live.
Integrate PayPal
PayPal uses the standard Walley Checkout integration and requires no
PayPal-specific API properties. Once PayPal is enabled, initialize and render
Checkout as usual. Select the configured B2C store, use a unique reference
for each checkout, and provide an HTTPS notificationUri for completed
purchases. Walley Checkout manages the customer journey to and from PayPal.
See Initialize checkout for a minimal request and Advanced initialization for the complete request model.
Payment flow
- The customer selects PayPal in the Walley Checkout iframe.
- The customer is sent to PayPal to log in and approve the payment.
- The customer returns to Walley Checkout.
- When the purchase is complete, Walley calls your
notificationUri. - Retrieve the checkout and create or update the order in your system.
Treat the purchase notification as the reliable completion signal. Do not use the browser redirect as proof of payment.
After the notification, retrieve the checkout
and confirm that data.status is PurchaseCompleted. The
data.purchase.paymentName value is PayPal.
Cancellations and pending payments
If the customer cancels or leaves the PayPal approval flow, Walley Checkout cancels the active attempt. Do not create an order based on the browser return or cancellation page. Retrieve the checkout when you need to determine its current status.
Captures and refunds
Manage a completed PayPal order through Walley's standard order flow:
- Use Capture order when you deliver the goods or service.
- Use Refund order for full or partial refunds.
Do not capture or refund the transaction directly in the PayPal dashboard. Performing post-purchase operations through Walley keeps the Walley order and the PayPal transaction synchronized.