## BillingPlatform Finance integration

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.

Prerequisites
- A [BillingPlatform](https://billingplatform.com/) account with administrator access
- Permission to create OAuth 2.0 API clients in your BillingPlatform tenant


### Connect BillingPlatform Finance

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 **domain** (host) and the **organization** identifier, both taken from your BillingPlatform URL.

#### Step 1: Identify your domain and organization

Sign in to BillingPlatform and look at your browser's address bar. Your REST API URL has the form `https://<domain>/<organization>/rest/2.0`. From it, note:

- **Domain** — the host without the protocol, for example `acme.billingplatform.com` (production) or `acme-sandbox.billingplatform.com` (sandbox).
- **Organization** — the identifier in the URL path, for example `AcmeProd` from `https://acme.billingplatform.com/AcmeProd/rest/2.0`.


#### Step 2: Create an OAuth 2.0 client

In BillingPlatform, open the setup area and locate the **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.

BillingPlatform generates a **Client ID** and **Client Secret** for the client.

Copy your Client Secret now
The Client Secret is typically shown only once, when the client is created. Copy it immediately and store it securely.

### Configure the Frontegg portal

Once you have your **Client ID**, **Client Secret**, **domain**, and **organization**, configure the integration in the Frontegg portal:

1. Open the **Frontegg portal** and navigate to [ENVIRONMENT] → Integrations → BillingPlatform Finance.
2. Enter the **Client ID** and **Client Secret**.
3. Enter your **BillingPlatform domain** — the host only, without `https://` (for example, `acme.billingplatform.com`).
4. Enter your **Organization identifier** (for example, `AcmeProd`).
5. If you are connecting a sandbox tenant, enable the **Sandbox environment** toggle. This is an indicator only — enter the sandbox host directly in the domain field.
6. Select the **scopes** for the records your integration needs:


| Object | Scopes |
|  --- | --- |
| Payments | `payments:read`, `payments:write` |
| Credit memos | `creditmemos:read`, `creditmemos:write` |


1. Click **Save**.


Keep your credentials secure
Never share or commit your Client Secret to version control.

### Additional resources

- [BillingPlatform documentation portal](https://docs.billingplatform.com/home/en-us/)
- [BillingPlatform API access](https://get.billingplatform.com/api-access)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)