Adyen-for-platform icon

Capital

Learn how to use Adyen Capital to build an embedded financing offering via API.

Request an invite

Interested to learn more about Adyen Capital? Fill out this form to let us know.

Adyen Capital allows you to build an embedded financing offering for your eligible users for their operational needs. With Adyen Capital, you can allow them to get business financing from Adyen that is completely integrated into your UI by using our APIs. We assess risks upfront and proactively create offers for your users. This allows your users to quickly get funds paid out to their balance account or transfer instrument, without the need for an additional application process.

Users repay daily based on a fixed percentage of their processed volume through Adyen. This way, they only repay as they earn and repayments do not impede their cash flow. In addition, users pay one transparent fixed fee — no interest and no hidden costs.

Account structure

Before you start building the integration, you need to understand the account structure of Adyen Capital as well as the general account structure of Adyen for Platforms.

Grant

We call a unit of business financing a grant. This is conceptually similar to the funds paid out to the user and the conditions they need to meet to repay the funds.

Grant account

For your balance platform, we create a new type of account — grant account. This account doesn't hold any funds and allows you to track the total amount of outstanding receivables that Adyen has towards the users on your balance platform. You can view the total of all outstanding grants on your balance platform on your grant account.

We assign one currency per grant account. If you need to offer grants in multiple currencies, you will need multiple grant accounts — one for each currency.

For example, if Adyen pays out five grants worth EUR 10,000 with a fee of EUR 1,000 each to your users, then this account will have a total of EUR 55,000.

The grant account has an ID starting with CG, for example, CG00000000000000000000001, where CG stands for Capital Grant Account.

Grant reference

For your users, we create a grant reference that has a one-to-one relationship with the grant. This means that every time a new grant is paid out, a new grant reference is created.

The grant reference tracks the total balance, the principal balance, and the fee balance to keep a record of the outstanding grant. The grant reference has an Active status until the grant is fully repaid. Once the grant is fully repaid, the grant reference is closed—status Repaid.

For example, if Adyen pays out a grant worth EUR 10,000 with a fee of EUR 1,000 to your user, then this reference will have a total of -EUR 11,000. The negative balance decreases as the user repays the grant until the balance is EUR 0.

The grant reference has an ID starting with GR, for example, GR00000000000000000000001.

Grant offers

Adyen does a proactive risk assessment of your user based on the user's payments data. This assessment results in a maximum of three grant offers that can be displayed to the user. When the user selects an offer and the relevant capabilities have been activated, the grant will be paid out.

Offers are only generated for the users that have met our eligibility criteria. To learn more about the eligibility criteria, reach out to your Adyen contact.

Payout

When the user selects a grant offer, you or the user can configure the grant to be paid out to the:

  • Balance account linked to their account holder.
  • Transfer instrument that belongs to the same legal entity as their account holder.

If you are paying out to a balance account, the funds stay within the balance platform. This might be beneficial if you are using Adyen Business Accounts.

In both cases, the funds are booked as incoming transfers to the balance account. In case of a payout to a transfer instrument, an outgoing transfer is automatically booked.

Repayment

To ensure consistent repayment of the grant, we reserve a fixed percentage from each incoming capture of the user. This reservation is deducted daily from net captured volume — captures minus refunds and chargebacks. In case the capture is refunded or charged back, we release the reservation on the day this refund or chargeback is booked.

At the end of the day, we trigger an outgoing transfer from the user's balance account for the entire reserved amount on the given day. This constitutes the real money repayment.

To keep track of the repayments, we calculate a threshold amount — the amount against which we monitor the repayment. If the total 30-day repayment drops below this threshold, we may take additional action to make sure that the user repays on time.

In some cases, we set a maximum term at which the user has to repay the entire grant and fee.

Request capabilities

Adyen Capital requires your user's account holder to have the following capabilities:

  • getGrantOffers: The user can get grant offers. After you have requested this capability, we will start checking the user against the eligibility criteria.
  • receiveGrants: The user can receive grants from Adyen. When activated, we check whether the account holder has signed the Terms of Service.

