# Version control

v4.0 - 27th June 2024

Area Changes
All
  • Enum/codeset repository (opens new window) created on GitHub. OBL enums have been removed from namespaced enumeration page and participants should refer to this respository for values. Note, OBExternal* enum names have been updated to OBInternal*
  • New optional StatusReason array containing 0..*:
    • StatusReasonCode
    • Path
    • StatusReasonDescription
  • Sequence diagrams and consent status models updated with ISO values
  • Usage examples updated
All Alignment with ISO 20022:
  • ISO code names replaced by code value (e.g. AcceptedWithoutPosting is now ACWP)
  • Address fields aligned to ISO definition and rationalised into single address definition OBPostalAddress7.
  • LEI added to Creditor/Debtor/CreditorAgent objects
  • UltimateCreditor and UltimateDebtor added
  • MandateRelatedInformation added to DirectDebit and StandingOrder, this object replaces some fields from v3.1.11
  • RemittanceInformation object updated to ISO format, this replaces ‘reference’ in payment requests. The object name has been updated to OBRemittanceInformation2.
  • CreditorAccount & CreditorAgent now have the same (optional) fields across API endpoints
  • Proxy added to CreditorAccount/DebtorAccount (across AISP, PISP & CBPII)
AISP ISO 20022 changes
  • AccountType (OBExternalAccountType1Code) renamed to AccountCategory (OBInternalAccountType1Code)
  • AccountSubType renamed to AccountTypeCode
  • MORT (Mortgage) and WALT (Wallet) added to OBExternalAccountSubType1Code
  • Name added to Servicer in OBReadAccount6
  • StatementFrequencyAndFormat added to Account in OBReadAccount6
  • PaymentPurposeCode added to Transaction in OBReadTransaction6
  • CategoryPurposeCode added to Transaction in OBReadTransaction6
PISP ISO20022 changes
  • CategoryPurposeCode added to Risk object
  • RemittanceInformation added to payments
  • RegulatoryReporting added to payments
Errors
  • Simplified error object, top level Code and Message have been marked as optional and deprecated.
  • Error codes now in ISO 20022 code value format (4 chars) in the OBExternalStatusReason1Code enum
  • Additional guidance on errors experienced in the redirect flow or from PSU initiated changes
VRP
  • ContractPresentIndicator typo fixed
  • Added guidance on dynamic reference information for VRP payments
  • StatusReason now uses ExternalStatusReason1Code
  • To assist with version migration:
    • Introduced optional HTTP PUT/PATCH verbs for consents
    • Added payload version header
Payments
  • Updated payment message types information to include ISO 20022 changes, CHAPS migration and CBPR+
  • Richer payment status information aligned to ISO 20022 ExternalTransactionStatus1code
Various All 3.1.11 KI’s (opens new window) addressed
AISP
  • Added new ExtendedProprietaryBankTransactionCodes array to Transactions (TDA decision 264)
  • Permission code table updated with UltimateCreditor, UltimateDebtor and StatementFrequencyAndFormat
Various Frequency in OBMandateRelatedInformation1 object made mandatory
PISP CreditorAgent added to
  • Domestic Payment Consent
  • Domestic Payment
  • File payment Consents
  • File payment
Security Profile The Security Profile has been updated to FAPI 1 Advanced (opens new window)