---
title: "Integration checklist"
description: "An overview of the steps from signing up for Capital to going live."
url: "https://docs.adyen.com/capital/integration-checklist"
source_url: "https://docs.adyen.com/capital/integration-checklist.md"
canonical: "https://docs.adyen.com/capital/integration-checklist"
last_modified: "2022-10-26T11:36:00+02:00"
language: "en"
---

# Integration checklist

An overview of the steps from signing up for Capital to going live.

[View source](/capital/integration-checklist.md)

This page explains the steps to integrate Adyen Capital into your existing [Adyen for Platforms](/adyen-for-platforms-model) integration.

## Requirements

Before you begin, take into account the following requirements, limitations, and preparations.

| Requirement          | Description                                                                                                                                                                                                                            |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Integration type** | You must have an [Adyen for Platforms](/adyen-for-platforms-model) integration.                                                                                                                                                        |
| **Limitations**      | Your user must operate in one of the [supported countries/regions](#supported-countriesregions).                                                                                                                                       |
| **Setup steps**      | Before you begin, make sure:- You [contacted us](https://www.adyen.com/contact/sales) to register your interest for Capital.
- You [designed your implementation](/capital/get-started#design-implementation) with your Adyen contact. |

## How it works

Integrating Capital consists of the following steps:

1. [Review your account structure](#review-account-structure)
2. [Complete the integration checklist for Adyen for Platforms](#complete-integration-adyen-for-platforms)
3. [Test your API keys](#test-api-keys)
4. [Set up webhooks](#set-up-webhooks)
5. [Implement Capital features](#implement-capital-features)
6. [Go live](#go-live)

## 1. Review your account structure

Before you start the integration process, you must be familiar with the [account structure for Capital](/capital/account-structure-resources). You need this information to building the different parts of your implementation.

Every integration that includes Capital must have at least the following resources:

* **Company account**: Represents your core business entity and holds your merchant accounts.
* **Merchant account**: The account where we process payments for your users. You can have multiple merchant accounts.
* **Balance platform**: The accounting system in which you manage your users and funds.
* **Account holder**: Specifies what your user can do in your platform, for example, receive fund transfers to their balance account and payouts to their verified transfer instrument (bank account).
* **Balance account**: Holds the funds of your user or your platform. All financial activities in your platform, such as paying out to a bank account, happen through balance accounts.
* **Legal entity**: Contains information about your user, for example, the legal name, address, and tax information of the organization. Adyen uses this information to perform verification checks required by payment industry regulations.
* **Transfer instrument**: Your user's verified bank account where they can receive payouts.
* **Grant account**: allows you to track the total amount of outstanding receivables that Adyen has in relation to grants in your balance platform.
* **Grant references**: tracks the balances related to specific grants. These references are created when a grant is paid out.

## 2. Complete the integration checklist for Adyen for Platforms

Before integrating Capital, you must complete the integration steps for either the [marketplace](/marketplaces/integration-checklist) or [platform](/platforms/integration-checklist) model of Adyen for Platforms.

## 3. Test your API keys

To make API requests related to Capital, you can use the same API credentials that you generated for your [marketplace](/marketplaces/integration-checklist/#generate-and-test-your-api-keys) or [platform](/platforms/integration-checklist/#generate-and-test-your-api-keys). If needed, you can [generate your API credentials](/capital/manage-access/#manage-api-credentials) and assign roles to them in your [Customer Area](https://ca-test.adyen.com/).

Make sure that you have the following API credentials and roles.

| API                                                                                                                                                                 | Credential                                                                                                                                                                                                       | Roles                                                                                                                                  |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| [Capital API](https://docs.adyen.com/api-explorer/capital/latest/overview) [Configuration API](https://docs.adyen.com/api-explorer/balanceplatform/latest/overview) | **ws\@BalancePlatform.\[YourBalancePlatform]** Use this API credential to make grant requests and disburse grants, create resources such as account holders and balance accounts, and request user capabilities. | * **Balance Platform BCL role**
* **Balance Platform Capital Configuration Role**
* **Balance Platform Capital Grant Initiation role** |
| [Legal Entity Management API](https://docs.adyen.com/api-explorer/legalentity/latest/overview)                                                                      | **ws\_\[123456]@Scope.Company\_\[YourCompanyAccount]** Use this API credential to create and manage legal entities that contain the information required for verification checks.                                |                                                                                                                                        |

## 4. Set up webhooks

Adyen sends webhooks to notify you of business financing-related events in your balance platform. For more details, see [Webhook structures and types for Capital](/capital/webhook-types).

To configure webhooks:

1. [Set up webhook endpoints](/development-resources/webhooks/#expose-an-endpoint-on-your-server) on your server and build the logic for acknowledging webhooks.
2. [Configure webhooks](/development-resources/webhooks/#set-up-webhooks-in-your-customer-area) in your Customer Area.
3. [Secure webhooks](/development-resources/webhooks/secure-webhooks/verify-hmac-signatures/) with HMAC signing.

## 5. Implement Capital features

You can implement Capital features in two ways:

* By using capital components
* By using the Capital API

### Tab: Components

To reduce implementation time and effort, use Adyen's prebuilt component libraries that you can integrate into your user interface.

To implement capital components:

1. **Create an authentication session from your server**\
   Create a session token to ensure secure communication between the component and the Adyen server.

2. **Install the component library in your front end**\
   Install the npm package, then import the library, component, and style sheet in your front-end application.

3. **Initialize the component**

   1. Gather the required information on the specific library and component you want to integrate.
   2. Create a DOM element on your user interface page where you want the component to be rendered.
   3. Add a function that calls your API to retrieve and refresh an authentication session token.
   4. Initialize the component and mount it to the DOM element you created.

4. **Customize the component(s)**\
   Customize the component to match your platform's look and feel.

### Tab: API

You can use our [Capital API](https://docs.adyen.com/api-explorer/capital/latest/overview) to build your own user interface for offering Capital.

As part of your API-only integration, you need to implement the necessary features to:

1. **Present available grant offers to your users**\
   Get personalized [grant offers](/capital/get-grant-offers/) and present them in your user interface for user selection.
2. **Show the Terms of Service to your users.**\
   Enable your users to digitally sign Adyen's [Terms of Service](/capital/terms-of-service/) in your user interface.
3. **Disburse grant amount to your user**\
   [Make a request](/capital/make-grant-request/) for the selected grant offer on behalf of your users.

## 6. Go live

To take your Capital integration live:

1. **Replicate your test account setup in your live account**: The Capital setup from your test account for Adyen for Platforms is *not* automatically replicated in your live account.

2. **Update your code base**

3. **Switch to live API credentials**\
   Get your live API credentials from your Adyen contact. Use these credentials in your live account.

4. **Switch from test to live endpoints**\
   Change the endpoints from `test` to `live`. For example, `https://balanceplatform-api-test.adyen.com/` to\
   `https://balanceplatform-api-live.adyen.com/`.

5. **Run end-to-end tests**

   * Live API credentials: Make your first live API requests to make sure that your live API credentials are working.
   * Grant account: Create a grant account in your live environment.
   * Grant offers: Confirm that you can get grant offers for users with the required [capability](/capital/manage-user-capabilities#capital-capabilities).
   * Pay out grants: Confirm that grant amounts are correctly paid out to the corresponding balance accounts or transfer instruments.
   * Webhooks: Confirm that you can receive and accept webhooks in the live environment.

## Next steps

[Integrate with components](/capital/capital-components)

[Learn how to integrate our prebuilt UI components to accelerate your Capital integration process.](/capital/capital-components)

[Integrate using APIs](/capital/make-grant-request)

[Learn how to use our APIs to build your Capital integration from scratch.](/capital/make-grant-request)

[Manage access for your team](/capital/manage-access)

[Learn how to manage your integration in your Customer Area.](/capital/manage-access)
