PayPal

PayPal is an online payment service offered by PayPal Inc. The customer is redirected to a payment site hosted by PayPal and returns back to the merchant website after completing the transaction. Choose an integration option below to get started — from one-time Payment Page Redirect to Subscriptions, Checkout Page, and Pay by Link.

Networks	Features	Integrations	payment_type
PayPal	Payment Authorize Capture Refund Partial refund Reverse Payout Recurring Register	Server-to-Server Checkout Page Pay by Link Payment Page Redirect Subscriptions	paypal

Recurring billing

PayPal does not support standard MIT recurring (recurring: 1 + original_transaction_id). For recurring charges, use Subscriptions.

Payment workflow

The following diagram explains the PayPal payment workflow for the Payment Page Redirect integration.

PayPal — Payment Page Redirect

Scroll horizontally if the diagram is wider than your screen.

1. 1
   Payer (Customer)→Merchant

   1. Initiates payment and selects PayPal

2. 2
   Merchant→OneAPI

   2. Create PayPal payment (Payment API)

3. 3
   OneAPI→Merchant

   3. Returns redirect instructions

4. 4
   Merchant→Payer (Customer)

   4. Redirect to PayPal

5. 5
   Payer (Customer)→PayPal

   5. Authenticates and completes payment

6. 6
   PayPal→Payer (Customer)

   6. Redirect to success_url or error_url

7. i
   OneAPI

   Payment processing occurs asynchronously

8. 7
   OneAPI→Merchant

   7. Postback notification (payment status update)

9. 8
   Merchant→Payer (Customer)

   8. Shows final order confirmation

Integration options

Choose how you want to accept PayPal:

Payment Page Redirect

Create a payment via the Payment API and redirect the customer to PayPal to complete the transaction.

Start integrating

Subscriptions

Recurring billing with PayPal Subscriptions. Create a plan in PayPal, then set up the subscription via the Payment API.

Start integrating

Checkout Page

Create a checkout session and redirect customers to the hosted checkout. PayPal is available among the configured payment methods.

Start integrating

Pay by Link

Share a Pay by Link with your customer. When enabled on the channel, they can pay with PayPal on the checkout.

Start integrating