Error codes

This section contains the list of error codes. Please note that this is to give you an idea of possible error codes, but the actual number of error codes and messages may be different to the below list. Please make sure your application accepts and handles it dynamically and it is not hardcoded in the code.

Create Spot deal

Response  403 (DE:CreateDealValidator:0002)

        {
            "errorCode":"DE:CreateDealValidator:0002",
            "message":"QuoteId must be a valid guid",
            "errors": []
        }


 
 Response  403 (DE:CreateDealValidator:0003)

        {
            "errorCode": "DE:CreateDealValidator:0003",
            "message": "'Beneficiaries' should not be empty.",
            "errors": [
                {
                    "errorCode": "DE:CreateDealValidator:0003",
                    "fieldName": "Beneficiaries",
                    "message": "'Beneficiaries' should not be empty."
                }
            ]
        }


 
 Response  403 (DE:CreateDealValidator:0004)

        {
            "errorCode":"DE:CreateDealValidator:0004",
            "message":"FundingSouce is invalid",
            "errors": []
        }


 
 Response  403 (DE:CreateDealValidator:0005)

        {
            "errorCode":"DE:CreateDealValidator:0005",
            "message":"Please provide ordering customer information",
            "errors": []
        }



Response  403 (DE:CreateDealValidator:0006)

        {
            "errorCode":"DE:CreateDealValidator:0006",
            "message":"'Comment' must be between 0 and 500 characters.",
            "errors": []
        }


 
 Response  403 (DE:CreateDealValidator:0007)

        {
            "errorCode":"DE:CreateDealValidator:0007",
            "message":"Fee cannot be negative",
            "errors": []
        }


 
 Response  403 (DE:CreateDealValidator.Beneficiaries:0001)

        {
            "errorCode": "DE:CreateDealValidator.Beneficiaries:0001",
            "message": "'Beneficiary Id' should not be empty.",
            "errors": [
                {
                    "errorCode": "DE:CreateDealValidator.Beneficiaries:0001",
                    "fieldName": "Beneficiaries[0].BeneficiaryId",
                    "message": "'Beneficiary Id' should not be empty."
                }
            ]
        }


 
 Response  403 (DE:CreateDealValidator.Beneficiaries:0002)

        {
            "errorCode": "DE:CreateDealValidator.Beneficiaries:0002",
            "message": "'Amount' must be greater than '0'.",
            "errors": [
                {
                    "errorCode": "DE:CreateDealValidator.Beneficiaries:0002",
                    "fieldName": "Beneficiaries[0].Amount",
                    "message": "'Amount' must be greater than '0'."
                }
            ]
        }


 
 Response  403 (DE:DealUniqueBeneficiaryValidator:0001)

        {
            "errorCode":"DE:DealUniqueBeneficiaryValidator:0001",
            "message":"Beneficiaries must be unique",
            "errors": []
        }


 
 Response  403 (DE:CreateDealValidator.Customer:0001)

        {
            "errorCode":"DE:CreateDealValidator.Customer:0001",
            "message":"Customer.Title must not be empty string or have leading or trailing spaces",
            "errors": []
        }



 Response  403 (DE:CreateDealValidator.Customer:0002)

        {
            "errorCode":"DE:CreateDealValidator.Customer:0002",
            "message":"Customer.FirstName must not be empty or have leading or trailing spaces",
            "errors": []
        }



 Response  403 (DE:CreateDealValidator.Customer:0003)

        {
            "errorCode":"DE:CreateDealValidator.Customer:0003",
            "message":"Customer.MiddleName must not be empty string or have leading or trailing spaces",
            "errors": []
        }


 
 Response  403 (DE:CreateDealValidator.Customer:0004)

        {
            "errorCode":"DE:CreateDealValidator.Customer:0004",",
            "message":"Customer.LastName must not be empty or have leading or trailing spaces",
            "errors": []
        }


 
 Response  403 (DE:CreateDealValidator.Customer:0005)

        {
            "errorCode":"DE:CreateDealValidator.Customer:0005",
            "message":"Customer.CompanyName must not be empty string or have leading or trailing spaces",
            "errors": []
        }


 
 Response  403 (DE:CreateDealValidator.Customer:0006)

        {
            "errorCode":"DE:CreateDealValidator.Customer:0006",
            "message":"Customer.BranchName must not be empty string or have leading or trailing spaces",
            "errors": []
        }


 
 Response  403 (DE:CreateDealValidator.Customer:0007)

        {
            "errorCode":"DE:CreateDealValidator.Customer:0007",
            "message":"Customer.AccountNumber must not be empty or have leading or trailing spaces",
            "errors": []
        }


 
 Response  403 (DE:CreateDealValidator.Customer:0008)

        {
            "errorCode":"DE:CreateDealValidator.Customer:0008",
            "message":"Customer.Address1 must not be empty or have leading or trailing spaces",
            "errors": []
        }


 
 Response  403 (DE:CreateDealValidator.Customer:0009)

        {
            "errorCode":"DE:CreateDealValidator.Customer:0009",
            "message":"Customer.Address2 must not be empty string or have leading or trailing spaces",
            "errors": []
        }


 
 Response  403 (DE:CreateDealValidator.Customer:0010)

        {
            "errorCode":"DE:CreateDealValidator.Customer:0010",
            "message":"Customer.City must not be empty or have leading or trailing spaces",
            "errors": []
        }


 
 Response  403 (DE:CreateDealValidator.Customer:0011)

        {
            "errorCode":"DE:CreateDealValidator.Customer:0011",
            "message":"Customer.State must not be empty or have leading or trailing spaces",
            "errors": []
        }


 
 Response  403 (DE:CreateDealValidator.Customer:0012)

        {
            "errorCode":"DE:CreateDealValidator.Customer:0012",
            "message":"Customer.PostCode must not be empty or have leading or trailing spaces",
            "errors": []
        }


 
 Response  403 (DE:CreateDealValidator.Customer:0013)

        {
            "errorCode":"DE:CreateDealValidator.Customer:0013",
            "message":"Customer.CountryIsoCode must not be empty or have leading or trailing spaces",
            "errors": []
        }

