Webhook - Direct Debit, DD Collection Status

Succesful Collections

The DDCollectionStatus event is triggered when the collection has reached Day 5 of the collection cycle and we consider the collection as successful.

{
  "Amount": "7.68",
  "EventId": "343a583e-e4e7-42f2-a77f-0e9f71cd07e2",
  "Currency": "GBP",
  "SortCode": "000000",
  "AccountId": "A120XYJ1",
  "EventName": "DDCOLLECTIONSTATUS",
  "EventTime": "2024-07-02T09:30:01+0000",
  "MandateId": "G2107Q0Y",
  "CustomerId": "",
  "AccountName": "ACCOUNT HOLDER",
  "CollectionId": "K21000544F",
  "AccountNumber": "70851219",
  "Representable": false,
  "CollectionDate": "2024-06-28",
  "CollectionStatus": "SUCCESS",
  "MandateReference": "KXMIRNBDRO",
  "ServiceUserNumber": "570832",
  "CollectionScheduleId": "Q21001A8",
  "DirectDebitDirection": "Inbound"
}

Unsuccesful Collections

The DDCollectionStatus event is triggered when Modulr receives an ARUDD (Automated return of unpaid Direct Debit). The collection amount will be returned to the Sending bank.

{
  "Amount": "9.11",
  "EventId": "2d7eed47-000f-4564-a434-72e9edb03a1c",
  "Currency": "GBP",
  "SortCode": "236972",
  "AccountId": "A210000C98",
  "EventName": "DDCOLLECTIONSTATUS",
  "EventTime": "2026-05-07T13:27:11+0100",
  "MandateId": "G21001CU",
  "CustomerId": "",
  "AccountName": "AUTOTESTACCOUNT",
  "CollectionId": "K2100001FP",
  "ReturnReason": "Refer to Payer",
  "AccountNumber": "01847171",
  "Representable": true,
  "CollectionDate": "2026-05-06",
  "CollectionStatus": "REPRESENTABLE",
  "MandateReference": "W4XM7J76",
  "ReturnReasonCode": "REFER_TO_PAYER",
  "ServiceUserNumber": "246248",
  "CollectionScheduleId": "Q21001A8",
  "DirectDebitDirection": "Inbound"
}

The table below shows the list of ARUDD reasons, Modulr's actions on the Mandate and Collection Schedule, and if they are Re-presentable (if retries are allowed).

Reason	`ReturnReasonCode`	Modulr Mandate Action	Modulr Collection Schedule Action	Representable?
Refer to Payer	`REFER_TO_PAYER`	No Action	No Action	Y
Instruction Cancelled	`INSTRUCTION_CANCELLED`	Cancel	Cancel	N
Payer Deceased	`PAYER_DECEASED`	Cancel	Cancel	N
Account Transferred	`ACCOUNT_TRANSFERRED`	Suspend	Suspend	N- Resubmission won't be changing anything on this collection, a New collection would have to be created with the updated details.
Advance Notice Disputed	`ADVANCE_NOTICE_DISPUTED`	Suspend	Suspend	Y
No account (Or wrong account type)	`NO_ACCOUNT`	Cancel	Cancel	N
No instruction	`NO_INSTRUCTION`	Cancel	Cancel	N
Amount Differs	`AMOUNT_DIFFERS`	Suspend	Suspend	Y
Amount not yet Due	`AMOUNT_NOT_DUE`	Suspend	Suspend	Y
Presentation overdue	`PRESENTATION_OVERDUE`	Suspend	Suspend	Y
Service user differs	`SERVICE_USER_DIFFERS`	Cancel	Cancel	N
Payer has closed their account for an unknown reason	`ACCOUNT_CLOSED`	Cancel	Cancel	N

Updated 18 days ago

Did this page help you?