Responses and error-handling
Every request processed through the SingleView APIs will have a response among the following:
HTTP Status | Description | Handling |
|---|---|---|
200 | Success |
|
4XX | Client side error | Spot the invalid parameters from the message and retry by entering valid details |
5XX | Internal/server error | Retry later |
SingleView uses two error-code categories:
ERRXXXX — Errors returned by the bankMW-XXX — Errors generated by the SingleView validation systemErrorCode | StatusDetail |
|---|---|
| An error has occurred. Please contact SingleView support. |
| Unauthorized to access the service |
| Invalid value date |
| Invalid BeneficiaryAccount |
| Payroll amount mismatch |
| Invalid basic salary |
| Invalid payment narrative/detail message |
| Payroll service subscription not found/not subscribed |
| Account blocked |
| Insufficient funds/balance |
| Invalid MOL/Establishment ID |
| Duplicate IBAN/account number |
| Empty/unknown bank response |
| Schema validation error |
| Invalid source account |
| Payment/file cancelled by bank or sender |
| Account/check-digit validation failed |
| Beneficiary details do not match |
| Bank connectivity error |
| Duplicate beneficiary account |
| File rejected |
| Invalid/missing signature |
| Account closed |
| Other bank reason |
| Unable to process |
| Payroll account/agreement is not registered |
| Language mismatch / unsupported language combination |
| Duplicate employee ID |
| Payroll transaction count mismatch |
| Duplicate payroll file |
| Invalid BeneficiaryAccountWithInstitutionBIC |
| Bank configuration/internal error |
| Duplicate reference |
| Payroll/service unavailable |
| Bank server timeout |
| Invalid deduction amount |
| Invalid transaction amount |
| Invalid input message |
| Payment pending for validation |
| Invalid other earning |
| Payer company/account closed |
| DateTimeStamp Should be today's date |
| Invalid CompanyCode |
| Timeout! Unable to get response from the bank. Please perform payment enquiry in few mins or contact SingleView support. |
| No result found for the requested reference number |
| Invalid BeneficiaryAddress Details |
| The beneficiary account is either inactive, blocked, or dormant. |
| Transaction rejected or returned by the beneficiary bank. Please contact the SingleView Support Team for further details. |
| Transaction rejected due to an invalid or mismatched currency code, unsupported account currency, or country/currency/BIC restriction. |
| The debit account is inactive, restricted, or not accessible to the user, or the transaction is not permitted for the account. |
| Bulk payment failed; transactions are rejected |
| Payment is being rejected |
| No transaction found for the requested reference number |
| Sequence number has already been used |
| Server is busy; please try again later |
| Sequence number must not exceed 16 characters |
| Transaction data contains invalid SWIFT characters |
| Issue with the payment transaction instruction |
| Invalid purpose code |
| Other scenarios to be handled and error codes to be released soon. |
| < |
| Other scenarios to be handled and error codes to be released soon. |
This error occurs when there is an issue with TLS handshake.
{
"error": "Client certificate and private key are required",
"message": "Ensure that the request includes the client certificate issued by Singleview along with the corresponding private key."
}This error occurs where there is an issue regarding connectivity to the SingleView APIs.
<html>
<head>
<title>504 Gateway Time-out</title>
</head>
<body>
<center>
<h1>504 Gateway Time-out</h1>
</center>
<hr>
<center>nginx</center>
</body>
</html>