{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-agen-for-work/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["Notification","LightboxImage"]},"type":"markdown"},"seo":{"title":"PayPal integration","siteUrl":"https://developers.frontegg.com/","llmstxt":{"title":"Frontegg Developer Documentation","description":"Authentication, authorization, and user management for Customer Identity, plus Agen for SaaS and Agen for Work. Guides, SDKs, and API references.","sections":[{"title":"Customer Identity (CIAM)","description":"Auth, SSO, SCIM, entitlements, and user management — guides, SDKs, and APIs.","includeFiles":["ciam/**/*.md"],"excludeFiles":[]},{"title":"Agen for SaaS","description":"Agentic access and authorization for SaaS products.","includeFiles":["agen-for-saas/**/*.md"],"excludeFiles":[]},{"title":"Agen for Work","description":"Agentic access and authorization for internal and workforce use.","includeFiles":["agen-for-work/**/*.md"],"excludeFiles":[]},{"title":"Platform","description":"Shared platform overview.","includeFiles":["platform/**/*.md"],"excludeFiles":[]}],"excludeFiles":["internal-docs/**","ciam/guides/env-settings/inject-client-ip.md","CLAUDE.md",".claude/**","**/images/**"],"hide":false}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"paypal-integration","__idx":0},"children":["PayPal integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["PayPal is an online payments platform for accepting payments, billing, and payouts. Integrating PayPal with Frontegg lets your application create and capture orders, attach shipment tracking, refund captures, manage invoices and chase unpaid ones, run subscriptions with their plans and products, send payouts, handle disputes, and search transactions on behalf of your users — all through Frontegg's integration layer (PayPal REST API). PayPal authenticates with OAuth 2.0 client credentials."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Prerequisites","type":"attention"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.paypal.com/"},"children":["PayPal"]}," account (a Business account is required for live credentials)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.paypal.com/dashboard/"},"children":["PayPal Developer Dashboard"]}," to create a REST API app"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connect-to-paypal","__idx":1},"children":["Connect to PayPal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["PayPal uses the OAuth 2.0 client credentials grant — an app-to-app flow with no browser step or redirect URL. You create a REST API app in the PayPal Developer Dashboard, which issues a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Secret"]},", and the integration exchanges them for a short-lived access token on each request."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-1-open-apps--credentials","__idx":2},"children":["Step 1: Open Apps & Credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sign in to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.paypal.com/dashboard/"},"children":["PayPal Developer Dashboard"]}," and open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Apps & Credentials"]},". Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sandbox / Live"]}," toggle to choose the environment — sandbox and live apps have separate credentials. Your account starts with a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Default Application"]},", or click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create App"]}," to add one."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/paypal-1.b90c8bd9db906a231c29625f370652dc14b4d4edd50380a8800a4f1b23df6d27.1ce25488.png","alt":"PayPal Apps & Credentials page with the Sandbox/Live toggle and REST API apps"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-2-copy-the-client-id-and-secret","__idx":3},"children":["Step 2: Copy the Client ID and Secret"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open your app. Copy the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and reveal and copy the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Secret"]},"."]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Keep your Secret safe","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Secret grants access to your account through the API. Treat it like a password and never expose it in client-side code or commit it to version control. You can add or delete secrets on the app page."]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/paypal-2.4047c230107ba0648459518deb011dea617d9de5967d07ffce4beabd1899fa1f.1ce25488.png","alt":"PayPal app page showing the Client ID and Secret key"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-3-enable-the-features-you-need","__idx":4},"children":["Step 3: Enable the features you need"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Scroll to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Features"]}," on the app page and enable the capabilities the integration should use — for example ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Invoicing"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Subscriptions"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payouts"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customer disputes"]},", and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transaction search"]},". PayPal grants only the matching scopes to tokens issued for the app, and drops the rest from the token without failing the request. A missing feature therefore does not stop the integration from connecting — it surfaces later, as a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NOT_AUTHORIZED"]}," error on the affected operation. If a tool fails that way, check this section first."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/paypal-3.ea1f2a4d6f6e08c87cc727e4b6b5876d280030454a2f40981ddcb519c305a6b7.1ce25488.png","alt":"PayPal app Features section with payment capabilities and add-on services"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configure-the-frontegg-portal","__idx":5},"children":["Configure the Frontegg portal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you have your credentials, configure the integration in the Frontegg portal:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Frontegg portal"]}," and navigate to [ENVIRONMENT] → Integrations → PayPal."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enable ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use sandbox environment"]}," only if you entered sandbox credentials. Leave it off for live credentials."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The integration requests the following scopes, granted through the app's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Features"]},". All scopes except ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["openid"]}," share the prefix ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://uri.paypal.com"]},", abbreviated as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["..."]}," below."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Scope"},"children":["Scope"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".../services/payments/realtimepayment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create and manage orders"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".../services/payments/payment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Attach and correct shipment tracking on orders"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".../services/payments/payment/authcapture"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authorize, capture, and reauthorize payments"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".../services/payments/refund"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Refund captured payments"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".../services/invoicing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create, send, and manage invoices"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".../services/subscriptions"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Manage subscriptions, plans, and products"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".../payments/payouts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Send payouts"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".../services/disputes/read-seller"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read disputes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".../services/disputes/update-seller"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Respond to disputes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".../services/reporting/search/read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search transactions and read account balances"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["openid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read the connected account's profile"]}]}]}]}]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Keep your credentials secure","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Never share or commit your Secret to version control."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additional-resources","__idx":6},"children":["Additional resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.paypal.com/api/rest/"},"children":["PayPal REST APIs"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.paypal.com/api/rest/authentication/"},"children":["PayPal REST API authentication"]}]}]}]},"headings":[{"value":"PayPal integration","id":"paypal-integration","depth":2},{"value":"Connect to PayPal","id":"connect-to-paypal","depth":3},{"value":"Step 1: Open Apps & Credentials","id":"step-1-open-apps--credentials","depth":4},{"value":"Step 2: Copy the Client ID and Secret","id":"step-2-copy-the-client-id-and-secret","depth":4},{"value":"Step 3: Enable the features you need","id":"step-3-enable-the-features-you-need","depth":4},{"value":"Configure the Frontegg portal","id":"configure-the-frontegg-portal","depth":3},{"value":"Additional resources","id":"additional-resources","depth":3}],"frontmatter":{"category":"Finance","displayName":"PayPal","seo":{"title":"PayPal integration"}},"lastModified":"2026-08-19T11:53:32.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/agen-for-work/connectors/marketplace/paypal","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}