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.
balancesobject
Contains information about the balances of the grant.
The grant amount that is paid out to the user for business financing.
totalinteger
The total amount of the grant that the user must repay. It is the sum of the fee amount and the principal amount.
counterpartyobject
Contains the details of the party that receives the grant.
accountHolderIdstring
The unique identifier of the account holder that receives the grant.
balanceAccountIdstring
The unique identifier of the balance account where the funds are disbursed. The balance account must belong to the specified account holder.
transferInstrumentIdstring
The unique identifier of the transfer instrument where the funds are disbursed. The transfer instrument must belong to the legal entity of the specified account holder.
grantAccountIdstring
The unique identifier of the grant account that tracks this grant.
grantOfferIdstring
The unique identifier of the selected grant offer. Adyen uses the details of the selected grant offer to create a grant.
idstring
The unique identifier of the grant reference.
statusobject
Contains the status of the grant.
actionsarray[object]
A list of actions that need to be completed to proceed with the grant.
actionCodestring
The code identifying the action that needs to be completed.
resolvedboolean
Indicates whether this action has been successfully completed.
code
The code for the status of the grant. Possible values:
Pending
Active
Repaid
WrittenOff
Failed
Revoked
Requested
Reviewing
Approved
Rejected
Cancelled
404 - Not Found
The entity was not found.
detailstring
A human-readable explanation specific to this occurrence of the problem.
errorCodestring
Unique business error code.
instancestring
A URI that identifies the specific occurrence of the problem if applicable.
invalidFieldsarray[object]
Array of fields with validation errors when applicable.
namestring
The field that has an invalid value.
valuestring
The invalid value.
messagestring
Description of the validation error.
requestIdstring
The unique reference for the request.
statusinteger
The HTTP status code.
titlestring
A short, human-readable summary of the problem type.
typestring
A URI that identifies the validation error type. It points to human-readable documentation for the problem type.
422 - Unprocessable Entity
A request validation error.
detailstring
A human-readable explanation specific to this occurrence of the problem.
errorCodestring
Unique business error code.
instancestring
A URI that identifies the specific occurrence of the problem if applicable.
invalidFieldsarray[object]
Array of fields with validation errors when applicable.
namestring
The field that has an invalid value.
valuestring
The invalid value.
messagestring
Description of the validation error.
requestIdstring
The unique reference for the request.
statusinteger
The HTTP status code.
titlestring
A short, human-readable summary of the problem type.
typestring
A URI that identifies the validation error type. It points to human-readable documentation for the problem type.