After the capability has been activated you receive a balancePlatform.accountHolder.updated webhook.

To learn how to request a capability for an account holder, see Manage account holders.

Get available grant offers

To get the grant offers available for your user, make a GET /grantOffers request with the accountHolderId as a query parameter:

Query parameter Required Description
accountHolderId -white_check_mark- The unique identifier of the receiving account holder.

The response contains the grantOffers object with the following parameters:

Parameter Description
accountHolderId The unique identifier of the receiving account holder.
amount An object containing the amount of the grant, in minor units.
contractType The legal type of the grant offer. Possible values: loan, cashAdvance.
expiresAt The expiring date of the offer validity period.
fee An object containing the fee currency and value, in minor units.
id The unique identifier of the grant offer.
repayment An object containing the details of the repayment configuration.
repayment.basisPoints The repayment that is deducted daily from incoming net volume, in basis points.
repayment.term.estimatedDays The estimated term for repaying the grant, in days.
repayment.term.maximumDays The maximum term for repaying the grant, in days. Only returned when contractType is loan.
repayment.threshold An object containing the details of the 30-day repayment threshold.
startsAt The starting date of the offer validity period.

The following example shows three grant offers of USD 500, USD 800, and USD 1000. The repayment rate is 7, 11, and 14 percent respectively with a 90-day expected term.

{
    "grantOffers": [
        {
            "accountHolderId": "AH00000000000000000000001",
            "amount": {
                "currency": "USD",
                "value": 50000
            },
            "contractType": "cashAdvance",
            "expiresAt": "2023-04-05T12:00",
            "fee": {
                "amount": {
                    "currency": "USD",
                    "value": 6200
                }
            },
            "id": "0000000000000001",
            "repayment": {
                "basisPoints": 700,
                "term": {
                    "estimatedDays": 90
                },
                "threshold": {
                    "amount": {
                        "currency": "USD",
                        "value": 12500
                    }
                }
            },
            "startsAt": "2023-03-29T15:46:06.990"
        },
        {
            "accountHolderId": "AH00000000000000000000001",
            "amount": {
                "currency": "USD",
                "value": 80000
            },
            "contractType": "cashAdvance",
            "expiresAt": "2023-04-05T12:00",
            "fee": {
                "amount": {
                    "currency": "USD",
                    "value": 10000
                }
            },
            "id": "0000000000000002",
            "repayment": {
                "basisPoints": 1100,
                "term": {
                    "estimatedDays": 90
                },
                "threshold": {
                    "amount": {
                        "currency": "USD",
                        "value": 20000
                    }
                }
            },
            "startsAt": "2023-03-29T15:46:06.990"
        },
        {
            "accountHolderId": "AH00000000000000000000001",
            "amount": {
                "currency": "USD",
                "value": 100000
            },
            "contractType": "cashAdvance",
            "expiresAt": "2023-04-05T12:00",
            "fee": {
                "amount": {
                    "currency": "USD",
                    "value": 12500
                }
            },
            "id": "0000000000000003",
            "repayment": {
                "basisPoints": 1400,
                "term": {
                    "estimatedDays": 90
                },
                "threshold": {
                    "amount": {
                        "currency": "USD",
                        "value": 25000
                    }
                }
            },
            "startsAt": "2023-03-29T15:46:06.990"
        }
    ]
}

Sign Terms of Service

The user must accept the Terms of Service (ToS) before Adyen can pay out the grant. Select type adyenCapital when you generate the ToS documents. After your user accepts the required Terms of Service, the receiveGrants capability is requested for them. You can choose to have your user accept the ToS either before or after receiving the grant offers.

If you are unable to generate the required Terms of Service documents, reach out to your Adyen contact

Request a grant

After the user selects the grant and signs the Terms of Service, make a POST /grants request to:

  • Create a new grant reference.
  • Pay out the grant.