Get Process Result

Response 200

        {
            "validation": {
                "errorCode": "DE:CreateDeal:0001",
                "message": "Sum of Beneficiary amounts is not equal to the deal amount",
                "errors": [
                    {
                        "errorCode": "DE:CreateDeal:0001",
                        "message": "Sum of Beneficiary amounts is not equal to the deal amount"
                    }
                ]
            }
        }

  
  
 
 Response 200

        {
            "validation": {
                "errorCode": "DE:CreateDeal:0002",
                "message": "Quote is stale",
                "errors": [
                    {
                        "errorCode": "DE:CreateDeal:0002",
                        "message": "Quote is stale"
                    }
                ]
            }
        }



Response 200

        {
            "validation": {
                "errorCode": "DE:CreateDeal:0003",
                "message": "Can not process deal, today is a closed date for the buy currency",
                "errors": [
                    {
                        "errorCode": "DE:CreateDeal:0003",
                        "message": "Can not process deal, today is a closed date for the buy currency"
                    }
                ]
            }
        }
    
  

  Response 200

        {
            "validation": {
                "errorCode": "DE:CreateDeal:0004",
                "message": "No of Beneficiaries should not be greater than 15",
                "errors": [
                    {
                        "errorCode": "DE:CreateDeal:0004",
                        "message": "No of Beneficiaries should not be greater than 15"
                    }
                ]
            }
        }



Response 200

        {
            "validation": {
                "errorCode": "BE:CreateDealBeneficiary:0004",
                "message": "User beneficiary belongs to a different user"
            }
        }



Response 200

        {
            "validation": {
                "errorCode": "BE:CreateDealBeneficiary:0005",
                "message": "Deal and user beneficiary must have the same currency"
            }
        }

Get Spot deal

Response 403

        {
            "errorCode": "DL:GetDeal:0001",
            "message": "Deal could not be found",
            "errors": [
                {
                    "fieldName": "DealId",
                    "errorCode": "DL:GetDeal:0001",
                    "nessage": "Deal could not be found"
                }
            ]
        }

Create Quote


Response 403 (QU:CreateQuote:0001)

        {
            "errorCode": "QU:CreateQuote:0001",
            "message": "Buy and Sell amount must be a number and at least one of them greater then Zero",
            "errors": [
                {
                    "fieldName": "BaseCurrency",
                    "errorCode": "QU:CreateQuote:0001",
                    "message": "Buy and Sell amount must be a number and at least one of them greater then Zero"
                }
            ]
        }


 
