Skip to main content
This is PayPal Goods & Services. Buyers pay with their PayPal balance or a card, and the payment carries PayPal’s buyer protection. For the Friends & Family variant, see PayPal Friends & Family. SellAuth offers two ways to connect. Pick one under Type when you create the method. PayPal Checkout uses the REST API and is the integration PayPal maintains going forward. Payments Standard is the legacy email-based (IPN) flow: quicker to set up, but no automatic recurring billing, local payment methods or card-only option.

PayPal Checkout

Before you start

You need a PayPal Business account. A Personal account can sign in to the developer dashboard, but PayPal only issues live API credentials to Business accounts.
  • Already have a Personal account? Upgrade it from your PayPal account settings (Upgrade to a Business account). The upgrade is free and keeps your balance, history and email. You can also open a separate Business account if you want shop income kept apart.
  • Finish PayPal’s account checks first. Confirm your email and complete any verification PayPal asks for (identity, linked bank account). Until you do, PayPal may hold incoming payments or limit the account, and SellAuth cannot release those payments for you.
  • New accounts can see payment holds. PayPal sometimes holds funds from a new seller for a few weeks. Your buyers still get their order: the hold only delays when the money reaches your PayPal balance.

Get your Client ID and Secret

The Client ID and Secret are API keys that let SellAuth create and capture PayPal payments on your account. They come from an “app” in the PayPal Developer Dashboard. Creating one takes a minute and costs nothing.
1

Open the PayPal Developer Dashboard

Go to developer.paypal.com and log in with your normal PayPal Business login. There is no separate developer account to create.
2

Switch the toggle to Live

The toggle sits at the top of Apps & Credentials and defaults to Sandbox. Sandbox is PayPal’s test environment with fake money, and its credentials do not work on SellAuth. If the page shows no Live option, the account is not a Business account yet.
3

Create an app

Click Create App, name it (for example “SellAuth”), choose the Merchant type and click Create App. You can also open the Default Application PayPal created for you, but a dedicated app keeps SellAuth’s settings separate from anything else you connect.
4

Copy the Client ID

The app page opens on its credentials. Copy the Client ID, a long string that usually starts with A.
5

Copy the Secret

Under Secret key 1, click Show (or the copy icon) and copy the full value. Make sure you copy the whole key with no leading or trailing spaces.
Treat the Secret like a password. Anyone with your Client ID and Secret can create payments and issue refunds on your PayPal account. Never paste it in a support ticket, screenshot or Discord message. If it leaks, generate a new secret in the app and delete the old one.

Connect it in SellAuth

1

Create the payment method

In your SellAuth dashboard, go to Payment Methods, add PayPal and set Type to PayPal Checkout.
2

Fill in the fields

  • PayPal E-mail: the email of the Business account that owns the app.
  • Client ID and Client Secret: the two values you copied.
3

Save

SellAuth connects to PayPal and registers a webhook in your app automatically (see below).
4

Make a test purchase

Buy a cheap product from your own shop with a different PayPal account or a card, check the order completes, then refund it from PayPal. This is the only reliable way to confirm everything works, because sandbox testing is not available.
On PayPal Checkout, payments always go to the PayPal account that owns the app, whatever you enter as the email. Double check you created the app while logged in to the account you want to be paid on.

What SellAuth sets up for you

When you save the method, SellAuth adds a webhook to your PayPal app. You can see it under Apps & Credentials > your app > Webhooks. PayPal uses it to tell SellAuth about:
  • completed payments, including buyers who close the tab before returning to your shop
  • subscription activations, renewals, failed renewals and cancellations
  • disputes and chargebacks, which then show up in SellAuth’s disputes page
You do not need to add or edit webhooks yourself. Do not delete the SellAuth webhook: orders where the buyer leaves early, subscription renewals and disputes stop syncing without it. If PayPal rejects the credentials when SellAuth creates the webhook, you get a PayPal Webhook Error notification in your dashboard. See Troubleshooting.

Changing credentials

To rotate the secret or move to a different app, paste the new values into the payment method and save. SellAuth registers a fresh webhook in the new app straight away. Once the new credentials work, you can delete the old secret, or the old app, in PayPal.

PayPal Checkout options

Only Card Payments restricts the PayPal checkout page to cards, hiding the PayPal account option. Useful when you want PayPal purely as a card processor. Enable Shipping Inputs asks the buyer for a shipping address during PayPal checkout. Turn it on if you sell physical goods and want PayPal’s address on the transaction record.

Apple Pay

PayPal Checkout can show an Apple Pay button above the PayPal buttons. The payment runs through your PayPal account like any other PayPal payment. Apple Pay through PayPal needs PayPal’s approval for Advanced Credit and Debit Card Payments on your account, and your business must be in a country where PayPal offers Apple Pay. If your app’s Features list has no Accept payments section with Advanced Credit and Debit Card Payments in it, PayPal has not approved your account yet. Contact PayPal to request it; SellAuth cannot enable it for you.
1

Turn on Apple Pay for your PayPal app

In the PayPal Developer Dashboard (Live), open Apps & Credentials and select the app you connected to SellAuth. Under Features > Accept payments > Advanced Credit and Debit Card Payments, tick Apple Pay and save.
2

Enable Apple Pay on the SellAuth payment method

