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.

{
  "accountBid": "A123",
  "sun": "SUN123",
  "mandateId": "M123",
  "currency": "GBP",
  "amount": "1000",
  "representable": false,
  "collectionId": "K1234",
  "collectionStatus": "SUCCESS",
  "collectionDate": "2021-08-02",
  "mandateReference": "REFERENCE",
  "payer": {
    "name": "AccountName",
    "identifier": {
      "type": "SCAN",
      "accountNumber": "A12345678",
      "sortCode": "0123456"
    }
  },
  "ddDirection": "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.

{
  "accountBid": "A123",
  "sun": "SUN123",
  "mandateId": "M123",
  "currency": "GBP",
  "amount": "1000",
  "returnReason": "No account or incorrect account",
  "representable": false,
  "collectionId": "K1234",
  "collectionStatus": "FAILED",
  "collectionDate": "2021-08-02",
  "mandateReference": "REFERENCE",
  "payer": {
    "name": "AccountName",
    "identifier": {
      "type": "SCAN",
      "accountNumber": "A12345678",
      "sortCode": "0123456"
    }
  },
  "returnReasonCode": "NO_ACCOUNT",
  "ddDirection": "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