Read/Write API Specification – Standard Error Codes
HTTP Status Category Code Description
400 UK.OBIE.Field.Expected For the scenario, when a field-value is not provided in the payload, that is expected in combination with preceding field-value pairs.
The corresponding path must be populated with the path of the unexpected field.
e.g. ExchangeRate must be specified with Agreed RateType. ExchangeRate should be specified in the path element.InstructionPriority must be specified with Agreed RateType. InstructionPriority should be specified in the path element.
400 UK.OBIE.Field.Invalid An invalid value is supplied in one of the fields. Reference of the invalid field should be provided in the path field, and url field may have the link to a website explaining the valid behaviour. The error message should describe the problem in detail.
400 UK.OBIE.Field.InvalidDate An invalid date is supplied, e.g., When a future date is expected, a date in past or current date is supplied. The message can specify the actual problem with the date. The reference of the invalid field should be provided in the path field, and URL field may have the link to a website explaining the valid behaviour.
400 UK.OBIE.Field.Missing A mandatory field, required for the API, is missing from the payload. This error code can be used, if it is not already captured under the validation for UK.OBIE.Resource.InvalidFormat.
Reference of the missing field should be provided in the path field, and URL field may have the link to a website explaining the valid behaviour.
400 UK.OBIE.Field.Unexpected For the scenario, when a field-value is provided in the payload, that is not expected in combination with preceding field-value pairs. E.g. ContractIdentification must not be specified with [Actual/Indicative] RateType. ContractIdentification should be specified in the path elementExchangeRate must not be specified with [Actual/Indicative] RateType. ExchangeRate should be specified in the path element.InstructionPriority must not be specified with LocalInstrument. InstructionPriority should be specified in the path element.
400 UK.OBIE.Header.Invalid An invalid value is supplied in the HTTP header. HTTP Header should be specified in the path element.
400 UK.OBIE.Header.Missing A required HTTP header has not been provided. HTTP Header should be specified in the path element.
400 UK.OBIE.Resource.ConsentMismatch {payment-order-consent} and {payment-order} resource mismatch. For example, if an element in the resource’s Initiation or Risk section does not match the consent section.
The path element should be populated with the field of the resource that does not match the consent.
400 UK.OBIE.Resource.InvalidConsentStatus The resource’s associated consent is not in a status that would allow the resource to be created. E.g., if a consent resource had a status of AwaitingAuthorisation or Rejected, a resource could not be created against this consent.
The path element should be populated with the field in the consent resource that is invalid.
400 UK.OBIE.Resource.InvalidFormat When the Payload schema does not match to the endpoint, e.g., /domestic-payments endpoint is called with a JSON Payload, which cannot be parsed into a class OBWriteDomestic1
400 UK.OBIE.Resource.NotFound Returned when a resource with the specified id does not exist (and hence could not be operated upon).
400 UK.OBIE.Rules.AfterCutOffDateTime {payment-order} consent / resource received after CutOffDateTime
400 UK.OBIE.Signature.Invalid The signature header x-jws-signature was parsed and has a valid JOSE header that complies with the specification. However, the signature itself could not be verified.
400 UK.OBIE.Signature.InvalidClaim The JOSE header in the x-jws-signature has one or more claims with an invalid value. (e.g. a kid that does not resolve to a valid certificate). The name of the missing claim should be specified in the path field of the error response.
400 UK.OBIE.Signature.MissingClaim The JOSE header in the x-jws-signature has one or more mandatory claim(s) that are not specified. The name of the missing claim(s) should be specified in the path field of the error response.
400 UK.OBIE.Signature.Malformed The x-jws-signature in the request header was malformed and could not be parsed as a valid JWS.
400 UK.OBIE.Signature.Missing The API request expected an x-jws-signature in the header, but it was missing.
400 UK.OBIE.Signature.Unexpected The API request was not expecting to receive an x-jws-signature in the header, but the TPP made a request that included an x-jws-signature.
400 UK.OBIE.Unsupported.AccountIdentifier The account identifier is unsupported for the given scheme.
The path element should be populated with the path of the AccountIdentifier.
400 UK.OBIE.Unsupported.AccountSecondaryIdentifier The account secondary identifier is unsupported for the given scheme.
The path element should be populated with the path of the AccountSecondaryIdentifier.
400 UK.OBIE.Unsupported.Currency The currency is not supported. Use UK.OBIE.Field.Invalid for invalid Currency.
The path element should be populated with the path of the Currency.
The URL should be populated with a link to ASPSP documentation listing out the supported currencies.
400 UK.OBIE.Unsupported.Frequency Frequency is not supported.
The path element should be populated with the path of the Frequency.
The URL should be populated with a link to ASPSP documentation listing out the supported frequencies.
400 UK.OBIE.Unsupported.LocalInstrument Local Instrument is not supported by the ASPSP.
The path element should be populated with the path of the LocalInstrument.
The URL should be populated with a link to ASPSP documentation listing out the supported local instruments.
400 UK.OBIE.Unsupported.Scheme Identification scheme is not supported.
The path element should be populated with the path of the scheme.
The URL should be populated with a link to ASPSP documentation listing out the supported schemes.
5xx UK.OBIE.UnexpectedError An error code that can be used, when an unexpected error occurs.
The ASPSP must populated the message with a meaningful error description, without revealing sensitive information.