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",
  "DirectDebitDirection": "Inbound"
}

Unsuccesful Collections

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

{
  "Amount": "7.68",
  "EventId": "ff838f2d-4200-46bf-a011-8a00d3a4f8f1", 
  "Currency": "GBP", 
  "SortCode": "000000", 
  "AccountId": "A120XYJ1", 
  "EventName": "DDCOLLECTIONSTATUS", 
  "EventTime": "2024-07-02T09:16:03+0000", 
  "MandateId": "G2107Q0Y", 
  "CustomerId": "", 
  "AccountName": "ACCOUNT HOLDER", 
  "CollectionId": "K21000544F", 
  "ReturnReason": "Instruction Cancelled", 
  "AccountNumber": "70851219", 
  "Representable": false, 
  "CollectionDate": "2024-07-01", 
  "CollectionStatus": "FAILED", 
  "MandateReference": "KXMIRNBDRO", 
  "ReturnReasonCode": "INSTRUCTION_CANCELLED", 
  "ServiceUserNumber": "570832", 
  "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	Modulr Mandate Action	Modulr Collection Schedule Action	Representable?
Refer to Payer	No Action	No Action	Y
Instruction Cancelled	Cancel	Cancel	N
Payer Deceased	Cancel	Cancel	N
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	Suspend	Suspend	Y
No account(Or wrong account type)	Cancel	Cancel	N
No instruction	Cancel	Cancel	N
Amount Differs	Suspend	Suspend	Y
Amount not yet Due	Suspend	Suspend	Y
Presentation overdue	Suspend	Suspend	Y
Service user differs	Cancel	Cancel	N
Payer has closed their account for an unknown reason	Cancel	Cancel	N