Direct Debit rejection notification

Provides notification of a Direct Debit reaction, including the reason for the rejection.

Direct Debit rejection notification parameters

Parameters	Type	Description
NotificationType	string	Three-digit identifier of the notification type. "053" denotes the Direct Debit rejection notification.
CompanyName	string	Name of the company.
AccountNumber	string	Eight-digit account number.
BankTypeCode	string	Unique identifier of the bank. Maximum 34 characters.
Amount	integer	The amount transferred through the Direct Debit.
CreatedDate	string	The date and time the Direct Debit order was created, in `yyyyMMddHHmmss` format.
RejectionReason	string	The reason the Direct Debit was rejected.
SecurityHash	string	Contains the hash of the payload values and your webhook security key, to verify the origin and integrity of the notification.

Example of Direct Debit rejection notification

Copy

Copied

{   
   "NotificationType" : "053", 
   "CustomerName" : "Customer",
   "CompanyName" : "SATP Creditor",
   "AccountNumber" : "00015526",
   "BankTypeCode" : "39600",
   "Amount" : "100",
   "CreatedDate" : "20170927213756",
   "RejectionReason" : "\"No fund available\" The account did not have sufficient funds\r\n",
   "SecurityHash" : "20712b3859734c4abd7c1a5e5b522198e8b182309529b456f09620000013b287"
}

Validating the notification security hash

Security Hash validation

See the respective guide for more information on calculating and verifying the notification security hash.

To compute the hash of the notification payload, concatenate the payload values in the following sequence, with your webhook security key as the final item:

Copy

Copied

<NotificationType>&<CustomerName>&<CompanyName>&<AccountNumber>&<BankTypeCode>&<Amount>&<CreatedDate>&<RejectionReason>&<webhook-security-key>

The payload values above and example webhook security key of abcdefghijklmnop, will produce the following hash input:

Copy

Copied

053&Customer&SATP Creditor&00015526&39600&100&20170927213756&"No fund available" The account did not have sufficient funds &abcdefghijklmnop