Finance management

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.

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.

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:

X-PARTNER-APIKEY: {{partner_api_key}}
X-DC-DEVKEY: {{certcentral_api_key}}

Billing fallback

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

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.

Endpoints in this section

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.

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