Bank file notification

Contis API service notifies the client about the bank file process related.

Table shows the parameters of notification about Bank file

PARAMETERS TYPE DESCRIPTION DEFAULT VALUE
NotificationType String Three-digit unique identifier of notification. Numeric value “050” denotes the bank file
notification.
Blank
AccountNumber String Eight-digit account number of the consumer. 00000000
SortCode String Six-digit number that identifies the branch of the bank where consumer holds account. Blank
WithdrawRequestNumber String Unique identifier of the Withdrawal request number.  
ReferenceNumber String Reference number used as any kind of references. Blank
Status String Two-digit unique identifier of the “status of the file process” before the status is
changed.
00
ErrorMessage String It is given any kind of transaction error messages. Blank
SecurityHash String String value generated through hash logic with all of the above parameters(To verify the values
posted on URL)
Blank

Lookup values for file process status

The table shows lookup values for bank file process status codes, e.g. value “16” denotes that a file is SendOut.

FILE PROCESS STATUS DESCRIPTION
00 None
01 Pending
02 Processed
03 Notified
04 Notification Not Required
05 Cancelled
06 ToBeCharged
07 ToBeProcess
08 GreyListUser
09 Requested
10 Unable to notify
11 InProgress
12 Diarised
13 PartiallyAccepted
14 OnHold
15 Rejected
16 SentOut
17 Settled
18 Settlement Reversal
19 Accepted
20 HighPriority
21 Directly Returned
22 Investigation
23 AccountDisabled
24 InsufficientFunds
25 InvalidAccount
26 InvalidCurrency
27 DebitPaymentDisabled
28 Reversed
29 Expired
30 Pending To close
31 ToBeClose
32 Closed
33 CC_Cash_Manager_Trade
34 CC_Funds_Arrived
35 CC_Trade_Settled
36 CC_Trade_Closed
37 TransactionHeld

Example of Bank file notification

PARAMETER NAME VALUE
NotificationType 050
AccountNumber 00118318
SortCode 608370
WithdrawRequestNumber 270219
ReferenceNumber “”
Status 16
ErrorMessage “”
SecurityHash df25e1be2fcba598cbf375c1a7661122

To generate the Security Hash :

Hash sequence : NotificationType&AccountNumber&SortCode&WithdrawRequestNumber&ReferenceNumber&Status&ErrorMessage

HashDataString : 050&00118318&608370&270219&&16&&
SecurityKey : abcdefghijklmnop
HashGenerationData : HashDataString + SecurityKey
Hash : df25e1be2fcba598cbf375c1a7661122

Note: In this example, the SecurityKey = is the “Hash PAN Key” provided to the client in the API configuration file.

JSON Example

{
   "NotificationType": "050",
   "AccountNumber": "00118318",
   "SortCode": "608370",
   "WithdrawRequestNumber": "270219",
   "ReferenceNumber": "",
   "Status": "16",
   "ErrorMessage": "",
   "SecurityHash": "df25e1be2fcba598cbf375c1a7661122"
}