---
title: "Triggered when an automated direct debit is initiated."
method: POST
path: "/DIRECT_DEBIT_INITIATED"
---

# Triggered when an automated direct debit is initiated.

`POST /DIRECT_DEBIT_INITIATED`

This notification is sent when an automated direct debit is initiated from the Adyen platform.

## Request body

- DirectDebitInitiatedNotification
  - `content` DirectDebitInitiatedNotificationContent
    - `accountCode` string, required — The code of the account.
    - `amount` Amount, required
      - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
      - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
    - `debitInitiationDate` LocalDate
      - `month` integer
      - `year` integer
    - `invalidFields` ErrorFieldType[] — Invalid fields list.
      - `errorCode` integer — The validation error code.
      - `errorDescription` string — A description of the validation error.
      - `fieldType` FieldType
        - `field` string — The full name of the property.
        - `fieldName` 'accountCode' | 'accountHolderCode' | 'accountHolderDetails' | 'accountNumber' | 'accountStateType' | 'accountStatus' | 'accountType' | 'address' | 'bankAccount' | 'bankAccountCode' | 'bankAccountName' | 'bankAccountUUID' | 'bankBicSwift' | 'bankCity' | 'bankCode' | 'bankName' | 'bankStatement' | 'branchCode' | 'businessContact' | 'cardToken' | 'checkCode' | 'city' | 'companyRegistration' | 'constitutionalDocument' | 'country' | 'countryCode' | 'currency' | 'currencyCode' | 'dateOfBirth' | 'description' | 'destinationAccountCode' | 'document' | 'documentExpirationDate' | 'documentIssuerCountry' | 'documentIssuerState' | 'documentName' | 'documentNumber' | 'documentType' | 'doingBusinessAs' | 'drivingLicence' | 'drivingLicenceBack' | 'drivingLicense' | 'email' | 'firstName' | 'formType' | 'fullPhoneNumber' | 'gender' | 'hopWebserviceUser' | 'houseNumberOrName' | 'iban' | 'idCard' | 'idCardBack' | 'idCardFront' | 'idNumber' | 'identityDocument' | 'individualDetails' | 'jobTitle' | 'lastName' | 'legalArrangement' | 'legalArrangementCode' | 'legalArrangementEntity' | 'legalArrangementEntityCode' | 'legalArrangementLegalForm' | 'legalArrangementMember' | 'legalArrangementName' | 'legalArrangementReference' | 'legalArrangementRegistrationNumber' | 'legalArrangementTaxNumber' | 'legalArrangementType' | 'legalBusinessName' | 'legalEntity' | 'legalEntityType' | 'merchantAccount' | 'merchantCategoryCode' | 'merchantReference' | 'microDeposit' | 'name' | 'nationality' | 'originalReference' | 'ownerCity' | 'ownerCountryCode' | 'ownerHouseNumberOrName' | 'ownerName' | 'ownerPostalCode' | 'ownerState' | 'ownerStreet' | 'passport' | 'passportNumber' | 'payoutMethodCode' | 'personalData' | 'phoneCountryCode' | 'phoneNumber' | 'postalCode' | 'primaryCurrency' | 'reason' | 'registrationNumber' | 'returnUrl' | 'schedule' | 'shareholder' | 'shareholderCode' | 'shareholderCodeAndSignatoryCode' | 'shareholderCodeOrSignatoryCode' | 'shareholderType' | 'shopperInteraction' | 'signatory' | 'signatoryCode' | 'socialSecurityNumber' | 'sourceAccountCode' | 'splitAccount' | 'splitCurrency' | 'splitValue' | 'splits' | 'stateOrProvince' | 'status' | 'stockExchange' | 'stockNumber' | 'stockTicker' | 'store' | 'storeDetail' | 'storeName' | 'storeReference' | 'street' | 'taxId' | 'tier' | 'tierNumber' | 'transferCode' | 'unknown' | 'value' | 'verificationType' | 'virtualAccount' | 'visaNumber' | 'webAddress' | 'year' — The type of the field.
        - `shareholderCode` string — The code of the shareholder that the field belongs to. If empty, the field belongs to an account holder.
    - `merchantAccountCode` string, required — The code of the merchant account.
    - `splits` Split[] — The split data for the debit request
      - `account` string — Unique identifier of the account where the split amount should be sent. This is required if `type` is **MarketPlace** or **BalanceAccount**.
      - `amount` SplitAmount, required
        - `currency` string — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes). If this value is not provided, the currency in which the payment is made will be used.
        - `value` integer, required — The amount in [minor units](https://docs.adyen.com/development-resources/currency-codes).
      - `description` string — A description of this split.
      - `reference` string — Your reference for the split, which you can use to link the split to other operations such as captures and refunds. This is required if `type` is **MarketPlace** or **BalanceAccount**. For the other types, we also recommend sending a reference so you can reconcile the split and the associated payment in the transaction overview and in the reports. If the reference is not provided, the split is reported as part of the aggregated [TransferBalance record type](https://docs.adyen.com/reporting/marketpay-payments-accounting-report) in Adyen for Platforms.
      - `type` 'BalanceAccount' | 'Commission' | 'Default' | 'MarketPlace' | 'PaymentFee' | 'VAT' | 'Verification', required — The type of split. Possible values: **Default**, **PaymentFee**, **VAT**, **Commission**, **MarketPlace**, **BalanceAccount**.
    - `status` OperationStatus
      - `message` Message
        - `code` string — The message code.
        - `text` string — The message text.
      - `statusCode` string — The status code.
  - `eventType` string, required — The event type of the notification.
  - `executingUserKey` string, required — The user or process that has triggered the notification.
  - `live` boolean, required — Indicates whether the notification originated from the live environment or the test environment. If true, the notification originated from the live environment. If false, the notification originated from the test environment.
  - `pspReference` string, required — The PSP reference of the request from which the notification originates.

## Response `200`

OK - the request has succeeded.

- NotificationResponse
  - `notificationResponse` string — Set this parameter to **[accepted]** to acknowledge that you received a notification from Adyen.

## Changes

- **2021-05-22** (v3) `6cbb7c4c1415` — 3 info
  - added the new `shareholderCodeAndSignatoryCode` enum value to the request property `content/invalidFields/items/fieldType/fieldName`
  - added the new `shareholderCodeOrSignatoryCode` enum value to the request property `content/invalidFields/items/fieldType/fieldName`
  - added the new `signatoryCode` enum value to the request property `content/invalidFields/items/fieldType/fieldName`
- **2021-04-10** (v3) `583235080845` — 3 info
  - added the new `shopperInteraction` enum value to the request property `content/invalidFields/items/fieldType/fieldName`
  - added the new `signatory` enum value to the request property `content/invalidFields/items/fieldType/fieldName`
  - added the new `verificationType` enum value to the request property `content/invalidFields/items/fieldType/fieldName`
- **2021-03-05** (v3) `f1e00a7d736c` — 2 info
  - added the new optional request property `content/invalidFields`
  - added the new optional request property `content/splits`
- **2020-08-05** (v3) `d32ba44e5a85` — 1 breaking, 1 info
  - the response property `notificationResponse` became optional for the status `200`
  - api operation id `post-DIRECT_DEBIT_INITIATED` was added
- **2020-03-04** (v3) `00047a88de40` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/adyen/apis/marketpaynotificationservice/changes/DIRECT_DEBIT_INITIATED/post.md)

---

[API](https://skmtc.dev/adyen/apis/marketpaynotificationservice.md) · [All operations](https://skmtc.dev/adyen/apis/marketpaynotificationservice/llms.txt) · [OpenAPI document](https://skmtc.dev/adyen/apis/marketpaynotificationservice/revisions/6cbb7c4c1415?raw)