---
title: "Webhook structures and types for Capital"
description: "Learn which webhooks Adyen sends for business financing-related events."
url: "https://docs.adyen.com/capital/webhook-types"
source_url: "https://docs.adyen.com/capital/webhook-types.md"
canonical: "https://docs.adyen.com/capital/webhook-types"
last_modified: "2026-06-01T15:33:15+02:00"
language: "en"
---

# Webhook structures and types for Capital

Learn which webhooks Adyen sends for business financing-related events.

[View source](/capital/webhook-types.md)

To keep track of business financing-related events in your balance platform, you can subscribe to the following webhook types:

* [Capital webhooks](https://docs.adyen.com/api-explorer/capital-webhooks/latest/overview): These notify your server of changes to grants at each stage of their lifecycle. The following webhooks are included:

  * **Capital dynamic offer webhook**
  * **Capital static offer webhook**
  * **Capital grant webhook**

* [Transfer webhooks](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/overview): These notify your server about incoming and outgoing transfers related to grants in your platform.

* [Transaction webhooks](https://docs.adyen.com/api-explorer/transaction-webhooks/latest/overview): These notify your server when grant funds are deposited into a user's balance or credited for grant repayment.

You can differentiate the events based on the `type`. Additionally, these webhooks include a `status` field that indicates the outcome of each event. To learn more about common webhook structure, see the [Platform webhooks documentation](/development-resources/webhooks/webhook-types#platforms-webhook-structure).

The following diagram outlines the types of webhooks you can expect during the grant lifecycle. Note that grant initiation status updates generate only capital notifications, not transfer or transaction notifications.

[![Grant lifecycle and webhooks](/user/pages/docs/07.capital/08.webhook-types/grant-lifecycle-and-webhooks.svg)](/user/pages/docs/07.capital/08.webhook-types/grant-lifecycle-and-webhooks.svg)

## Capital dynamic offer webhook

Use Capital dynamic offer webhook to get notified when [dynamic offers](/capital/get-grant-offers/dynamic-offers/) are created for account holders in your platform.

| Event type                                                                                                                                                    | Description                                                                                                         |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| [balancePlatform.capital.dynamicOffer.created](https://docs.adyen.com/api-explorer/capital-webhooks/latest/post/balancePlatform.capital.dynamicOffer.created) | After dynamic offers are created for an account holder, Adyen sends this webhook with information about the offers. |

## Capital static offer webhook

Use Capital static offer webhook to get notified when [static offers](/capital/get-grant-offers/static-offers/) are created for account holders in your platform.

| Event type                                                                                                                                                                              | Description                                                                                                        |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| [balancePlatform.balanceAccountHolder.capitalOffer.created](https://docs.adyen.com/api-explorer/capital-webhooks/latest/post/balancePlatform.balanceAccountHolder.capitalOffer.created) | After static offers are created for an account holder, Adyen sends this webhook with information about the offers. |

## Capital grant webhook

Use Capital grant webhooks to track [lifecycle of grants](/capital/grant-lifecycle-and-status) in your platform.

| Event type                                                                                                                        | Description                                                                                                |
| --------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| [balancePlatform.grants.created](https://docs.adyen.com/api-explorer/capital-webhooks/latest/post/balancePlatform.grants.created) | After a grant is created for an account holder, Adyen sends this webhook with information about the grant. |
| [balancePlatform.grants.updated](https://docs.adyen.com/api-explorer/capital-webhooks/latest/post/balancePlatform.grants.updated) | After a grant is updated for an account holder, Adyen sends this webhook with information about the grant. |

## Transfer webhook

Use Transfer webhooks to track the movement of funds, both incoming and outgoing, related to grants in your platform, from initiation to completion.

| Event type                                                                                                                             | Description                                                              |
| -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| [balancePlatform.transfer.created](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/post/balancePlatform.transfer.created) | Adyen sends this webhook when there are fund movements on your platform. |
| [balancePlatform.transfer.updated](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/post/balancePlatform.transfer.updated) | Adyen sends this webhook when the status of a transfer changes.          |

To identify Transfer webhooks triggered by grant-related events, review the following values:

| Parameter                                                                                                                                    | Description                                                                        | Value                                                                                                                                                |
| -------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| [category](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/post/balancePlatform.transfer.created#request-data-category)         | The category of the transfer.                                                      | **grants**                                                                                                                                           |
| [type](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/post/balancePlatform.transfer.created#request-data-type)                 | The type of the transfer.                                                          | * Grant disbursement: **grant**
* Regural grant repayment: **repayment**
* Unscheduled grant repayment: **capitalFundsCollection** and **repayment** |
| [direction](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/post/balancePlatform.transfer.created#request-data-direction)       | The direction of the transfer request from the perspective of the balance account. | - Grant disbursement: **incoming**
- Regural grant repayment: **outgoing**
- Unscheduled grant repayment: **incoming** and **outgoing**              |
| [counterparty](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/post/balancePlatform.transfer.updated#request-data-counterparty) | The other party in the transfer.                                                   | * **balanceAccountId**
* **transferInstrumentId**                                                                                                    |

## Transaction webhook

Use Transaction webhooks to confirm when grant funds are deposited into a user's balance or credited for grant repayment.

| Event type                                                                                                                                      | Description                                                                                                       |
| ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| [balancePlatform.transaction.created](https://docs.adyen.com/api-explorer/transaction-webhooks/latest/post/balancePlatform.transaction.created) | After a transfer is booked in a balance account, Adyen sends this webhook with information about the transaction. |

To identify Transaction webhooks triggered by grant-related events, review the following values:

| Parameter                                                                                                                                                      | Description                                  | Value                                                                   |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | ----------------------------------------------------------------------- |
| [transfer.id](https://docs.adyen.com/api-explorer/transaction-webhooks/latest/post/balancePlatform.transaction.created#request-data-transfer-id)               | The unique identifier of the transfer.       | Must correspond to the transfer ID created for the grant fund movement. |
| [transfer.reference](https://docs.adyen.com/api-explorer/transaction-webhooks/latest/post/balancePlatform.transaction.created#request-data-transfer-reference) | The reference from the `/transfers` request. | Must correspond to the grant ID listed in the related transfer.         |

## Next steps

[Grant lifecycle-related events](/capital/webhook-types/capital-webhooks)

[Learn which webhooks Adyen sends for updates on grant lifecycle.](/capital/webhook-types/capital-webhooks)

[Fund transfers-related webhooks](/capital/webhook-types/fund-transfers-webhooks)

[Learn which webhooks Adyen sends for updates on grant fund transfers.](/capital/webhook-types/fund-transfers-webhooks)
