PayPal website screenshot

PayPal

PayPal is a global online payment system that lets individuals and businesses send and receive money electronically. PayPal exposes a broad surface of REST APIs covering payments, orders, subscriptions, invoicing, payouts, disputes, payment tokens, shipping tracking, transaction reporting, partner referrals, payment experience, and webhook notifications.

13 APIs 16 Features
BillingCommerceDisputesInvoicesOrdersPaymentsPayoutsSubscriptionsTokensWebhooks

APIs

PayPal Billing Subscriptions API

The PayPal Billing Subscriptions API enables businesses to create and manage subscription plans, activate, suspend, cancel, capture, and revise customer subscriptions, and track...

PayPal Catalog Products API

The PayPal Catalog Products API lets merchants create and manage product definitions used across orders, subscriptions, and invoicing.

PayPal Orders API

The PayPal Orders API lets merchants create, update, authorize, capture, and manage orders for accepting payments through PayPal Checkout.

PayPal Customer Disputes API

The PayPal Customer Disputes API allows merchants to retrieve, respond to, escalate, and settle disputes raised on transactions, including providing evidence and managing disput...

PayPal Partner Referrals API

The PayPal Partner Referrals API enables platforms and marketplaces to onboard merchants onto PayPal, generate referral links, and track partner account creation status.

PayPal Invoicing API

The PayPal Invoicing API allows merchants to create, send, schedule, track, and manage invoices, including reminders and payment status.

PayPal Notification Webhooks API

The PayPal Notification Webhooks API lets developers subscribe to and manage webhook event notifications for payments, refunds, disputes, and other PayPal account activity.

PayPal Payment Experience API

The PayPal Payment Experience API lets merchants create web experience profiles to customize the look, feel, and flow of PayPal checkout pages.

PayPal Payments API

The PayPal Payments API lets businesses authorize, capture, refund, void, and reauthorize payments, supporting credit and debit cards as well as PayPal and Venmo wallets.

PayPal Payouts API

The PayPal Payouts API lets businesses send mass payments to multiple recipients with a single API call, useful for marketplaces, affiliates, rewards programs, and contractor pa...

PayPal Transaction Search (Reporting) API

The PayPal Transaction Search API provides access to historical transaction details, balances, and account activity for reporting, reconciliation, and accounting use cases.

PayPal Shipping Tracking API

The PayPal Shipping Tracking API lets merchants attach, update, and retrieve tracking information on PayPal transactions for faster dispute resolution and improved buyer transpa...

PayPal Vault Payment Tokens API

The PayPal Vault Payment Tokens API lets merchants securely store and reuse customer payment instruments as tokens for repeat billing and one-click checkout flows.

GraphQL

PayPal GraphQL Schema

This conceptual GraphQL schema represents the PayPal payments platform surface, covering REST APIs for Orders, Payments, Payouts, Subscriptions, Invoicing, Reporting, Disputes, ...

GRAPHQL

Pricing Plans

Paypal Plans Pricing

7 plans

PLANS

Rate Limits

Paypal Rate Limits

3 limits

RATE LIMITS

FinOps

Paypal Finops

FINOPS

Features

PayPal Checkout: 3.49% + $0.49 per transaction
Standard Credit/Debit Card: 2.99% + $0.49
QR Code Transactions: 2.29% + $0.09
POS Card Present: 2.29% + $0.09
POS Manual Entry: 3.49% + $0.09
Invoicing ACH: 1% (capped $10)
International transactions: +1.50% surcharge
200+ markets, 25 currencies
REST API at api-m.paypal.com
OAuth 2.0 client credentials
Sandbox at 20 req/min for testing
Webhooks for payment events (signed)
Smart Payment Buttons (JS SDK)
Hosted Card Fields and Advanced Credit/Debit Card
Subscriptions and Recurring Billing
Buyer and Seller Protection programs

JSON Structure

Paypal Structure

0 properties

JSON STRUCTURE

Example Payloads

Paypal Ordersconfirm Example

6 fields

EXAMPLE

Paypal Orderscreate Example

6 fields

EXAMPLE

Paypal Payoutspost Example

6 fields

EXAMPLE

Paypal Planscreate Example

6 fields

EXAMPLE

Paypal Productspatch Example

6 fields

EXAMPLE

Paypal Webhookspost Example

6 fields

EXAMPLE

Resources

👥
GitHubOrganization
GitHubOrganization
🔗
LinkedIn
LinkedIn
🔗
Website
Website
🌐
DeveloperPortal
DeveloperPortal
🔗
Documentation
Documentation
🔑
Authentication
Authentication
🟢
StatusPage
StatusPage
💰
Pricing
Pricing
📜
TermsOfService
TermsOfService
📜
PrivacyPolicy
PrivacyPolicy
🔗
LlmsText
LlmsText

Sources

Raw ↑
aid: paypal
name: PayPal
description: PayPal is a global online payment system that lets individuals and businesses send and receive money electronically.
  PayPal exposes a broad surface of REST APIs covering payments, orders, subscriptions, invoicing, payouts, disputes, payment
  tokens, shipping tracking, transaction reporting, partner referrals, payment experience, and webhook notifications.
