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.
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
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.
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.
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. Openhttps://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.