PayPal Payment Gateway

Overview

PayPal provides a global payment platform for businesses to accept and process transactions across various channels. Founded in 1998, PayPal has expanded its services beyond its original digital wallet to include comprehensive payment gateway solutions, catering to a range of business types from small online shops to large enterprises. Its offerings encompass online checkout flows, tools for recurring billing, and options for in-person transactions.

The platform supports multiple payment methods, including major credit and debit cards, local payment options, and alternative payment methods through its digital wallet. For developers, PayPal offers extensive documentation and SDKs for integrating its APIs across various programming languages, including Node.js, Python, Java, and PHP. This facilitates the implementation of custom payment experiences and backend processing.

PayPal's core product suite includes PayPal Checkout for web and mobile transactions, PayPal Payments Pro for custom payment page hosting, and Braintree, an acquired subsidiary that provides more flexible, full-stack payment processing, including support for Venmo payments. Additionally, PayPal offers "Pay in 4," a Buy Now, Pay Later (BNPL) service, and Payment Links for simplified invoicing and request-for-payment scenarios. The platform's global reach supports transactions in over 200 countries and 25 currencies, making it suitable for businesses with international customer bases.

While PayPal provides a comprehensive suite of tools, its developer experience can sometimes involve more intricate integration pathways for highly customized or advanced use cases compared to newer payment platforms. However, its longevity in the market has resulted in a mature ecosystem with extensive community support and a broad array of pre-built integrations with e-commerce platforms like Shopify and WooCommerce. PayPal also maintains compliance with PCI DSS Level 1 and GDPR regulations.

Key features

• Online Payment Processing: Accept credit/debit cards, PayPal balance, and local payment methods via web and mobile interfaces.
• Recurring Billing & Subscriptions: Tools for managing subscription plans and automated recurring payments for services or products.
• Buy Now, Pay Later (BNPL): Offer "Pay in 4" to customers, allowing them to split purchases into interest-free installments.
• In-Person Payments: Solutions for accepting payments in physical retail environments, including hardware and software integrations.
• International Payments: Facilitate transactions in over 200 markets and more than 25 currencies, with built-in currency conversion.
• Developer SDKs & APIs: Comprehensive documentation and SDKs for Node.js, Python, Java, PHP, Ruby, and .NET for custom integrations.
• Fraud Protection & Risk Management: Tools and algorithms to help detect and prevent fraudulent transactions.
• Payment Links & Invoicing: Generate simple links to request payments or send detailed invoices to customers.
• Digital Wallet Integration: Seamless integration with the PayPal digital wallet for faster checkouts.
• Dispute Resolution: Mechanisms for managing chargebacks and buyer/seller protection claims.

Pricing

PayPal's pricing model is primarily transaction-fee based, with no monthly fees for standard accounts. Volume-based discounts and custom pricing tiers may be available for large enterprises. Fees vary by transaction type, country, and currency. The information below reflects standard rates as of May 2026.

For a detailed breakdown of all fees, including those for micropayments, chargebacks, and specific international rates, refer to the official PayPal Business Fees page.

Common integrations

• E-commerce Platforms: Pre-built plugins and extensions for popular platforms like Shopify, WooCommerce, Magento, and BigCommerce, streamlining checkout integration.
• Accounting Software: Connects with accounting and ERP systems such as QuickBooks and Xero for automated reconciliation of transactions.
• CRM Systems: Integrations with customer relationship management platforms to link payment data with customer profiles.
• Subscription Management Platforms: Tools for managing recurring billing logic and customer subscriptions.
• Point-of-Sale (POS) Systems: Integrations with various POS terminals for in-person payment processing via PayPal Zettle.
• Marketing Automation: Links with marketing platforms to trigger actions based on transaction status or customer segments.
• Custom Applications: Direct API and SDK integrations for bespoke web and mobile applications using developer resources.

Alternatives

• Stripe: A developer-focused payment platform known for its comprehensive APIs, flexible integration options, and global coverage.
• Square: Specializes in in-person and small business payments, offering POS hardware, software, and online payment solutions.
• Adyen: A global payment processing company providing end-to-end infrastructure for online, in-app, and in-store payments, often favored by larger enterprises for its unified platform.

Getting started

To begin integrating PayPal, developers typically utilize one of the available SDKs. The following Node.js example demonstrates how to set up the PayPal SDK and create an order, a common first step in a payment flow. This snippet assumes you have the PayPal Node.js SDK installed and your API credentials configured.

const paypal = require('@paypal/checkout-server-sdk');

// 1. Set up your PayPal environment (replace with your actual client ID and secret)
//    For sandbox testing, use the 'SandboxEnvironment'. For production, use 'LiveEnvironment'.
const clientId = 'YOUR_PAYPAL_CLIENT_ID';
const clientSecret = 'YOUR_PAYPAL_CLIENT_SECRET';

const environment = new paypal.core.SandboxEnvironment(clientId, clientSecret);
const client = new paypal.core.PayPalHttpClient(environment);

/**
 * This function sets up a new PayPal order.
 * In a real application, you would dynamically generate order details
 * based on the user's shopping cart or service selection.
 */
async function createOrder() {
  const request = new paypal.orders.OrdersCreateRequest();
  request.prefer('return=representation');
  request.requestBody({
    intent: 'CAPTURE',
    purchase_units: [{
      amount: {
        currency_code: 'USD',
        value: '100.00' // Example: A $100 order
      }
    }],
    application_context: {
      return_url: 'https://example.com/return',
      cancel_url: 'https://example.com/cancel'
    }
  });

  try {
    const response = await client.execute(request);
    console.log(`Order: ${JSON.stringify(response.result)}`);
    // The order ID can be used to redirect the user to PayPal for approval
    // or to complete the payment later.
    return response.result.id;
  } catch (err) {
    console.error(err);
    return null;
  }
}

// Example usage:
createOrder().then(orderId => {
  if (orderId) {
    console.log(`Successfully created PayPal order with ID: ${orderId}`);
    // Typically, you would send this order ID to the client-side
    // to initiate the PayPal Smart Buttons or redirect.
  }
});

This code snippet initializes the PayPal SDK with sandbox credentials, creates a new order for $100 USD, and logs the resulting order ID. After an order is created, the next steps typically involve approving the payment (e.g., by redirecting the user to PayPal or embedding PayPal Smart Buttons) and then capturing the payment. Further details can be found in the PayPal REST API reference.