Skip to main content

Make a request for a grant

post/grants

Make a request for a grant on behalf of an account holder.

Endpoint destination URL
Click to copy
amountobject

Contains information about the amount of the grant. This is the sum of the amounts of all the disbursements related to the grant.

counterpartyobject

Contains the details of the party that receives the grant. Setting either an accountHolderId, balanceAccountId, or both is required.

feeobject

Contains information about the fee that your user must pay for the grant. This is the sum of the fees of all the disbursements related to the grant.

grantAccountIdstringRequired

The unique identifier of the grant account that tracks this grant.

grantOfferIdstringRequired

The unique identifier of the selected grant offer. Adyen uses the details of the selected grant offer to create a grant.

repaymentobject

Contains information about the repayment configuration of the grant. By default, this repayment configuration applies to all the disbursements related to the grant.

After submitting a call, you receive a response message to inform you that your request was received and processed.

Depending on the HTTP status code of the response message, it is helpful to build some logic to handle any errors that a request or the system may return.

HTTP Responses

  • 200 - OK

    The request has succeeded.

  • 422 - Unprocessable Entity

    A request validation error.