Tick Enable Apple Pay on your PayPal payment method and save. The method then lists every domain your checkout runs on.
3

Register your domains in PayPal

Back in your PayPal app, select Manage in the Apple Pay section, then Add Domain. Enter each domain listed on the SellAuth payment method and select Register Domain. SellAuth already serves Apple’s verification file on these domains, so you do not need to upload anything.
PayPal does not let SellAuth register domains for you, so add a custom domain you connect later in PayPal as well.
A domain can only be verified for Apple Pay with one provider. If your Stripe payment method uses the Inline checkout form, Stripe keeps Apple Pay and the PayPal Apple Pay button stays hidden. To use Apple Pay through PayPal, disable Stripe or switch its checkout form to Redirect or Embedded. Both still offer Apple Pay on Stripe’s own page.
The Apple Pay button only appears in Safari and on Apple devices with a card in Apple Wallet. It covers one-time payments, so PayPal subscriptions keep using the PayPal buttons, and it does not appear inside a checkout embed on another site.

Google Pay

PayPal Checkout can also show a Google Pay button above the PayPal buttons. Unlike Apple Pay, it needs no domain verification, so it works alongside any Stripe checkout form.
1

Turn on Google Pay for your PayPal app

In the PayPal Developer Dashboard (Live), open Apps & Credentials, select the app you connected to SellAuth, and tick Google Pay under Features > Accept payments > Advanced Credit and Debit Card Payments. Like Apple Pay, the option only appears once PayPal has approved your account for Advanced Credit and Debit Card Payments. If PayPal asks you to finish onboarding for Google Pay, complete it in your PayPal account first.
2

Enable Google Pay on the SellAuth payment method

Tick Enable Google Pay on your PayPal payment method and save.
The Google Pay button appears in browsers where the buyer has Google Pay set up. Some cards ask the buyer to confirm the payment with their bank (3D Secure) after they pick the card. If that check fails, SellAuth does not charge the card and the buyer can try another card or pay with PayPal. Like Apple Pay, Google Pay covers one-time payments only.

PayPal Payments Standard

Enter your PayPal email in PayPal E-mail and save. That is the whole setup. Payments are confirmed through IPN, and subscriptions on this method renew by e-mail invoice rather than automatic charge.

Fees and limits

All shared method settings apply. PayPal also supports currency override, which bills the invoice in a currency you choose rather than your shop currency. Use it when your PayPal account settles in a specific currency.

Troubleshooting

“PayPal Webhook Error” notification after saving. PayPal rejected the Client ID or Secret. The usual causes are sandbox credentials, a secret copied only partly or with a space, or a Client ID and Secret from two different apps. Copy both again from the same app with the toggle on Live, paste them and save. If the notification says the webhook ID is invalid, clear both fields, save, then add them back and save again to make a new webhook. “PayPal Credentials Invalid” notification. PayPal refused the keys while charging an order, usually because the secret was deleted or regenerated in PayPal. Paste the current secret into the payment method and save. “PayPal Account Restricted” notification. PayPal has limited your account and refuses new payments. Resolve it in PayPal’s Resolution Center. SellAuth cannot lift the limit. An order says PayPal is still reviewing the payment. PayPal took the money but put it on hold, often because it arrived in a currency your account does not hold yet or because PayPal wants you to verify something. Log in to PayPal and accept the payment or finish the check. The order completes on its own once PayPal releases it. To avoid currency holds, add the currency to your PayPal balance, or set a currency override (see Fees and limits). Create App is missing, or there is no Live toggle, in the developer dashboard. The account is not a Business account. Upgrade it in PayPal or use Payments Standard instead. PayPal subscriptions renew by e-mail instead of charging automatically. Automatic recurring billing needs the PayPal Checkout type with a Client ID and Secret saved. Payments Standard renews by e-mail invoice instead. Local payment methods never appear. They are available on PayPal Checkout only, and PayPal decides which to show based on the buyer’s country and the transaction currency. The Apple Pay button never appears. Check that Enable Apple Pay is saved on the method, that Apple Pay is ticked in your PayPal app, that every domain listed on the method is registered under Apple Pay > Manage in PayPal, that your Stripe method does not use the Inline form, and that you are testing in Safari or on an Apple device with a card in Apple Wallet. The Google Pay button never appears. Check that Enable Google Pay is saved on the method, that Google Pay is ticked under Features in your PayPal app, and that the browser has Google Pay with a saved card. The Apple Pay sheet opens and then closes with an error. PayPal does not have the domain registered. Add it under Apple Pay > Manage in your PayPal app, as listed on the SellAuth payment method page, then try again. There is no Apple Pay or Google Pay option in my PayPal app. PayPal lists both under Features > Accept payments > Advanced Credit and Debit Card Payments, and only shows that section once it has approved your account for it. Ask PayPal to enable Advanced Credit and Debit Card Payments. The PayPal buttons and card payments keep working without it. PayPal cannot verify my domain. Open https://your-domain/.well-known/apple-developer-merchantid-domain-association in a browser. If it does not download a file, check that Enable Apple Pay is saved on the method, that the method is enabled, and that your Stripe method does not use the Inline form, since Stripe’s file is served instead in that case.

Next steps

PayPal Friends & Family

The F&F variant, its risks, and IPN setup.

Refunds and chargebacks

Recording a PayPal refund and responding to a dispute.