{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-agen-for-work/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["Notification"]},"type":"markdown"},"seo":{"title":"BillingPlatform Finance 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":"billingplatform-finance-integration","__idx":0},"children":["BillingPlatform Finance integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["BillingPlatform is an enterprise billing and revenue management platform. The BillingPlatform Finance integration lets your application manage financial records — payments and credit memos — on behalf of your users through Frontegg's integration layer. It authenticates with BillingPlatform's REST API 2.0 using an OAuth 2.0 client credentials grant, so there is no user redirect: the gateway exchanges a Client ID and Client Secret directly for an access token against your tenant."]},{"$$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://billingplatform.com/"},"children":["BillingPlatform"]}," account with administrator access"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Permission to create OAuth 2.0 API clients in your BillingPlatform tenant"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connect-billingplatform-finance","__idx":1},"children":["Connect BillingPlatform Finance"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["BillingPlatform issues OAuth 2.0 credentials to an API client that you create in your tenant's setup area. You will also need two values that identify your tenant: the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["domain"]}," (host) and the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["organization"]}," identifier, both taken from your BillingPlatform URL."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-1-identify-your-domain-and-organization","__idx":2},"children":["Step 1: Identify your domain and organization"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sign in to BillingPlatform and look at your browser's address bar. Your REST API URL has the form ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://<domain>/<organization>/rest/2.0"]},". From it, note:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domain"]}," — the host without the protocol, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["acme.billingplatform.com"]}," (production) or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["acme-sandbox.billingplatform.com"]}," (sandbox)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Organization"]}," — the identifier in the URL path, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AcmeProd"]}," from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://acme.billingplatform.com/AcmeProd/rest/2.0"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-2-create-an-oauth-20-client","__idx":3},"children":["Step 2: Create an OAuth 2.0 client"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In BillingPlatform, open the setup area and locate the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth 2.0 client"]}," configuration (under the security / integration settings). Create a new OAuth client and associate it with an API user whose role grants access to payments and credit memos."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["BillingPlatform generates a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," for the client."]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Copy your Client Secret now","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Client Secret is typically shown only once, when the client is created. Copy it immediately and store it securely."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configure-the-frontegg-portal","__idx":4},"children":["Configure the Frontegg portal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you have your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["domain"]},", and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["organization"]},", 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 → BillingPlatform Finance."]},{"$$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":["Enter your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["BillingPlatform domain"]}," — the host only, without ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://"]}," (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["acme.billingplatform.com"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Organization identifier"]}," (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AcmeProd"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you are connecting a sandbox tenant, enable the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sandbox environment"]}," toggle. This is an indicator only — enter the sandbox host directly in the domain field."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["scopes"]}," for the records your integration needs:"]}]},{"$$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":"Object"},"children":["Object"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Scopes"},"children":["Scopes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payments"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payments:read"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payments:write"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Credit memos"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditmemos:read"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditmemos:write"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":7},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Keep your credentials secure","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Never share or commit your Client Secret to version control."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additional-resources","__idx":5},"children":["Additional resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.billingplatform.com/home/en-us/"},"children":["BillingPlatform documentation portal"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://get.billingplatform.com/api-access"},"children":["BillingPlatform API access"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/agen-for-work/connectors/redirect-url"},"children":["How to get your Redirect URL"]}]}]}]}]},"headings":[{"value":"BillingPlatform Finance integration","id":"billingplatform-finance-integration","depth":2},{"value":"Connect BillingPlatform Finance","id":"connect-billingplatform-finance","depth":3},{"value":"Step 1: Identify your domain and organization","id":"step-1-identify-your-domain-and-organization","depth":4},{"value":"Step 2: Create an OAuth 2.0 client","id":"step-2-create-an-oauth-20-client","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":"BillingPlatform Finance","seo":{"title":"BillingPlatform Finance integration"}},"lastModified":"2026-07-23T10:20:13.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/agen-for-work/connectors/marketplace/billingplatform-finance","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}