Appearance
Accept payments with PayPal
Customers can pay with PayPal on your payment links (/pay) and on your booking page (/book). The money goes straight to your PayPal account — cobodrive never holds it.
What you need
- A PayPal Business account. Live credentials only exist on Business accounts.
- Access to developer.paypal.com with that account.
1. Create the app and copy the credentials
- At developer.paypal.com › Apps & Credentials, choose Sandbox (testing, no real money) or Live (real payments).
- Open an app (or create one) and copy the Client ID and the Secret.
- In cobodrive, go to Settings › Payments › PayPal, open the tab of the same environment (Sandbox or Live) and paste them.
If you paste Sandbox credentials into the Live tab (or the other way round), cobodrive tells you: “These credentials are for Sandbox — paste them into the Sandbox tab.”
2. Register the webhook
The webhook is the safety net: if a customer approves the payment and closes the page before coming back, PayPal still tells cobodrive and the booking is confirmed. It also brings back refunds you make in PayPal (see below).
- In the same PayPal app, open Webhooks › Add webhook.
- Paste the URL shown in cobodrive under PayPal webhook (use Copy URL).
- Subscribe to the three events listed there:
CHECKOUT.ORDER.APPROVEDPAYMENT.CAPTURE.COMPLETEDPAYMENT.CAPTURE.REFUNDED
- Save, then copy the Webhook ID PayPal shows and paste it into cobodrive.
3. Verify and turn it on
Click Verify connection. cobodrive checks that:
- PayPal accepts the credentials;
- the account can receive payments (it creates a €1 order that is never charged);
- the webhook exists with this URL, this Webhook ID and all three events.
Then click Use this environment on the tab you want to use. Only one environment is active at a time; the other stays saved so you can switch back.
What the webhook status means
| Message | What to do |
|---|---|
| Webhook registered with all events. | Nothing — you're done. |
| There is no webhook with this URL in the PayPal app. | Add it (step 2), in the app whose credentials you pasted. |
| A webhook with this URL exists, but with another ID | Copy that entry's Webhook ID into cobodrive. |
| The webhook is missing events | Edit the webhook in PayPal and tick the missing events. |
| Verify the connection to check the webhook. | Click Verify connection. |
On your booking page
PayPal appears on your public booking page only when the last Verify connection passed and the webhook is registered correctly — without the webhook, a customer who closes the page after paying would be charged with no booking created. In the preview link, valid credentials are enough.
Sandbox works on the public page too, so you can test end to end. While it is active, the page shows “Test mode — payments are not charged.” Switch to Live before taking real customers.
If the booking page is embedded in your website, PayPal opens in the full browser window (PayPal does not open inside an embedded frame). If the browser blocks that, the customer sees a Continue to PayPal link. After paying, the customer lands on your cobodrive booking page with the confirmation.
Refunds
- From cobodrive: open the payment on the booking and choose Refund — all or part of it. The money goes back through PayPal.
- From PayPal: refunds you make in your PayPal account also show up in cobodrive (the payment becomes Refunded or Partially refunded and the booking shows the amount as due again). This needs the
PAYMENT.CAPTURE.REFUNDEDevent on the webhook.
Testing in Sandbox
Pay with the Personal test account PayPal created for you (developer.paypal.com › Sandbox › Accounts). No real money moves.