---
title: "Finance management"
source_url: https://dev.digicert.com/partner-subscriptions-api/finance-management.html
---

Use the Finance Management endpoint to link a DigiCert CertCentral® billing account to the authenticated Partner Subscriptions account.

For an overview of the Partner Subscriptions API, see [Partner Subscriptions API](https://dev.digicert.com/md/partner-subscriptions-api.md).

## Why use it?

- Link a DigiCert CertCentral® billing account to the authenticated Partner Subscriptions account.
- Configure billing for a parent account or a subaccount.
- Use the parent account’s billing account as a fallback when a subaccount does not have its own linked DigiCert CertCentral® billing account.

## Resource URL

Use the Partner Subscriptions API finance resource URL to construct Finance Management requests.

```console
https://www.digicert.com/partner-subscription/api/v1/finance/
```

## Authentication and request headers

Finance Management endpoints require authentication with a Partner Subscriptions API key.

The account-link endpoint also requires a DigiCert CertCentral® API key for the billing account you want to link.

### Request headers
Include these headers in the request:
```http
X-PARTNER-APIKEY: {{partner_api_key}}
X-DC-DEVKEY: {{certcentral_api_key}}
```

<table>
<thead>
<tr>
<th>Header</th>
<th>Type</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>X-PARTNER-APIKEY</code></td>
<td>string</td>
<td>Yes</td>
<td>Partner Subscriptions API key for the authenticated Partner Subscriptions account.</td>
</tr>
<tr>
<td><code>X-DC-DEVKEY</code></td>
<td>string</td>
<td>Yes</td>
<td>DigiCert CertCentral® API key for the billing account you want to link.</td>
</tr>
</tbody>
</table>


> **Info**
>
> A Partner Subscriptions API key is separate from a DigiCert CertCentral® API key. Partner Subscriptions API requests use the `X-PARTNER-APIKEY` header. DigiCert CertCentral® API requests use the `X-DC-DEVKEY` header.
>
> For the account-link endpoint, you must include both headers.


## Billing fallback

If a subaccount does not have a linked DigiCert CertCentral® billing account, it uses the parent account’s billing account.

> **Info**
>
> To configure billing for a subaccount independently, authenticate with that subaccount’s Partner Subscriptions API key in the `X-PARTNER-APIKEY` header and provide the DigiCert CertCentral® API key for the billing account in the `X-DC-DEVKEY` header.


## Billing and account linking

Every Partner Subscription is linked to a CertCentral account for billing. The pricing applied to your subscriptions is determined by the contract associated with the linked CertCentral account.

You can link a Partner Subscription account in one of the following ways:

1. Link the Partner Subscription account to your parent partner CertCentral account.
2. Link a Partner Subscription subaccount to the parent CertCentral account.
3. Link a Partner Subscription subaccount to a specific CertCentral subaccount.

### How pricing works for subaccounts

* If a Partner Subscription subaccount is not linked to its own billing account, it inherits the billing configuration of the parent account. In this case, the subaccount receives the parent account’s contract pricing.
* If a Partner Subscription subaccount is linked to a CertCentral account that does not have a contract, products purchased through that subaccount are billed at standard retail pricing.


> **Info**
>
> To ensure correct pricing, always link your Partner Subscription account or subaccount to the CertCentral account that holds your contract pricing.


## Endpoints in this section

<table>
<thead>
<tr>
<th>Method</th>
<th>Endpoint</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>PUT</code></td>
<td><code>/finance/account-link</code></td>
<td>Link a DigiCert CertCentral® billing account to the authenticated Partner Subscriptions account.</td>
</tr>
</tbody>
</table>

The endpoint uses the DigiCert CertCentral® API key provided in the `X-DC-DEVKEY` header to identify the billing account, then links it to the Partner Subscriptions account authenticated by the `X-PARTNER-APIKEY` header.


> **Warning**
>
> Make sure the DigiCert CertCentral® API key in the `X-DC-DEVKEY` header belongs to the billing account you want to link. If the API key cannot be resolved to a valid account, the request returns an error.


## Requests

Finance Management requests use RESTful URLs and header-based authentication.

### Method

Finance Management uses this standard HTTP method:

- `PUT`

## Responses

On success, the account-link endpoint returns `204 No Content`.

### Common response codes

<table>
<thead>
<tr>
<th>Status code</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>204 No Content</code></td>
<td>Billing account linked successfully.</td>
</tr>
<tr>
<td><code>400 Bad Request</code></td>
<td>The request is missing required headers, includes invalid headers, or the provided DigiCert CertCentral® API key could not be resolved to a valid account.</td>
</tr>
<tr>
<td><code>401 Unauthorized</code></td>
<td>Authentication failed. Check the Partner Subscriptions API key or DigiCert CertCentral® API key.</td>
</tr>
<tr>
<td><code>403 Forbidden</code></td>
<td>Access denied.</td>
</tr>
</tbody>
</table>

## In this section

- [Link CertCentral billing account](https://dev.digicert.com/md/partner-subscriptions-api/finance-management/link-cc-billing-account.md)