kind: contract
position: Consuming
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
- Billing
- Commerce
- Disputes
- Invoices
- Orders
- Payments
- Payouts
- Subscriptions
- Tokens
- Webhooks
created: '2024-04-14'
modified: '2026-05-30'
url: https://raw.githubusercontent.com/api-evangelist/paypal/refs/heads/main/apis.yml
specificationVersion: '0.20'
apis:
- aid: paypal:paypal-billing-subscriptions-api
  name: PayPal Billing Subscriptions API
  description: The PayPal Billing Subscriptions API enables businesses to create and manage subscription plans, activate,
    suspend, cancel, capture, and revise customer subscriptions, and track recurring payments.
  humanURL: https://developer.paypal.com/docs/api/subscriptions/v1/
  tags:
  - Activate
  - Billing
  - Cancel
  - Capture
  - Plans
  - Subscriptions
  - Suspend
  - Transactions
  properties:
  - type: Documentation
    url: https://developer.paypal.com/docs/api/subscriptions/v1/
  - type: OpenAPI
    url: openapi/paypal-billing-subscriptions-openapi-original.yml
  - url: graphql/paypal-graphql.md
    type: GraphQL
- aid: paypal:paypal-products-api
  name: PayPal Catalog Products API
  description: The PayPal Catalog Products API lets merchants create and manage product definitions used across orders, subscriptions,
    and invoicing.
  humanURL: https://developer.paypal.com/docs/api/catalog-products/v1/
  tags:
  - Catalog
  - Products
  properties:
  - type: Documentation
    url: https://developer.paypal.com/docs/api/catalog-products/v1/
  - type: OpenAPI
    url: openapi/paypal-catalog-products-openapi-original.yml
- aid: paypal:paypal-orders-api
  name: PayPal Orders API
  description: The PayPal Orders API lets merchants create, update, authorize, capture, and manage orders for accepting payments
    through PayPal Checkout.
  humanURL: https://developer.paypal.com/docs/api/orders/v2/
  tags:
  - Checkout
  - Orders
  - Payments
  properties:
  - type: Documentation
    url: https://developer.paypal.com/docs/api/orders/v2/
  - type: OpenAPI
    url: openapi/paypal-checkout-orders-openapi-original.yml
- aid: paypal:paypal-disputes-api
  name: PayPal Customer Disputes API
  description: The PayPal Customer Disputes API allows merchants to retrieve, respond to, escalate, and settle disputes raised
    on transactions, including providing evidence and managing dispute lifecycles.
  humanURL: https://developer.paypal.com/docs/disputes/integration-guide/
  tags:
  - Disputes
  - Evidence
  - Resolution
  properties:
  - type: Documentation
    url: https://developer.paypal.com/docs/disputes/integration-guide/
  - type: OpenAPI
    url: openapi/paypal-customer-disputes-openapi-original.yml
- aid: paypal:paypal-partner-referrals-api
  name: PayPal Partner Referrals API
  description: The PayPal Partner Referrals API enables platforms and marketplaces to onboard merchants onto PayPal, generate
    referral links, and track partner account creation status.
  humanURL: https://developer.paypal.com/docs/api/partner-referrals/v1/
  tags:
  - Onboarding
  - Partner
  - Referrals
  properties:
  - type: Documentation
    url: https://developer.paypal.com/docs/api/partner-referrals/v1/
  - type: OpenAPI
    url: openapi/paypal-customer-partner-referrals-openapi-original.yml
- aid: paypal:paypal-invoicing-api
  name: PayPal Invoicing API
  description: The PayPal Invoicing API allows merchants to create, send, schedule, track, and manage invoices, including
    reminders and payment status.
  humanURL: https://developer.paypal.com/docs/api/invoicing/v2/
  tags:
  - Billing
  - Invoices
  - Payments
  properties:
  - type: Documentation
    url: https://developer.paypal.com/docs/api/invoicing/v2/
  - type: OpenAPI
    url: openapi/paypal-invoicing-openapi-original.yml
- aid: paypal:paypal-notification-webhooks-api
  name: PayPal Notification Webhooks API
  description: The PayPal Notification Webhooks API lets developers subscribe to and manage webhook event notifications for
    payments, refunds, disputes, and other PayPal account activity.
  humanURL: https://developer.paypal.com/api/rest/webhooks/
  tags:
  - Events
  - Notifications
  - Webhooks
  properties:
  - type: Documentation
    url: https://developer.paypal.com/api/rest/webhooks/
  - type: OpenAPI
    url: openapi/paypal-notification-webhooks-openapi-original.yml
  - type: AsyncAPI
    url: openapi/paypal-webhooks-asyncapi-original.yml
