Payments and checkout

Connect PayPal

Paste your PayPal app's client ID and secret under Kufi → Commerce → Settings → Payments → PayPal, choose Sandbox or Live, and click Save and connect. The store checks the keys and sets up PayPal events for renewals, refunds and cancellations.

Get your keys

  1. Sign in at developer.paypal.com with your PayPal business account.
  2. Open Apps & Credentials. Use the Sandbox tab for test keys and Live for real ones.
  3. Open your app (or create one) and copy the Client ID and the Secret.

Connect the store

  1. Go to Kufi → Commerce → Settings → Payments and open PayPal.
  2. Choose Sandbox (test payments) or Live (real payments). Sandbox and live keys are kept separately, so you can switch back and forth.
  3. Paste the Client ID and Secret, then click Save and connect.

The store checks the keys and, on an https site, finds or creates the PayPal webhook for you. "Connected to PayPal. Payments, renewals and refunds reach the store." means you're done.

The secret is stored encrypted and never shown again. To change it, paste a new one.

If PayPal events aren't set up

"PayPal events are not set up yet" means the store couldn't create the webhook, usually because the site isn't on https yet or PayPal couldn't reach it. Payments at checkout still work, but renewals, refunds and cancellations made at PayPal won't reach the store. Fix the cause and click Save and connect again. See Payments or renewals don't show up.

Keys in wp-config.php instead

If you'd rather keep the keys out of the database, add them to wp-config.php:

define( 'KUFI_COMMERCE_PAYPAL_CLIENT_ID', 'your client id' );
define( 'KUFI_COMMERCE_PAYPAL_SECRET', 'your secret' );
define( 'KUFI_COMMERCE_PAYPAL_WEBHOOK_ID', 'your webhook id' );
define( 'KUFI_COMMERCE_PAYPAL_LIVE', true );

Use false for KUFI_COMMERCE_PAYPAL_LIVE to test in the sandbox. For the webhook ID, add a webhook at developer.paypal.com for the address shown on the PayPal settings page, with all events, and copy its ID. These settings win over the page, which then shows them locked.

Currencies

PayPal only accepts its own list of currencies. The currency list under Kufi → Commerce → Settings → General shows PayPal's currencies first; the others work with bank transfer, cash on delivery and custom gateways.

More in Payments and checkout

Still need help?

Tell us what you are trying to do and what you see. We read every message.