View all balances available for your merchant account

get/balanceOverview/merchants/{merchantAccountCode}/balances

Returns an overview of the different balances available for the merchant account. This includes details about the following:

  • Available funds: The funds in the merchant account that have been settled and are available for use.

  • Pending balance: The funds in the merchant account that have not been settled yet.

  • Next payout amount: The amount that will be settled to your bank account with the next payout.

  • Reserve: The available amount to cover refunds, payouts, chargebacks, and other operational expenses that cannot be covered by your in-process funds.

  • Deposit: The amount withheld by Adyen to cover potential losses and liabilities due to payment processing.

Endpoint destination URL
currencystringRequired
Min length: 1

The currency for which you want a balances overview.

merchantAccountCodestringRequired

The unique identifier of your merchant account.

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.

  • 401 - Unauthorized

    Authentication required.

  • 403 - Forbidden

    Insufficient permissions to process the request.

  • 422 - Unprocessable Content

    A request validation error.