# PayPal payments

Learn about PayPal, a popular digital wallet.

PayPal is a digital wallet that allows customers worldwide to pay using their PayPal balance, a linked card or bank account, or an eligible buy now, pay later option. Stripe processes PayPal payments for businesses in supported European countries.
Payment method family: Wallets
Usability: Reusable
Access type: Instant provisional access
Payment confirmation timing: Immediate
Settlement timing: Standard payout schedule
Pricing: https://stripe.com/en-gb/pricing/local-payment-methods#paypal
> This page covers PayPal payments processed through Stripe for businesses in [supported European countries](https://docs.stripe.com/payments/paypal.md#paypal-business-locations). If your Stripe account is outside these countries or you want to process payments through your own PayPal account, see [Redirect-based payment methods](https://docs.stripe.com/payments/payment-methods/custom-payment-methods/redirect.md).

## Eligibility and availability 

### Account eligibility
Business location: AT, BE, BG, CH, CY, CZ, DE, DK, EE, ES, FI, FR, GB, GR, HR, IE, IT, LI, LT, LU, LV, MT, NL, NO, PL, PT, RO, SE, SI, SK
Account type: ✓ Merchant, ✓ Platform or marketplace (Connect)
Business model: ✓ B2B, ✓ B2C
### PayPal account restrictions 

Stripe doesn’t impose PayPal-specific merchant category code (MCC) restrictions. PayPal evaluates its own restrictions when you sign up for a PayPal account.

In addition to the business categories restricted from using Stripe overall, PayPal requires pre-approval to accept payments for certain services. Refer to the [PayPal Acceptable Use Policy](https://www.paypal.com/us/legalhub/acceptableuse-full) for details.

Stripe accounts in the following countries can accept PayPal payments that settle in a supported currency.

EMEA: AT, BE, BG, CH, CY, CZ, DE, DK, EE, ES, FI, FR, GB, GR, HR, IE, IT, LI, LT, LU, LV, MT, NL, NO, PL, PT, RO, SE, SI, SK

Customers worldwide can use PayPal.

### Payment support
Customer location: Worldwide
Presentment currency: AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, NOK, NZD, PLN, SEK, SGD, USD
Geographic coverage: ✓ Domestic, ✓ Crossborder
Transaction limits: Example for payments presented and settled in AUD: minimum 0.50 AUD, maximum 999,999.99 AUD.
Stripe’s [minimum and maximum charge amounts](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts) apply to PayPal payments. The minimum depends on your settlement currency and must be met after any currency conversion. The maximum depends on the presentment currency. The AUD example isn’t a limit for every supported currency.

## Capabilities 
Recurring payments: ✓ Supported

Payment authorizations:
  ✗ Extended authorizations
  ✗ Flexible extended authorizations
  ✗ Incremental authorizations
  ✗ Decremental authorizations
  ✗ Re-authorizations

Payment captures:
  ✓ Manual capture
  ✓ Partial capture
  ✗ Multi-capture
  ✗ Over-capture

Refunds:
  ✓ Partial refunds
  ✓ Full refunds
  Submission window: 180 days
  Processing time: Varies by funding source

Disputes:
  ✓ Partial disputes
  ✓ Full disputes
### Refunds 

You can refund PayPal payments up to 180 days after the original payment using the [Dashboard](https://dashboard.stripe.com/payments) or [Refunds API](https://docs.stripe.com/api/refunds/create.md). Refunds can’t be canceled after you initiate them. PayPal doesn’t guarantee a fixed completion time because completion varies by the buyer’s funding source, which Stripe can’t identify.

#### Refund process 

Your [settlement preference](https://docs.stripe.com/payments/paypal/choose-settlement-preference.md) determines the source of refund funds. If PayPal funds settle to Stripe, Stripe withdraws the refund from the funds available in your Stripe account. If PayPal funds settle to PayPal, PayPal funds the refund from your PayPal balance or another funding source available on your PayPal account.

#### Tracking refunds 

To check a refund’s status, open the payment in the [Dashboard](https://dashboard.stripe.com/payments) and click **View details** on the refund entry. You can also [retrieve the Refund object](https://docs.stripe.com/api/refunds/retrieve.md) and check its `status` property.

Stripe notifies you of the final status through a `refund.updated` or `refund.failed` event. [Verify webhook signatures](https://docs.stripe.com/webhooks.md#verify-events) to confirm that events came from Stripe. You can also use Stripe’s [public IP addresses](https://docs.stripe.com/ips.md) for network allowlisting. When a refund succeeds, its status changes to `succeeded`. If a refund fails, its status changes to `failed`, and you must refund the customer using another method.

Returned refund funds go to your Stripe balance only if funds settle to Stripe. For settlement to PayPal, refund funds remain managed in your PayPal account. See [refunds and disputes by settlement preference](https://docs.stripe.com/payments/paypal/choose-settlement-preference.md#refunds-and-disputes).

### Disputes 

PayPal payments can be disputed more than once. Each dispute is treated as an independent object, must be handled separately, and counts individually toward your dispute metrics.

#### Dispute process 

Customers can dispute PayPal payments, including when they claim that an item wasn’t as described or wasn’t received. The disputed amount is withheld from your Stripe balance if funds settle to Stripe, or managed in your PayPal account if funds settle to PayPal. See [refunds and disputes by settlement preference](https://docs.stripe.com/payments/paypal/choose-settlement-preference.md#refunds-and-disputes). PayPal might charge a dispute fee. For Stripe pricing details, see the [pricing page](https://stripe.com/pricing/local-payment-methods#paypal).

Response deadlines vary by dispute category and are usually 2–19 calendar days. Always use the due-by date in the Dashboard or `Dispute.evidence_details.due_by` for the specific case. PayPal usually decides a dispute within 30 calendar days after you submit evidence, but a decision can take longer depending on the case and whether the dispute originated with PayPal or the buyer’s bank or payment provider.

#### Dispute notifications 

Stripe notifies you of a dispute by email, in the [Dashboard](https://dashboard.stripe.com/disputes), and with a [`charge.dispute.created`](https://docs.stripe.com/api/events/types.md#event_types-charge.dispute.created) event. The dispute reason and case-specific evidence deadline are available in the Dashboard and on the [Dispute object](https://docs.stripe.com/api/disputes/object.md).

#### Responding to disputes 

Submit evidence in the [Dashboard](https://dashboard.stripe.com/disputes) or with the [Disputes API](https://docs.stripe.com/api/disputes/update.md) before the case-specific deadline. Stripe supports one evidence submission for each PayPal dispute, so gather all evidence before submitting it. For dispute types where PayPal offers direct communication or additional interaction, use the PayPal dashboard; those interactions aren’t available in the Stripe Dashboard.

#### Dispute outcomes 

If you win the dispute and your PayPal funds settle to Stripe, Stripe returns the disputed amount to your Stripe balance. If your funds settle to PayPal, the relevant funds remain in your PayPal account. If the customer wins, the balance charge becomes permanent in the account determined by your [settlement preference](https://docs.stripe.com/payments/paypal/choose-settlement-preference.md#refunds-and-disputes).

PayPal might allow an appeal for some cases, but Stripe can’t submit one on your behalf. Check the PayPal dashboard for any available appeal instructions.

### Mandates 

Saving PayPal for future payments requires a mandate. PayPal hosts the authorization flow and records the customer’s future-payment authorization.

#### What customers authorize 

The customer authorizes your business to make future PayPal payments under the terms presented by PayPal. PayPal requires separate approval for recurring payments.

#### Collect mandates 

Before saving PayPal for future use in live mode, make sure recurring payments are enabled for your PayPal account. Stripe automatically enables recurring payments for most accounts when you activate PayPal. If recurring payments aren’t enabled for your account, [enable them manually in the Dashboard](https://docs.stripe.com/payments/paypal/set-up-future-payments.md#enable-recurring-payments) and wait until access is granted before saving a customer’s PayPal payment method. PayPal might request additional business information during approval.

#### Manage mandates 

Retrieve the Stripe Mandate with [`GET /v1/mandates/{mandate_id}`](https://docs.stripe.com/api/mandates/retrieve.md). The PayPal billing agreement ID (BAID) is available at `mandate.payment_method_details.paypal.billing_agreement_id`.

If you use a restricted API key, it needs the `mandate_read` permission. See the [API permissions reference](https://docs.stripe.com/keys/permissions-reference.md).

The saved PayPal PaymentMethod is visible in the Dashboard. The Mandate isn’t visible in the Dashboard and doesn’t contain additional merchant-useful details beyond what you can retrieve with the API.

#### Cancel mandates 

To stop using a saved PayPal payment method, [detach the PaymentMethod from the Customer](https://docs.stripe.com/api/payment_methods/detach.md). After detaching it, you can’t use that PaymentMethod for future payments.

Customers can also revoke the authorization in PayPal. When PayPal reports a revocation, Stripe revokes the linked Mandate and sends a `mandate.updated` event. [Verify webhook signatures](https://docs.stripe.com/webhooks.md#verify-events) before processing the event.

## Stripe product support 
Checkout UIs:
  ✓ Full page (Recommended)
  ✓ Payment Links
  ✓ Embedded form
  ✓ Payment Element
  ✓ Express Checkout Element
  ✗ Payment Method Messaging Element
  ✓ In-app payments

Products:
  ✗ Managed Payments
  ✗ Billing
  ✓ Invoicing
  ✓ Customer Portal
  ✓ Radar
  ✗ Terminal
  ✓ Connect

APIs:
  ✓ Checkout Sessions (Recommended)
  ✓ Payment Intents
  ✓ Payment Intents with setup_future_usage
  ✓ Setup Intents
  ✓ Off-session payments
Adaptive Pricing is available for one-time and subscription payments when PayPal funds [settle to Stripe](https://docs.stripe.com/payments/paypal/choose-settlement-preference.md). PayPal supports [subscription payments](https://docs.stripe.com/payments/paypal/set-up-future-payments.md), including recurring payments after PayPal approval. The Billing status in this table doesn’t indicate subscription support.

### Connect limitations 

PayPal is available to approved online marketplaces that collect customer payments and later pay out to sub-accounts or service providers. To request access, click **Request access** next to PayPal in your [payment method settings](https://dashboard.stripe.com/settings/payment_methods). See the [Connect activation guide](https://docs.stripe.com/payments/paypal/activate.md#connect-users) for the approval and onboarding process. PayPal isn’t available to platforms that onboard other businesses and enable those businesses to accept payments directly.

PayPal supports destination charges and separate charges and transfers. It doesn’t support direct charges or `on_behalf_of`. To configure PayPal, see [Enable PayPal](https://docs.stripe.com/payments/paypal.md#enable-paypal).

## Reporting and fees 

PayPal fees are included in the **Less fees** sections of [Balance and Balance Activity reports](https://dashboard.stripe.com/reports/balance). PayPal fees aren’t included in your [tax invoice from Stripe](https://dashboard.stripe.com/settings/documents). You can access PayPal fee documents from the PayPal dashboard.

## Seller protection 

PayPal’s Seller Protection program offers coverage for eligible transactions, including unauthorized transactions and claims that an item wasn’t received. For program and eligibility details, see [PayPal Seller Protection](https://www.paypal.com/uk/legalhub/seller-protection).

## Customer experience 

#### 1. Select PayPal

The customer selects PayPal at checkout and continues to authorization.

#### 2. Authorize with PayPal

PayPal redirects the customer to its hosted authorization flow. The customer signs in, selects a funding source, and approves the payment. On mobile, the authorization flow might open in the PayPal app.

#### 3. Return and confirm

After authorization, PayPal automatically redirects the customer to the merchant website. Stripe immediately reports success or failure, and checkout displays the final result.

### Statement descriptors 

By default, PayPal payments display `PAYPAL *YOUR_BUSINESS_NAME`. If you set `statement_descriptor`, PayPal displays `PAYPAL*DESCRIPTOR`, truncated to 22 characters.

For Connect destination charges and separate charges and transfers, PayPal uses the platform’s PayPal statement descriptor.

To retrieve the PayPal transaction ID, retrieve the PaymentIntent with `latest_charge` expanded and read `latest_charge.payment_method_details.paypal.transaction_id`.

## Enable PayPal 

If you use Stripe front-end products, enable PayPal in your [payment method settings](https://dashboard.stripe.com/settings/payment_methods). Stripe automatically determines which payment methods are most relevant to each customer.

If your integration lists payment methods manually, learn how to [configure PayPal as a payment method](https://docs.stripe.com/payments/paypal/accept-a-payment.md).
