--- 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. 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/terms-of-service) [Learn how to integrate our prebuilt UI components to accelerate your Capital integration process.](/capital/terms-of-service) [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)