Accept PayPal payments from 426 million active users worldwide. PayPal Checkout for riders, PayPal Payouts for drivers, buyer protection, and One Touch frictionless payments across 200+ markets.
In many markets, PayPal is the preferred digital payment method because riders already have accounts and trust PayPal's buyer protection. For taxi operators targeting the US, Europe, Australia, and Latin America, offering PayPal alongside card payments increases booking conversion by 12-18% based on industry benchmarks.
Our PayPal integration uses the PayPal Orders API v2 for rider payments and the Payouts API for batch driver settlements. When a rider selects PayPal at checkout, they authenticate through PayPal's in-app browser or One Touch (if previously authorized), approve the fare, and the payment is captured upon ride completion. This authorize-then-capture flow ensures riders are only charged for the actual trip distance.
For drivers, PayPal Payouts enables instant batch transfers to driver PayPal accounts. Unlike bank transfers that take 2-3 business days, PayPal Payouts land in minutes, making it the fastest driver settlement option in many regions.
The integration uses PayPal's authorize-then-capture model, which is essential for ride-hailing where the final fare is determined after the trip ends. The rider authorizes the estimated fare before the ride, and the platform captures the actual fare upon completion.
// Step 1: Create order with authorization intent
const order = await paypal.orders.create({
intent: 'AUTHORIZE',
purchase_units: [{
amount: {
currency_code: 'USD',
value: '28.50' // Estimated fare
},
description: 'Ride from Downtown to Airport',
custom_id: 'ride_abc123'
}]
});
// Step 2: After ride completion, capture actual fare
const capture = await paypal.authorizations.capture(authorizationId, {
amount: {
currency_code: 'USD',
value: '25.80' // Actual metered fare
},
final_capture: true
});
// Batch payout to multiple drivers
const payout = await paypal.payouts.create({
sender_batch_header: {
sender_batch_id: `payout_${Date.now()}`,
email_subject: 'Your ride earnings have arrived'
},
items: drivers.map(driver => ({
recipient_type: 'EMAIL',
amount: { value: driver.earnings, currency: 'USD' },
receiver: driver.paypal_email,
note: `Earnings for ${driver.ride_count} rides`,
sender_item_id: driver.id
}))
});
PayPal Smart Buttons render the optimal payment options based on the rider's location and device. US riders see Venmo alongside PayPal. European riders see local SEPA options. The button adapts automatically.
Every PayPal ride payment is covered by PayPal Buyer Protection. If a rider disputes a charge, PayPal mediates the resolution with your support team providing ride evidence including GPS data and timestamps.
Riders can pay with PayPal balance, linked bank accounts, or cards from 200+ markets. PayPal handles currency conversion automatically, letting you accept fares from international travelers without additional integrations.
Riders who enable PayPal One Touch skip the login step on subsequent rides. The device is remembered and payment is approved with a single tap, matching the speed of saved card payments.
PayPal Payouts API transfers earnings to driver PayPal accounts in minutes. Batch up to 15,000 payouts in a single API call for end-of-day settlements across your entire driver fleet.
The platform integrates with PayPal's Disputes API to automatically respond to rider claims with ride evidence. Track dispute status, submit evidence, and resolve cases without leaving the admin dashboard.
Sign up for a PayPal Business account and apply for API access. Enable the Orders API, Payouts API, and Webhooks in the PayPal Developer Dashboard. Approval typically takes 1-2 business days.
Enter your PayPal Client ID, Secret, and Webhook ID in the admin dashboard. Select supported currencies, set authorization hold period (default 3 days), and configure payout schedule for drivers.
Register webhook listeners for PAYMENT.AUTHORIZATION.CREATED, PAYMENT.CAPTURE.COMPLETED, PAYMENT.PAYOUT.BATCH_SUCCESS, and CUSTOMER.DISPUTE.CREATED events. The platform provides pre-built handlers for all required events.
Set the payout frequency (daily, weekly, on-demand) and minimum payout threshold. Drivers provide their PayPal email during onboarding. The platform validates each email against PayPal's API before storing it.
Use PayPal sandbox buyer and seller accounts to simulate rides, authorizations, captures, refunds, and disputes. Verify the full payment lifecycle before switching to production credentials.
PayPal provides built-in fraud protection, seller protection coverage, and PCI-compliant payment processing without your servers handling sensitive financial data.
PayPal screens every transaction using machine learning trained on 5 billion+ annual transactions. Suspicious payments are automatically blocked or flagged before charges complete.
ML-powered screeningEligible ride transactions are covered by PayPal Seller Protection against unauthorized payments and item-not-received claims. Provides a financial safety net for your platform revenue.
Revenue protectedPayPal is a PCI DSS Level 1 certified service provider. Card data entered in PayPal's hosted fields never touches your servers, eliminating PCI scope for your platform infrastructure.
PCI Level 1All PayPal API calls use TLS 1.2+ encryption. OAuth 2.0 access tokens expire after 9 hours and are rotated automatically. Webhook signatures are verified using PayPal's certificate chain.
TLS 1.2+Configure custom velocity rules to limit rapid-fire bookings from new PayPal accounts, cap daily spend per rider, and flag unusually large fare authorizations for manual review.
Custom rulesWhen disputes arise, the system auto-generates evidence packages including ride GPS trail, driver identity, trip timestamps, and rider confirmation. Submit directly via PayPal's Disputes API.
Auto-responseRiders who prefer PayPal will abandon bookings if only card payment is available. Adding PayPal increases checkout conversion by 12-18% in markets where PayPal is widely used.
International travelers without local payment methods can pay with their home-country PayPal account. Essential for airport transfer services and tourist-heavy markets.
PayPal is a trusted household name. Riders who are hesitant to enter card details into a new app will use PayPal because they trust PayPal's buyer protection and data security track record.
Riders can pay with PayPal balance or linked bank account without a credit card. This opens your platform to the underbanked population and younger riders without credit history.
PayPal Payouts deliver funds to driver accounts in minutes, not days. Faster settlements improve driver satisfaction, retention, and willingness to stay online during peak hours.
PayPal Checkout automatically surfaces Venmo as a payment option for US riders. Venmo has 90+ million users, many of whom are millennials and Gen Z who prefer Venmo over traditional cards.
PayPal charges 2.99% + $0.49 per transaction for standard commercial rates in the US. International transactions add a 1.5% cross-border fee. PayPal Payouts to drivers cost $0.25 per payout for US recipients and vary by country for international payouts. Volume discounts are available for platforms processing over $10,000/month.
Yes. PayPal and Stripe can both be active simultaneously. The rider app displays all available payment methods (saved cards via Stripe, PayPal, in-app wallet) and lets the rider choose before confirming a ride. The backend routes the payment through the appropriate gateway based on the rider's selection.
When a rider books a ride, the system creates a PayPal authorization for the estimated fare (with a configurable buffer of 10-20%). After the trip ends, the actual metered fare is captured against the authorization. If the actual fare exceeds the authorization, a new capture for the difference is processed. Authorizations are valid for 29 days.
Yes, drivers who want PayPal payouts need a PayPal account linked to a valid email address. If a driver does not have a PayPal account, PayPal sends them a notification to claim the payout. Alternatively, drivers can choose bank transfers via Stripe Connect as their payout method instead.
When a rider files a PayPal dispute, the platform receives a CUSTOMER.DISPUTE.CREATED webhook. The system automatically compiles ride evidence (GPS trail, fare breakdown, driver details, rating) and submits it through PayPal's Disputes API. Disputes are tracked in the admin panel with status updates at each stage of resolution.
PayPal Checkout, One Touch payments, batch driver payouts, and buyer protection. Give riders the payment option they trust most.