Kernlift

PayPal

Accept payments with PayPal.

  • Checkout Orders, one-time payments only
  • Subscriptions No
  • Portal No
  • Refunds No

Before you begin

A public HTTPS site, an active plan on /admin/plans, and access to the merchant dashboard.

Expected result — an order reconciled with a signed payment notification.

Set up PayPal

Create a sandbox app

Open PayPal. Create a REST app under Apps & Credentials → Sandbox.

Copy the app credentials

Open the app and copy its Client ID and secret.

Subscribe to order events

Add your HTTPS endpoint ending in /api/billing/webhook/paypal under Webhooks. Select CHECKOUT.ORDER.APPROVED, CHECKOUT.ORDER.COMPLETED and CHECKOUT.ORDER.VOIDED.

Copy the Webhook ID

Open the saved endpoint and copy its Webhook ID.

Provider documentation · REST app setup · webhook subscription

Configure the application

Open /admin/config/payment in the Kernlift admin console. Select PayPal. Enter your public Success URL and Cancel URL, then set API base URL to https://api-m.sandbox.paypal.com.

Value from providerAdmin field
Client IDClient ID
SecretClient secret
Webhook IDWebhook ID

Enable the provider and click Save provider.

Webhook ID

Use the endpoint ID from the same REST app and mode as the client credentials.
Kernlift settings for PayPal

Verify

  1. Buy a plan on /pricing as a sandbox buyer.
  2. Check the signed event on /admin/billing-webhooks.
  3. Find the same order on /admin/orders and confirm it is paid.

Go live

Create live credentials and register the production webhook in the live account. Save its verification value with the matching credentials and https://api-m.paypal.com.

Troubleshooting

Webhooks fail the signature check

Confirm the saved Webhook ID belongs to this REST app and environment. PayPal verifies events with that ID and the app credentials.

Next steps

Connect a payment provider