Include the following parameters:

Parameter Required Description
counterparty.balanceAccountId The identifier of the balance account that belongs to the receiving account holder. Pass this parameter if you choose to pay out to the balance account of the user.
counterparty.transferInstrumentId The identifier of the transfer instrument that belongs to the legal entity of the account holder. Pass this parameter if you choose to pay out to the transfer instrument of the user.
grantAccountId -white_check_mark- The identifier of the grant account. Reach out to your Adyen contact to get this value.
grantOfferId -white_check_mark- The identifier of the grant offer that has been selected by the user.

If both balanceAccountId and transferInstrumentId are not provided in the request, the grant is paid out to the account holder's primaryBalanceAccount.

Here's an example of how to request a payout of a grant to the specified balance account.

The response contains the following parameters:

Parameter Description
id The identifier of the grant reference.
grantAccountId The identifier of the grant account used to account for the grant.
grantOfferId The identifier of the grant offer that has been selected by the receiving account holder.
counterparty An object containing the details of the receiving account holder.
amount An object containing the amount of the grant, in minor units.
fee An object containing the fee amount.
repayment An object containing the repayment amount and configuration, in basis points.
status The status of the grant.

Requests using POST /grants are processed asynchronously. You'll receive a response to your API request, but you must wait for the webhook to know the final result of a request.

Get updates

Adyen will send the following webhooks to your server to update you about the grant and payout status.

Webhook type Description
balancePlatform.grants.created The grant has been configured.
balancePlatform.grants.updated The grant has been fully repaid, reconfigured, or written off in case the user did not pay back all outstanding funds.
balancePlatform.transfer.created The outgoing or incoming grant transfer request has been received.
balancePlatform.transfer.updated The outgoing or incoming grant transfer request has been authorized and/or booked.
balancePlatform.transaction.created The funds have been paid out to the balance account or the payment instrument.

To keep track of webhooks, make sure that your server can receive and accept webhooks.

Get balances

You can get the balances of a single grant or all grants on your balance platform's grant account.

Get balances of one grant

To get the balance of a single grant:

  1. Make a GET /grants/{id} request and specify the following parameter in the path:

    Path parameter Description
    id The unique identifier of the grant reference received when requesting a grant.

    The response contains the following parameters:

    Parameter Description
    id The identifier of the grant reference.
    grantAccountId The identifier of the grant account used to account for the grant.
    grantOfferId The identifier of the grant offer that has been selected by the receiving account holder.
    counterparty An object containing the details of the receiving account holder.
    amount An object containing the amount of the grant, in minor units.
    fee An object containing the fee amount.
    repayment An object containing the repayment amount, in basis points.
    balances An object containing the details of the existing grant.
    status The status of the grant.

Get balances of all grants

To check the balances of all grants on your balance platform's grant account:

  1. Make a GET /grantAccounts/{id} request and specify the following parameter in the path:

    Path parameter Description
    id The unique identifier of the grant account received from your Adyen contact.

    The response contains the following parameters:

    Parameter Description
    id The unique identifier of the grant account.
    balances An object containing the details of all the existing grant(s) on your platform's grant account.
    limits An object containing the details about the maximum allowed total amount for all grants on this grant account.

Get all grants by account holder

You can get an overview of all the grants for a specific account holder, including the statuses. To do so:

  1. Make a GET /grants request and specify the following query parameter in the path:

    Query parameter Description
    counterpartyAccountHolderId The unique identifier of the counterparty account holder.

    The response contains the following parameters:

    Parameter Description
    id The identifier of the grant reference.
    grantAccountId The identifier of the grant account used to account for the grant.
    grantOfferId The identifier of the grant offer that has been selected by the receiving account holder.
    counterparty An object containing the details of the receiving account holder.
    amount An object containing the amount of the grant, in minor units.
    fee An object containing the fee amount.
    repayment An object containing the repayment amount, in basis points.
    balances An object containing the details of the existing grant.
    status The status of the grant.