- aid: paypal:paypal-payment-experience-api
  name: PayPal Payment Experience API
  description: The PayPal Payment Experience API lets merchants create web experience profiles to customize the look, feel,
    and flow of PayPal checkout pages.
  humanURL: https://developer.paypal.com/docs/payment-experience/
  tags:
  - Checkout
  - Customization
  - Experience
  properties:
  - type: Documentation
    url: https://developer.paypal.com/docs/payment-experience/
  - type: OpenAPI
    url: openapi/paypal-payment-experience-openapi-original.yml
- aid: paypal:paypal-payments-api
  name: PayPal Payments API
  description: The PayPal Payments API lets businesses authorize, capture, refund, void, and reauthorize payments, supporting
    credit and debit cards as well as PayPal and Venmo wallets.
  humanURL: https://developer.paypal.com/api/rest/
  tags:
  - Authorizations
  - Captures
  - Payments
  - Refunds
  properties:
  - type: Documentation
    url: https://developer.paypal.com/api/rest/
  - type: OpenAPI
    url: openapi/paypal-payments-openapi-original.yml
- aid: paypal:paypal-payouts-api
  name: PayPal Payouts API
  description: The PayPal Payouts API lets businesses send mass payments to multiple recipients with a single API call, useful
    for marketplaces, affiliates, rewards programs, and contractor payouts.
  humanURL: https://developer.paypal.com/docs/api/payments.payouts-batch/v1/
  tags:
  - Mass Pay
  - Payouts
  - Transfers
  properties:
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payments.payouts-batch/v1/
  - type: OpenAPI
    url: openapi/paypal-payouts-openapi-original.yml
- aid: paypal:paypal-reporting-transactions-api
  name: PayPal Transaction Search (Reporting) API
  description: The PayPal Transaction Search API provides access to historical transaction details, balances, and account
    activity for reporting, reconciliation, and accounting use cases.
  humanURL: https://developer.paypal.com/docs/api/transaction-search/v1/
  tags:
  - Reconciliation
  - Reporting
  - Transactions
  properties:
  - type: Documentation
    url: https://developer.paypal.com/docs/api/transaction-search/v1/
  - type: OpenAPI
    url: openapi/paypal-reporting-transactions-openapi-original.yml
- aid: paypal:paypal-shipping-tracking-api
  name: PayPal Shipping Tracking API
  description: The PayPal Shipping Tracking API lets merchants attach, update, and retrieve tracking information on PayPal
    transactions for faster dispute resolution and improved buyer transparency.
  humanURL: https://developer.paypal.com/docs/tracking/tracking-api/
  tags:
  - Carriers
  - Shipping
  - Tracking
  properties:
  - type: Documentation
    url: https://developer.paypal.com/docs/tracking/tracking-api/
  - type: OpenAPI
    url: openapi/paypal-shipping-tracking-openapi-original.yml
- aid: paypal:paypal-payment-tokens-api
  name: PayPal Vault Payment Tokens API
  description: The PayPal Vault Payment Tokens API lets merchants securely store and reuse customer payment instruments as
    tokens for repeat billing and one-click checkout flows.
  humanURL: https://developer.paypal.com/docs/api/payment-tokens/v3/
  tags:
  - Tokens
  - Vault
  - Wallet
  properties:
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payment-tokens/v3/
  - type: OpenAPI
    url: openapi/paypal-vault-payment-tokens-openapi-original.yml
common:
- type: GitHubOrganization
  url: https://github.com/paypal
- type: LinkedIn
  url: https://www.linkedin.com/company/paypal
- type: Website
  url: https://www.paypal.com
- type: DeveloperPortal
  url: https://developer.paypal.com
- type: Documentation
  url: https://developer.paypal.com/api/rest/
- type: Authentication
  url: https://developer.paypal.com/api/rest/authentication/
- type: StatusPage
  url: https://www.paypal-status.com/
- type: Pricing
  url: https://www.paypal.com/us/business/paypal-business-fees
- type: TermsOfService
  url: https://www.paypal.com/us/legalhub/useragreement-full
- type: PrivacyPolicy
  url: https://www.paypal.com/us/legalhub/privacy-full
- type: Features
  data:
  - 'PayPal Checkout: 3.49% + $0.49 per transaction'
  - 'Standard Credit/Debit Card: 2.99% + $0.49'
  - 'QR Code Transactions: 2.29% + $0.09'
  - 'POS Card Present: 2.29% + $0.09'
  - 'POS Manual Entry: 3.49% + $0.09'
  - 'Invoicing ACH: 1% (capped $10)'
  - 'International transactions: +1.50% surcharge'
  - 200+ markets, 25 currencies
  - REST API at api-m.paypal.com
  - OAuth 2.0 client credentials
  - Sandbox at 20 req/min for testing
  - Webhooks for payment events (signed)
  - Smart Payment Buttons (JS SDK)
  - Hosted Card Fields and Advanced Credit/Debit Card
  - Subscriptions and Recurring Billing
  - Buyer and Seller Protection programs
  sources:
  - https://www.paypal.com/us/business/paypal-business-fees
  updated: '2026-05-04'
- type: LlmsText
  url: https://developer.paypal.com/llms.txt
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com