What you need
| Field | What it does |
|---|---|
| Client ID | Identifies your PayPal app on API calls. Paired with the secret. |
| Client secret | The secret half of API auth. With the Client ID, it creates the order. Secret. |
| Webhook ID | Identifies the webhook PayPal signs, so we can verify each delivery. |
| Success URL / Cancel URL | Where the buyer lands after paying or backing out. |
Why we ask for each field
Client ID
Identifies your PayPal app on API calls. It works only when paired with the Client secret.
Client secret
The private half of API auth. With the Client ID, it lets us create the order, so the payment runs through your account.
Webhook ID
How we confirm a webhook is genuinely from PayPal: PayPal identifies each webhook by an ID, and we use it to ask PayPal directly whether a given message is authentic. That stops anyone from forging a "paid" event.
Success and Cancel URL
Plain settings: where the buyer lands after paying or backing out. Not secret.
Set up
- Open the PayPal Developer dashboard
Sign in at developer.paypal.com. PayPal gives you a free Sandbox with fake business and buyer accounts, so you can test without moving real money. This guide walks the Sandbox; the Live flow is identical, just flip the Sandbox / Live toggle (top left) and use a PayPal for Business account. From the dashboard, open Apps & Credentials.
PayPal Developer → Apps & Credentials - Create an app
On the API Credentials page, confirm the Sandbox toggle is selected, then click Create App (top right).
PayPal → Apps & Credentials → Create App - Name it and choose Merchant
Enter an App Name (for example "Coin Moebius"), leave the Type on Merchant, pick your sandbox business account, and click Create App.
PayPal → Create App - Copy your Client ID and Client secret
PayPal opens your new app. Copy the Client ID and reveal and copy the Secret key. (You can also copy both from the Default Application row on the API Credentials list.) Set them aside.
1. PayPal → API Credentials → your app in the list 2. PayPal → your app → Client ID and Secret The Client secret is secret, treat it like a password. The sandbox app and live app each have their own pair, so do not mix them.
- Add a webhook
Scroll down the app page to the Sandbox Webhooks section and click Add Webhook. In the Webhook URL field, paste your store’s PayPal webhook address (below). Then choose the events Coin Moebius listens for, and Save.
- One-time payments: CHECKOUT.ORDER.APPROVED, PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.DENIED, PAYMENT.CAPTURE.DECLINED, PAYMENT.CAPTURE.REFUNDED, PAYMENT.CAPTURE.REVERSED, CUSTOMER.DISPUTE.CREATED.
- Subscriptions (only if you sell them): BILLING.SUBSCRIPTION.ACTIVATED, BILLING.SUBSCRIPTION.UPDATED, BILLING.SUBSCRIPTION.CANCELLED, BILLING.SUBSCRIPTION.PAYMENT.FAILED, PAYMENT.SALE.COMPLETED. If you are not billing on a recurring basis, skip these.
- In a hurry? Selecting All Events (the wildcard at the top) also works, we ignore anything we do not use.
https://api.coinmoebius.com/webhook/paypal/<your store id>PayPal → your app → Add webhook Your Store id is on the Store settings page in the Coin Moebius dashboard; drop it into the address above. Once PayPal is connected, its card’s ⋯ menu has Copy webhook URL for the same address.
- Copy the Webhook ID
Your webhook now appears in the Sandbox Webhooks list. Copy the Webhook ID shown next to it. This is how Coin Moebius asks PayPal to confirm each webhook is genuine. Register a separate webhook in sandbox and in live.
PayPal → your app → Sandbox Webhooks → Webhook ID - Back in Coin Moebius: Connect a provider → PayPal
Open Providers in the left menu and click Connect a provider. Type PayPal in the search box, or scroll down to it, and click it. Set your Success URL and Cancel URL. Testing with sandbox credentials? Use the Test (optional) tab and paste your Client ID, Client secret, and Webhook ID there, then click Save. Going straight to live? Use the Live tab. The Test tab is all-or-nothing: all three fields, or none.
Coin Moebius → Connect a provider → PayPal - You are connected
PayPal now appears on your Providers page (marked Test when you used sandbox credentials). Its ⋯ menu has Edit connection, Copy webhook URL and Disconnect.
Coin Moebius → Providers → PayPal (connected) - Test with a sandbox buyer
To pay through a test checkout, you need your sandbox buyer login. In PayPal, open Testing Tools → Sandbox Accounts to see your fake Business and Personal accounts.
PayPal → Testing Tools → Sandbox Accounts - Get the buyer login details
Open the Personal (buyer) account to view its Login Info: the sandbox URL, email, and password. Sign in at sandbox.paypal.com with those when a test checkout asks you to pay. No real money moves.
PayPal → Sandbox account → Login Info
After you connect
Run one test payment before going live:
- Create a product and set its Environment to Test. That runs the product on your sandbox credentials, so you can place a full order without moving money. (A Test product only runs on sandbox credentials, so add them first.)
- Place the buy button on a page (a local HTML file works) pointed at your store.
- Complete checkout by paying with your sandbox buyer account.
- Open Transactions in your store and turn on Show test payments. A new row appears, marked Test. When its status reads Paid, your credentials and webhook are both working end to end.
Switch the product Environment to Live when you are ready for real payments.
Troubleshooting
Start with Verify. In the dashboard, click Verify (or Verify test credentials for sandbox) to check your client credentials.
Verify fails.
Re-copy the Client ID and Client secret. The sandbox app and live app have different pairs, so do not mix them.
Payment completes but the order stays pending.
The Webhook ID must come from the same app and environment as your client credentials. Live credentials need the live webhook ID. Confirm the webhook URL matches.
Confirm it end to end.
PayPal Developer Dashboard → Webhooks Simulator: send a sample event to your webhook URL, then watch the order update.
Good to know
Rotating secrets. Generate a new client secret anytime, then paste it in. Saved secrets stay hidden. To change one, choose Replace and enter the new value.
Questions? Join our Discord