Response 403 (QU:CreateQuote:0004)

        {
            "errorCode": "QU:CreateQuote:0004",
            "message": "Buy and Sell amount can't be exchanged simultaneously",
            "errors": [
                {
                    "fieldName": "BaseCurrency",
                    "errorCode": "QU:CreateQuote:0004",
                    "message": "Buy and Sell amount can't be exchanged simultaneously"
                }
            ]
        }


 
Response 403 (QU:CreateQuote:0005)

        {
            "errorCode": "QU:CreateQuote:0005",
            "message": "Only a buy or a sell can be > 0",
            "errors": [
                {
                    "fieldName": "BaseCurrency",
                    "errorCode": "QU:CreateQuote:0005",
                    "message": "Only a buy or a sell can be > 0"
                }
            ]
        }


 
Response 403 (QU:CreateQuote:0006)

        {
            "errorCode": "QU:CreateQuote:0006",
            "message": "Buy currency is currently not supported",
            "errors": [
                {
                    "fieldName": "BaseCurrency",
                    "errorCode": "QU:CreateQuote:0006",
                    "message": "Buy currency is currently not supported"
                }
            ]
        }


 
Response 403 (QU:CreateQuote:0007)

        {
            "errorCode": "QU:CreateQuote:0007",
            "message": "Sell currency is currently not supported",
            "errors": [
                {
                    "fieldName": "BaseCurrency",
                    "errorCode": "QU:CreateQuote:0007",
                    "message": "Sell currency is currently not supported"
                }
            ]
        }


 
Response 403 (QU:CreateQuoteRequest:0011)

        {
        "errorCode":"QU:CreateQuoteRequest:0011",
        "message":"Stale data",
        "errors": []
        }


 
Response 403 (QU:CreateQuoteRequest:0012)

        {
        "errorCode":"QU:CreateQuoteRequest:0012",
        "message":"Failed to calculate the spot rate",
        "errors": []
        }


 
Response 403 (QU:CreateQuoteRequest:0013)

        {
        "errorCode":"QU:CreateQuoteRequest:0013",
        "message":"Buy currency is currently not supported",
        "errors": []
        }


 
Response 403 (QU:CreateQuote:0015)

        {
			"errorCode":"QU:CreateQuote:0015",
			"message":"Number of beneficiaries should be greater than 0 and a maximum of 15 is allowed",
			"errors": [
					{
						"fieldName": "Beneficiaries",
						"errorCode": "QU:CreateQuote:0015",
						"message": "Number of beneficiaries should be greater than 0 and a maximum of 15 is allowed"
					}
				]
        }


 
Response 403 (QU:CreateQuoteRequest:0019)

        {
        "errorCode":"QU:CreateQuoteRequest:0019",
        "message":"Error creating quote",
        "errors": []
        }


 
Response 403 (QU:CreateQuote:0008)

        {
            "errorCode":"QU:CreateQuote:0008",
            "message": "Buy amont is too large",
            "errors":[]
        }


 
Response 403 (QU:CreateQuote:0009)

        {
            "errorCode":"QU:CreateQuote:0009",
            "message":"Sell amount is too large",
            "errors":[]
        }


 
Response 403 (QU:CreateQuote:0010)

        {
            "errorCode":"QU:CreateQuote:0010",
            "message":"Buy amount must be equal or greater than 0",
            "errors":[]
        }


 
Response 403 (QU:CreateQuote:0011)

        {
            "errorCode":"QU:CreateQuote:0011",
            "message":"Sell amount must be equal or greater than 0",
            "errors":[]
        }


 
Response 403 (QU:CreateQuote:0012)

        {
            "errorCode":"QU:CreateQuote:0012",
            "message":"Buy currency cannot be empty",
            "errors":[]
        }


 
Response 403 (QU:CreateQuote:0013)

        {
            "errorCode":"QU:CreateQuote:0013",
            "message":"Sell currency cannot be empty",
            "errors":[]
        }


 
Response 403 (QU:CreateQuote:0015)

        {
            "errorCode":"QU:CreateQuote:0015",
            "message":"Sell currency must be different than buy currency",
            "errors":[]
        }

        
 
Response 403 (QU:CreateQuoteRequest:0020)

        {
            "errorCode":"QU:CreateQuoteRequest:0020",
            "message":"Failed to retrieve user",
            "errors":[]
        }

Get Quote

