> ## Documentation Index
> Fetch the complete documentation index at: https://docs.komerza.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup PayPal Business

> Accept PayPal checkout payments with Smart Buttons or Links and Buttons

Accept payments through your own PayPal account with PayPal's standard checkout. Buyers pay you directly - Komerza never holds the funds.

There are two integrations to choose from:

| | Smart Buttons | Links and Buttons |
| - | - | - |
| PayPal account | A **verified Business** account | Any PayPal account |
| What you enter | Client ID and secret from the PayPal Developer Dashboard | Your PayPal email address |
| Refunds from Komerza | Supported | Not supported |
| How payments are confirmed | PayPal webhooks, set up automatically | IPN, through your [PayPal IPN relay](/guides/paypal-ipn-relay) |

<Note>
  Taking personal payments instead? See [Setup PayPal F\&F](/guides/paypal-ff-setup).
</Note>

## Prerequisites

* A PayPal account. For **Smart Buttons**, it must be a verified **Business** account.
* For **Links and Buttons**, a free **Cloudflare account** for your IPN relay.

## Connect PayPal

<Steps>
  <Step title="Open Payment Methods">
    In your dashboard, open **Settings** under **Online Store**, then go to **Payment Methods**. Find **PayPal** and click **Connect** (or **Configure** if it's already set up).
  </Step>

  <Step title="Choose an integration type">
    In the **Configure PayPal** dialog, pick **Smart Buttons** or **Links and Buttons**, then follow the matching section below.
  </Step>
</Steps>

## Option A - Smart Buttons

<Steps>
  <Step title="Get your API credentials">
    Open the [PayPal Developer Dashboard](https://developer.paypal.com/developer/applications) and sign in with your PayPal Business account. Open your app under **Apps & Credentials** (or create one), make sure you're looking at **Live** credentials, and copy its **Client ID** and **Secret**.
  </Step>

  <Step title="Enter them in Komerza">
    Paste them into **Client ID** and **Client secret**.

    Optionally, tick **Force credit/debit card payments only**. Buyers then pay by card through PayPal and don't get the option to log in to a PayPal account.

    <Warning>
      Smart Buttons needs a **verified Business** PayPal account. Personal accounts can't use the systems this integration relies on - choose **Links and Buttons** instead.
    </Warning>
  </Step>

  <Step title="Save">
    Click **Save changes**. Komerza registers the webhook it needs on your PayPal app automatically - there's nothing to set up in PayPal.
  </Step>
</Steps>

## Option B - Links and Buttons

<Steps>
  <Step title="Enter your PayPal email">
    Enter the **PayPal email address** associated with your PayPal account.
  </Step>

  <Step title="Set up your IPN relay">
    Links and Buttons payments are confirmed by PayPal's IPN, through a private relay in your own Cloudflare account. Under **Payment confirmation**, click **Connect Cloudflare** and approve Komerza. Komerza saves your PayPal settings first, then sets up the relay.

    There's nothing to change in PayPal - Komerza sends your relay's address with every payment.

    <Note>
      Links and Buttons stays **hidden from checkout** until your relay is live. See [PayPal IPN Relay](/guides/paypal-ipn-relay) for the full walkthrough.
    </Note>
  </Step>

  <Step title="Save">
    If your relay was already live, click **Save changes**.
  </Step>
</Steps>

## Test the integration

Make a **\$1 test payment** on your store with PayPal to confirm the order is marked as paid.

You can review your PayPal setup at any time under **Settings → PayPal**: it shows which integration you're using, how its payments are confirmed, and your IPN relay.

## Troubleshooting

| Problem | Fix |
| - | - |
| PayPal isn't showing at checkout | On **Links and Buttons**, PayPal stays hidden until your [IPN relay](/guides/paypal-ipn-relay) is live. On **Smart Buttons**, check your Client ID and secret are the **Live** ones. |
| Smart Buttons won't save | Check the Client ID and secret, and that your PayPal account is a verified **Business** account. |
| Payments aren't being marked as paid | On **Links and Buttons**, check your relay's status and **Last notification** under **Settings → PayPal → IPN relay**. |
| I need to refund a Links and Buttons payment | Refund it from your PayPal account. Links and Buttons doesn't support refunds from Komerza. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.