Skip to content

Card payments with Stripe ​

Customers pay by card (also Apple Pay and Google Pay) and the money goes straight to your Stripe account — cobodrive never holds it.

Card payments work on:

  • Payment links (/pay) you send from a booking;
  • your booking page (/book);
  • the driver app, when the customer pays on their own phone with a QR code.

What you need ​

A Stripe account. You can start in Sandbox (testing, no real money) and switch to Live (real payments) when you're ready.

1. Paste your keys ​

In Settings › Payments, open Credit/debit card with Set up.

  1. Under Active environment, choose Sandbox or Live. Only one is active at a time; the other one's keys stay saved.
  2. In the keys tab of that environment, paste from the Stripe dashboard (Developers › API keys):
    • Publishable key (pk_test_… / pk_live_…)
    • Secret key (sk_… or a restricted key rk_…)

2. Register the webhook ​

The webhook tells cobodrive when a payment succeeds, fails or is refunded.

  1. Copy the Endpoint URL shown in cobodrive — it is the same for Sandbox and Live.

  2. In Stripe (Developers › Webhooks › Add endpoint), paste it and select the events listed under Events to send. Two are required:

    • payment_intent.succeeded
    • checkout.session.completed

    The others are recommended — in particular charge.refunded, charge.dispute.created and charge.dispute.closed, so refunds and disputes made in Stripe reach cobodrive.

  3. Copy the endpoint's Signing secret (whsec_…) into cobodrive.

3. Verify and turn it on ​

Click Verify connection. cobodrive checks the publishable key, the secret key, that the Stripe account can take payments, the signing secret's format, and that the webhook is registered and enabled with the required events. Each line shows OK, Warning, Failed or Not checked.

Signing secret

Stripe only confirms the signing secret when it sends the first event, so cobodrive can only check its format here.

Then Enable the method.

On your booking page ​

Card payment appears on your public booking page only when the last Verify connection passed, the webhook is OK and — in Live — the Stripe account can take payments. In the preview link, saved keys 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.

On a booking, use Payment link and Send by email or Send by WhatsApp. The customer chooses Card and pays on a secure Stripe page. Payment links need card payments set up, even if you also use PayPal.

In the driver app ​

When the customer pays on board, the driver can choose Mobile: the app shows a QR code and the customer pays on their own phone. If card payments aren't set up, the driver sees “Mobile payment unavailable” and can collect in cash instead.

Card payments never go into the driver's cash.

Refunds ​

  • From cobodrive: open the payment and choose Refund — Refund to card gives all or part of it back to the customer's card through Stripe. If Stripe refuses, nothing is recorded and you see why.
  • From Stripe: refunds you make in the Stripe dashboard also show up in cobodrive (needs the charge.refunded event): the payment becomes Refunded or Partly refunded and the amount is due again on the booking.

Disputes ​

When a customer disputes a payment with their bank, cobodrive records it on the payment and in the booking history and sends you a notification. Respond in the Stripe dashboard before the deadline. A lost dispute does not create a refund in cobodrive — record it yourself if needed.

Something missing or wrong? Contact your company’s office or cobodrive support.