Manage disbursements

Learn how to get and update configurations of a disbursement.

After the grant amount is disbursed to your user, you can retrieve information about a particular disbursement and update its configurations.

Requirements

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

Requirement	Description
Integration type	You must have an Adyen for Platforms integration with the Capital financial product enabled.
API credentials	You must have a Balance Platform API key (for example, ws[_123456]@BalancePlatform.[YourBalancePlatform]) to access the Capital API. Your API credential must have the following roles: Balance Platform Capital Configuration role Balance Platform Capital Grant Initiation role
Capabilities	Make sure that your user have the following capabilities: getGrantOffers receiveGrants
Limitations	Your user must operate in one of the supported countries/regions. Currently, only one disbursement per grant is allowed. We are working on enabling multiple disbursements to different balance accounts. Unscheduled repayments are only available for users operating in Europe, the United Kingdom, and the United States.
Setup steps	Before you begin, make sure: You reached out to your Adyen contact to set up the necessary configurations to add the Capital financial product to your integration. For more details, see our Integration checklist. You followed our compliance guidelines for Capital when creating user interfaces, marketing materials, and other processes. Your user selected a grant offer and signed the Terms of Service. You disbursed at least one grant.

Get all disbursements of a grant

To get all disbursements related to a grant:

Make a GET /grants/{grantId}/disbursements request with the receiving grantId as a query parameter.

In the response, note the following parameters:

Parameter	Description
accountHolderId	The unique identifier of the account holder that received the disbursement.
amount	An object containing the amount of the disbursement, in minor units.
balanceAccountId	The unique identifier of the balance account that received the disbursement.
balances	An object containing the balances of the disbursement.
fee	An object containing the fee that your user must pay for the disbursement.
fundsCollections	An object containing the accounts that Adyen uses to collect funds related to repayments.
grantId	The unique identifier of the grant related to the disbursement.
disbursementsId	The unique identifier of the disbursement.
repayment	An object containing the basis points configured for repaying the disbursement.

Update repayment configuration of a disbursement

You can update the repayment configuration of a specific disbursement. Specifically, you can change the percentage of your user's incoming net volume that is deducted for repaying the grant. To do this:

Make a PATCH /grants/{grantId}/disbursements/{disbursementId} request specifying the following parameters:

Parameter	Parameter type	Description
disbursementId	Path	The unique identifier of the disbursement.
grantId	Path	The identifier of the grant reference.
repayment	Request	An object containing the basis points configured for repaying the disbursement.

Here's an example of how to update the repayment configuration of a specific disbursement.

In the response, note the following parameters:

Parameter	Description
accountHolderId	The unique identifier of the account holder that received the disbursement.
amount	An object containing the amount of the disbursement, in minor units.
balanceAccountId	The unique identifier of the balance account that received the disbursement.
balances	An object containing the balances of the disbursement.
fee	An object containing the fee that your user must pay for the disbursement.
fundsCollections	An object containing the accounts that Adyen uses to collect funds related to repayments.
grantId	The unique identifier of the grant related to the disbursement.
disbursementId	The unique identifier of the disbursement.
repayment	An object containing the basis points configured for repaying the disbursement.

Retrieve bank account details for unscheduled repayments

Users can make unscheduled payments to repay their grant using the dedicated bank account details (for example, IBAN) assigned to each disbursement. You can retrieve these bank account details by making an API call. Then, you can share the information with your users.

To retrieve bank account details for a particular disbursement:

Make a GET /grants/{grantId}/disbursements/{disbursementId} request, specifying the following path parameters:

Parameter Required Description

disbursementId The unique identifier of the disbursement.

grantId The identifier of the grant reference.

In the response, note the fundsCollections object containing the following parameters:

Parameter	Description
fundsCollections.accountIdentification	An object containing the identification information of the account to which your user can transfer funds related to unscheduled repayments. For example, the international bank account number (IBAN).
fundsCollections.type	The type of funds collection. Must be set to UnscheduledRepayment.