Send a direct debit request

post/debitAccountHolder

Sends a direct debit request to an account holder's bank account. If the direct debit is successful, the funds are settled in the accounts specified in the split instructions. Adyen sends the result of the direct debit in a DIRECT_DEBIT_INITIATED notification webhook.

To learn more about direct debits, see Top up accounts.

Endpoint destination URL
https://cal-test.adyen.com/cal/services/Fund/v5/debitAccountHolder
Click to copy

Request Parameters

accountHolderCodestringRequired

The code of the account holder.

amountobjectRequired

The amount to be debited from the account holder's bank account.

bankAccountUUIDstringRequired

The Adyen-generated unique alphanumeric identifier (UUID) of the account holder's bank account.

descriptionstring
Max length: 35

A description of the direct debit. Maximum length: 35 characters.

Allowed characters: a-z, A-Z, 0-9, and special characters /?:().,'+ ";.

merchantAccountstringRequired

Your merchant account.

splitsarray[object]Required

Contains instructions on how to split the funds between the accounts in your platform. The request must have at least one split item.

Response parameters

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.

    Show moreShow less
  • 202 - Accepted

    The request has been accepted for processing, but the processing has not been completed.

    Show moreShow less
  • 400 - Bad Request

    A problem reading or understanding the request.

    Show moreShow less
  • 401 - Unauthorized

    Authentication required.

    Show moreShow less
  • 403 - Forbidden

    Insufficient permissions to process the request.

    Show moreShow less
  • 422 - Unprocessable Entity

    A request validation error.

    Show moreShow less
  • 500 - Internal Server Error

    The server could not process the request.

    Show moreShow less