Response 403 (QU:GetQuote:0001)

        {
            "errorCode": "QU:GetQuote:0001",
            "systemMessage": "QuoteId must not be empty",
            "errors": [
                {
                    "fieldName": "BaseCurrency",
                    "errorCode": "QU:GetQuote:0001",
                    "systemMessage": "QuoteId must not be empty"
                }
            ]
        }


 
Response 403 (QU:GetQuote:0003)

        {
        "errorCode":"QU:GetQuote:0003",
        "systemMessage":"Failed to retrieve quote with id {0}",
        "errors": []
        }


 
Response 403 (QU:MinimumDealAmountRule:0001)

        {
        "errorCode":"QU:MinimumDealAmountRule:0001",
        "systemMessage":"Minimum deal amount for {SellCcy} is {minimumDealAmount}",
        "errors": []
        }


 
Response 403 (QU:SettlementLimitRule:0001)

        {
        "errorCode":"QU:SettlementLimitRule:0001",
        "systemMessage":"Buy currency is currently not supported",
        "errors": []
        }


 
Response 403 (QU:SettlementLimitRule:0002)

        {
        "errorCode":"QU:SettlementLimitRule:0002",
        "systemMessage":"Settlement limit has not been set",
        "errors": []
        }


 
Response 403 (QU:SettlementLimitRule:0003)

        {
        "errorCode":"QU:SettlementLimitRule:0003",
        "systemMessage":"No amount settled for this deal",
        "errors": []
        }


 
Response 403 (QU:SettlementLimitRule:0004)

        {
        "errorCode":"QU:SettlementLimitRule:0004",
        "systemMessage":"Settlement limit will be breached",
        "errors": []
        }


 
Response 403 (QU:SettlementLimitRule:0005)

        {
        "errorCode":"QU:SettlementLimitRule:0005",
        "systemMessage":"Settlement limit will be breached",
        "errors": []
        }

Create Beneficiaries

