Accept a PayPal payment

A Checkout Session must satisfy all of the following conditions to support PayPal payments:

• Prices for all line items must be in the same currency. If you have line items in different currencies, create separate Checkout Sessions for each currency.

Use this guide to learn how to enable PayPal—it shows the differences between accepting a card payment and using PayPal.

Enable PayPal as a payment method

When creating a new Checkout Session, do the following:

1. Add paypal to the list of payment_method_types.
2. Make sure all your line_items use the same currency.

Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'paypal'],
  line_items: [{
    price_data: {
      currency: 'usd',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

Fulfill your orders

After accepting a payment, learn how to fulfill orders.

You don’t need to connect your PayPal business account to test the integration. However, make sure to connect your PayPal and Stripe accounts when you’re ready to activate live mode payments.

When testing your Checkout integration, select PayPal as the payment method and click Pay.

To simulate the most common integration and failure scenarios for PayPal payments, pass email values that match the patterns described in these test scenarios.

Test scenarios

Learn more about PayPal disputes and refunds.