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"
}