Response 403 (BE:BeneficiaryValidator:0001)

        {
        "systemMessage":"Please Provide Classification",
        "errorCode":"BE:BeneficiaryValidator:0001",
        "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0002)

        {
        "systemMessage":"Please Provide Name",
        "errorCode":"BE:BeneficiaryValidator:0002",
        "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0003)

        {
        "systemMessage":"Please Provide PaymentReason",
        "errorCode":"BE:BeneficiaryValidator:0003",
        "errors":[]
        }



 
Response 403 (BE:BeneficiaryValidator:0004)

        {
        "systemMessage":"Please Provide BeneficiaryBankDetails.BankAddress",
        "errorCode":"BE:BeneficiaryValidator:0004",
        "errors":[]
        }



 
Response 403 (BE:BeneficiaryValidator:0005)

        {
        "systemMessage":"Please Provide BeneficiaryBankDetails.BankAddress.Country",
        "errorCode":"BE:BeneficiaryValidator:0005",
        "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0006)

        {
        "systemMessage":"Please Provide BeneficiaryBankDetails.BankAddress.AddressLine",
        "errorCode":"BE:BeneficiaryValidator:0006",
        "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0007)

        {
        "systemMessage":"Please Provide BeneficiaryBankDetails.BankAddress.CitySuburb",
        "errorCode":"BE:BeneficiaryValidator:0007",
        "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0008)

        {
        "systemMessage":"Please Provide BeneficiaryBankDetails.BankAddress.StateProvince",
        "errorCode":"BE:BeneficiaryValidator:0008",
        "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0009)

        {
        "systemMessage":"Please Provide BeneficiaryBankDetails.BankAddress.PostCode",
        "errorCode":"BE:BeneficiaryValidator:0009",
        "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0010)

        {
        "systemMessage":"Please Provide BeneficiaryAddress",
        "errorCode":"BE:BeneficiaryValidator:0010",
        "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0011)

        {
        "systemMessage":"Please Provide BeneficiaryAddress.AddressLine",
        "errorCode":"BE:BeneficiaryValidator:0011",
        "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0012)

        {
        "systemMessage":"Please Provide BeneficiaryAddress.CitySuburb",
        "errorCode":"BE:BeneficiaryValidator:0012",
        "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0013)

        {
        "systemMessage":"Please Provide BeneficiaryAddress.Country",
        "errorCode":"BE:BeneficiaryValidator:0013",
        "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0014)

        {
        "systemMessage":"Please Provide BeneficiaryAddress.PostCode",
        "errorCode":"BE:BeneficiaryValidator:0014",
        "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0015)

        {
        "systemMessage":"Please Provide BeneficiaryAddress.StateProvince",
        "errorCode":"BE:BeneficiaryValidator:0015",
        "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0016)

        {
        "systemMessage":"Please Provide EntityType",
        "errorCode":"BE:BeneficiaryValidator:0016",
        "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0017)

        {
        "systemMessage":"Please Provide BenBizNumber",
        "errorCode":"BE:BeneficiaryValidator:0017",
        "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0018)

        {
        "systemMessage":"Please Provide Currency",
        "errorCode":"BE:BeneficiaryValidator:0018",
        "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0019)

        {
        "systemMessage":"Please Provide Alias",
        "errorCode":"BE:BeneficiaryValidator:0019",
        "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0020)

        {
        "systemMessage":"Please Provide Email",
        "errorCode":"BE:BeneficiaryValidator:0020",
        "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0022)

        {
        "systemMessage":"Please Provide BeneficiaryType",
        "errorCode":"BE:BeneficiaryValidator:0022",
        "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0023)

        {
        "systemMessage":"Please Provide BanReason",
        "errorCode":"BE:BeneficiaryValidator:0023",
        "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0024)

        {
        "systemMessage":"Please Provide BeneficiaryId",
        "errorCode":"BE:BeneficiaryValidator:0024",
        "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0025)

        {
            "systemMessage":"Please Provide BeneficiaryBankDetails.BranchName",
            "errorCode":"BE:BeneficiaryValidator:0025",
            "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0026)

        {
            "systemMessage":"Please Provide BeneficiaryBankDetails.Swift",
            "errorCode":" BE:BeneficiaryValidator:0026",
            "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0027)

        {
            "systemMessage":"Please Provide BeneficiaryBankDetails.Correspondent",
            "errorCode":" BE:BeneficiaryValidator:0027",
            "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0028)

        {
            "systemMessage":"Please Provide BeneficiaryBankDetails.PaymentReference",
            "errorCode":" BE:BeneficiaryValidator:0028",
            "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0029)

        {
            "systemMessage":"Please Provide BeneficiaryBankDetails.AccountSuffix",
            "errorCode":" BE:BeneficiaryValidator:0029",
            "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0030)

        {
            "systemMessage":"Please Provide BeneficiaryBankDetails.BankCode",
            "errorCode":" BE:BeneficiaryValidator:0030",
            "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0031)

        {
            "systemMessage":"Please Provide BeneficiaryBankDetails.BranchCode",
            "errorCode":" BE:BeneficiaryValidator:0031",
            "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0032)

        {
            "systemMessage":"Please Provide BeneficiaryBankDetails.AccountNo",
            "errorCode":" BE:BeneficiaryValidator:0032",
            "errors":[]
        }
 

 
Response 403 (BE:BeneficiaryValidator:0033)

        {
            "systemMessage":"Please Provide BeneficiaryBankDetails.BankName",
            "errorCode":" BE:BeneficiaryValidator:0033",
            "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0034)

        {
            "systemMessage":"Please Provide BeneficiaryBankDetails.BankCode",
            "errorCode":" BE:BeneficiaryValidator:0034",
            "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0035)

        {
            "systemMessage":"BeneficiaryBankDetails.BranchName must not be provided for credit card",
            "errorCode":" BE:BeneficiaryValidator:0035",
            "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0036)

        {
            "systemMessage":"BeneficiaryBankDetails.BranchCode must not be provided for credit card",
            "errorCode":" BE:BeneficiaryValidator:0036",
            "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0037)

        {
            "systemMessage":"BeneficiaryBankDetails.Swift must not be provided for credit card",
            "errorCode":" BE:BeneficiaryValidator:0037",
            "errors":[]
        }


 
Response 403 (BE:BeneficiaryValidator:0038)

        {
            "systemMessage":"BeneficiaryBankDetails.AccountSuffix must not be provided for credit card",
            "errorCode":" BE:BeneficiaryValidator:0038",
            "errors":[]
        }

Get Beneficiary

 Response 403 (BE:GetBeneficiary:0001)

        {
            "errorCode": "BE:GetBeneficiary:0001",
            "message": "Beneficiary {BeneficiaryId} could not be found",
            "errors": []
        }