01 Apr 08:29

cjrobbertse-ob

fd33a35

v4.0.1 Latest

Latest

Version History

For v4.0.1 the following approach has been adopted for identifying changes:

Known Issues - these are tagged with the KI identifier, e.g. [v40_KI45]
Change Requests - these are tagged with the CR number used in the consultations, e.g. [CR4a]
EAG/Consultation items - Items included in the consultations are tagged with an identifier representing the consultation period they were introduced, e.g. [v4.0.1 RC 1]
Feedback remediation - Technical errata and other minor corrections identified by participants or OBL during the Advanced Information period for Release Candidates 1 and 2 with an appropriate identifier for internal OBL traceability e.g. [CDRW-5006]

Consultations:

v4.0.1 - 2026-04-01

Added

[v40_KI45] Added LWMH, LXMH, and TWYR to OBFrequency6Code in OBInternal
[v40_KI46] Added NONE and SLCT to OBFrequency2Code in OBInternal
[CR1] Added to OBInternalStatementFeeType1Code:
- UK.OBIE.InstalmentPlan
- UK.OBIE.ReturnedPayment
[CR1] Added to OBInternalStatementInterestType1Code:
- UK.OBIE.InstalmentPlan
- UK.OBIE.MoneyTransfer
[CR4a] Added CRYP to ExternalPurpose1Code
[CR2] Introduced OBIntermediaryAgentStatus1Code in OB_Internal_Codeset. This is used for
OBIntermediaryAgent/ProcessingStatus and has the following codes:
- PDNG
- RCVD
- ACSP
- ACSC
- RJCT
- UNKN
- CANC

Changed

[CR4a] Updated Code Name and description of CRYP to match ISO 20022 approved entry. Code Name was previously CryptoTransaction and is now CryptoAssets. Description has been updated to reflect this change.
[CDRW-5007] Updated ISO 20022 External Codeset files to Q3 2025 release.
[CR4a] Updated description for CRYP code to "Transaction is related to the purchase or sale of cryptocurrency."
[CDRW-5002] Enhanced the descriptions of current OBInternalPaymentContext1Code codes BillingGoodsAndServicesInAdvance, BillingGoodsAndServicesInArrears, EcommerceMerchantInitiatedPayment, FaceToFacePointOfSale, TransferToSelf, TransferToThirdParty
[v40_KI39] Updated description of U037 in OBExternalStatusReason1Code to "Authorisation failed by one (or more) of the authenticators." (#7)
[v4.0.1 Draft 1] Separated OBInternalConsentStatus1Code into 3 codesets for certain contexts (#17):
- Removed COND & AWUP from OBInternalConsentStatus2Code
- Added OBInternalConsentStatus2Code to OB_Internal_Codeset.csv with the following values:
  - AWAU
  - RJCT
  - AUTH
  - COND
- Added OBInternalConsentStatus3Code to OB_Internal_Codeset.csv with the following values:
  - AWAU
  - RJCT
  - AUTH
  - COND
  - AWUP
[v4.0.1 Draft 1] Separated ExternalPaymentTransactionStatus1Code into 5 codesets for specific contexts (#16). New Codes look like:
- ExternalPaymentTransactionStatus1Code (16 codes) for Domestic Standing Orders & International Standing Orders:
  - CANC
  - RCVD
  - ACTC
  - PATC
  - PDNG
  - RJCT
  - INFA
  - INCO
  - ACCP
  - ACFC
  - ACSP
  - ACWC
  - ACSC
  - BLCK
  - ACCC
  - ACWP
- ExternalPaymentTransactionStatus2Code (14 codes) for Domestic Scheduled Payments and International Scheduled Payments:
  - CANC
  - RCVD
  - PDNG
  - ACTC
  - PATC
  - ACCP
  - ACFC
  - ACSP
  - ACWC
  - ACSC
  - BLCK
  - ACCC
  - ACWP
  - RJCT
- ExternalPaymentTransactionStatus3Code (13 codes) for Domestic Payments and International Payments:
  - RCVD
  - PDNG
  - ACTC
  - PATC
  - ACCP
  - ACFC
  - ACSP
  - ACWC
  - ACSC
  - BLCK
  - ACCC
  - ACWP
  - RJCT
- ExternalPaymentTransactionStatus4Code (3 codes) for File Payments:
  - PDNG
  - INFA
  - INCO
- ExternalPaymentTransactionStatus5Code (12 codes) for Domestic VRPs:
  - RCVD
  - PDNG
  - ACTC
  - ACCP
  - ACFC
  - ACSP
  - ACWC
  - ACSC
  - BLCK
  - ACCC
  - ACWP
  - RJCT

Removed

[CDRW-4860] Removed duplicate ExternalMandateStatus1Code codes (#12)
[v40_KI43] Removed deprecated OBExternalStatus3Code (#13)

Fixed

[CDRW-5006] Fixed typo in OBExternalStatusReason1Code U003 description
[CDRW-5047] Fixed the following typographical issues:
- Corrected capitalisation of ProForma in OBInternalAccountStatus1Code
- Removed unnecessary n from the end of ANNI description
- Fixed spelling of 'related' in DEPT
- Removed additional whitespace from end of OBExternalCommunicationMethod2Code
- Removed additional whitespace from end of Enabled
- Removed additional whitespace from the end of Annual
- Removed duplicate BusinessCurrentAccount entry.
[CDRW-5071] Updated INFA and INCO code descriptions in ExternalPaymentTransactionStatus4Code to be File Payment specific.
[CDRW-5072] Fixed typographical and structural errors in OB_Internal_Codeset:
- Corrected UK.OBIE.BACS Code Definition from "Back Payment Scheme" to "BACS Payment Scheme" in OBInternalLocalInstrument1Code
- Fixed Multiple in OBInternalAuthorisation1Code: moved description text from Code Name column to Code Definition column; Code Name is now Multiple (consistent with Any and Single)
- Removed trailing space from Actual Code Value and Code Name in OBInternalExchangeRateType2Code
- Removed trailing spaces from Code Names of EMAL, FAXI, ONLI, and POST in OBExternalCommunicationMethod2Code
- Removed trailing space from Available Code Name in OBInternalLimitType1Code
- Fixed grammar in U000 Code Definition: "to specific" corrected to "to specify" in OBExternalStatusReason1Code
- Fixed grammar in U041 Code Definition: "could not applied" corrected to "could not be applied" in OBExternalStatusReason1Code
- Corrected MORT Code Name from "Mortgage Account" to "MortgageAccount" in OBExternalCashAccountType1Code
- Added missing terminal period to CISH and MORT Code Definitions in OBExternalCashAccountType1Code
- Fixed capitalisation in UK.OBIE.MoneyTransfer Code Definition: "To Indicate" corrected to "To indicate" in OBInternalLocalInstrument1Code
[CDRW-4775] Codesets are now contiguous and organized alphabetically
[CDRW-4775] Several descriptions have been moved out of the codeset name column and into the description column
[CDRW-4906] Corrected OBExternalStatusReason1Code 1180 description (#21)
[v40_KI43] Moved the BusinessCurrentAccount code from OBInternalCardSchemeType1Code to OBInternalProductType1Code (#13)
[v40_KI44] Corrected OBExternalAuthorisation1Code to OBInternalAuthorisation1Code (#14)
[CDRW-4855] Fix typo in ExternalPaymentGroupStatus1Code INFA description (#15)

Assets 2

04 Feb 15:16

cjrobbertse-ob

v4.0.1-RC-2

ad59c42

v4.0.1 - Release Candidate 2 Pre-release

Pre-release

Version History

v4.0.1 Release Candidate 2 - 2026-02-04

Added

Added LWMH, LXMH, and TWYR to OBFrequency6Code in OBInternal
Added SLCT to OBFrequency2Code in OBInternal
Added legacy values to OBExternalPaymentContext1Code: Other, Bill Payment, EcommerceGoods, EcommerceServices, PartyToParty, PispPayee

Updated

Updated ISO 20022 External Codeset files to Q3 2025 release.
Enhanced the descriptions of current OBExternalPaymentContext1Code codes BillingGoodsAndServicesInAdvance, BillingGoodsAndServicesInArrears, EcommerceMerchantInitiatedPayment, FaceToFacePointOfSale, TransferToSelf, TransferToThirdParty

v4.0.1 Draft 1 - 2026-01-05

Added

Added to OBInternalStatementFeeType1Code:
- UK.OBIE.InstalmentPlan
- UK.OBIE.ReturnedPayment
Added to OBInternalStatementInterestType1Code:
- UK.OBIE.InstalmentPlan
- UK.OBIE.MoneyTransfer
Added CRYP to ExternalPurpose1Code
Introduced OBIntermediaryAgentStatus1Code in OB_Internal_Codeset. This is used for
OBIntermediaryAgent/ProcessingStatus and has the following codes:
- PDNG
- RCVD
- ACSP
- ACSC
- RJCT
- UNKN
- CANC
Description of code value U037 updated to "Authorisation failed by one (or more) of the authenticators."
Added NONE to OBFrequency2Code

Changed

Separated OBInternalConsentStatus1Code into 3 codesets for certain contexts (#17):
- Removed COND & AWUP from OBInternalConsentStatus2Code
- Added OBInternalConsentStatus2Code to OB_Internal_Codeset.csv with the following values:
  - AWAU
  - RJCT
  - AUTH
  - COND
- Added OBInternalConsentStatus3Code to OB_Internal_Codeset.csv with the following values:
  - AWAU
  - RJCT
  - AUTH
  - COND
  - AWUP
Updated description of U037 in OBExternalStatusReason1Code (#7)
Separated ExternalPaymentTransactionStatus1Code into 5 codesets for specific contexts (#16). New Codes look like:
- ExternalPaymentTransactionStatus1Code (16 codes) for Domestic Standing Orders & International Standing Orders:
  - CANC
  - RCVD
  - ACTC
  - PATC
  - PDNG
  - RJCT
  - INFA
  - INCO
  - ACCP
  - ACFC
  - ACSP
  - ACWC
  - ACSC
  - BLCK
  - ACCC
  - ACWP
- ExternalPaymentTransactionStatus2Code (14 codes) for Domestic Scheduled Payments and International Scheduled Payments:
  - CANC
  - RCVD
  - PDNG
  - ACTC
  - PATC
  - ACCP
  - ACFC
  - ACSP
  - ACWC
  - ACSC
  - BLCK
  - ACCC
  - ACWP
  - RJCT
- ExternalPaymentTransactionStatus3Code (13 codes) for Domestic Payments and International Payments:
  - RCVD
  - PDNG
  - ACTC
  - PATC
  - ACCP
  - ACFC
  - ACSP
  - ACWC
  - ACSC
  - BLCK
  - ACCC
  - ACWP
  - RJCT
- ExternalPaymentTransactionStatus4Code (3 codes) for File Payments:
  - PDNG
  - INFA
  - INCO
- ExternalPaymentTransactionStatus5Code (12 codes) for Domestic VRPs:
  - RCVD
  - PDNG
  - ACTC
  - ACCP
  - ACFC
  - ACSP
  - ACWC
  - ACSC
  - BLCK
  - ACCC
  - ACWP
  - RJCT

Removed

Removed duplicate ExternalMandateStatus1Code codes (#12)
Removed deprecated OBExternalStatus3Code (#13)

Fixed

codesets are now contiguous and organized alphabetically
several descriptions have been moved out of the codeset name column and into the description column
Corrected OBExternalStatusReason1Code 1180 description (#21)
Moved the BusinessCurrentAccount code from OBInternalCardSchemeType1Code to OBInternalProductType1Code (#13)
Corrected OBExternalAuthorisation1Code to OBInternalAuthorisation1Code (#14)
Fix typo in ExternalPaymentGroupStatus1Code INFA description (#15)

Pull Requests

CDRW-4775 codeset repo cleanup by @cjrobbertse-ob in #6
CDRW-4776 change the description for u037 in ie repo authorisation failed by one of the authenticators by @cjrobbertse-ob in #7
CDRW-4860 Removed duplicate ExternalMandateStatus1Code codes by @cjrobbertse-ob in #12
CDRW-4883 CR1 by @OBPeteS in #9
Added CRYP to ExternalPurpose1Code by @OBPeteS in #10
Added OBIntermediaryAgentStatus1Code codeset by @OBPeteS in #11
CDRW-4733 Remove enum business current account from ob internal card scheme type1 code codeset in ob internal codeset as it is not relevant to card scheme type by @cjrobbertse-ob in #13
CDRW-4855 Fix typo in ExternalPaymentGroupStatus1Code INFA description by @cjrobbertse-ob in #15
CDRW-4900-Update description-of-U037 by @OBPeteS in #18
CDRW-4895 Separate external payment transaction status1 code by @cjrobbertse-ob in #16
CDRW-4835 Correct OBExternalAuthorisation1Code to OBInternalAuthorisation1Code by @cjrobbertse-ob in #14
CDRW-4803 add dcsv enum to the ob internal codeset under external document format1 code by @cjrobbertse-ob in #8
CDRW-4764 OBInternalConsentStatus1Code by @cjrobbertse-ob in #17
Cdrw 4905 by @OBPeteS in #19
remove ExternalPaymentGroupStatus1Code by @cjrobbertse-ob in #20
CDRW- 4906 Update description for OBExternalStatusReason1Code 1180 by @cjrobbertse-ob in #21
Fixed overflows by @OBPeteS in #22
v4.0.1 changelog by @cjrobbertse-ob in #23
Update OB_Internal_Codeset.csv by @OBPeteS in #24
Update OB_Internal_Codeset.csv by @OBPeteS in #25
Add the code NONE to the OBFrequency2 codeset by @carogiacchino-ob in #26
Add codes to OBFrequency6Code and OBFrequency2 Code by @cjrobbertse-ob in #28
V4.0.1 rc2 external codeset list update by @OBPeteS in #29
Update CRYP description by @OBPeteS in #30
Fix/ki 25 by @cjrobbertse-ob in #32

New Contributors

@carogiacchino-ob made their first contribution in #26

Full Changelog: v4.0.0...v4.0.1-RC-2

Contributors

OBPeteS, cjrobbertse-ob, and carogiacchino-ob

Assets 2

05 Jan 12:08

OBPeteS

v4.0.1-RC-1

f0f301b

v4.0.1 - Release Candidate 1 Pre-release

Pre-release

Version History

v4.0.1 - 2026-01-05

Added

Added to OBInternalStatementFeeType1Code:
- UK.OBIE.InstalmentPlan
- UK.OBIE.ReturnedPayment
Added to OBInternalStatementInterestType1Code:
- UK.OBIE.InstalmentPlan
- UK.OBIE.MoneyTransfer
Added CRYP to ExternalPurpose1Code
Introduced OBIntermediaryAgentStatus1Code in OB_Internal_Codeset. This is used for
OBIntermediaryAgent/ProcessingStatus and has the following codes:
- PDNG
- RCVD
- ACSP
- ACSC
- RJCT
- UNKN
- CANC
Description of code value U037 updated to "Authorisation failed by one (or more) of the authenticators."
Added NONE to OBFrequency2Code

Changed

Separated OBInternalConsentStatus1Code into 3 codesets for certain contexts (#17):
- Removed COND & AWUP from OBInternalConsentStatus2Code
- Added OBInternalConsentStatus2Code to OB_Internal_Codeset.csv with the following values:
  - AWAU
  - RJCT
  - AUTH
  - COND
- Added OBInternalConsentStatus3Code to OB_Internal_Codeset.csv with the following values:
  - AWAU
  - RJCT
  - AUTH
  - COND
  - AWUP
Updated description of U037 in OBExternalStatusReason1Code (#7)
Separated ExternalPaymentTransactionStatus1Code into 5 codesets for specific contexts (#16). New Codes look like:
- ExternalPaymentTransactionStatus1Code (16 codes) for Domestic Standing Orders & International Standing Orders:
  - CANC
  - RCVD
  - ACTC
  - PATC
  - PDNG
  - RJCT
  - INFA
  - INCO
  - ACCP
  - ACFC
  - ACSP
  - ACWC
  - ACSC
  - BLCK
  - ACCC
  - ACWP
- ExternalPaymentTransactionStatus2Code (14 codes) for Domestic Scheduled Payments and International Scheduled Payments:
  - CANC
  - RCVD
  - PDNG
  - ACTC
  - PATC
  - ACCP
  - ACFC
  - ACSP
  - ACWC
  - ACSC
  - BLCK
  - ACCC
  - ACWP
  - RJCT
- ExternalPaymentTransactionStatus3Code (13 codes) for Domestic Payments and International Payments:
  - RCVD
  - PDNG
  - ACTC
  - PATC
  - ACCP
  - ACFC
  - ACSP
  - ACWC
  - ACSC
  - BLCK
  - ACCC
  - ACWP
  - RJCT
- ExternalPaymentTransactionStatus4Code (3 codes) for File Payments:
  - PDNG
  - INFA
  - INCO
- ExternalPaymentTransactionStatus5Code (12 codes) for Domestic VRPs:
  - RCVD
  - PDNG
  - ACTC
  - ACCP
  - ACFC
  - ACSP
  - ACWC
  - ACSC
  - BLCK
  - ACCC
  - ACWP
  - RJCT

Removed

Removed duplicate ExternalMandateStatus1Code codes (#12)
Removed deprecated OBExternalStatus3Code (#13)

Fixed

codesets are now contiguous and organized alphabetically
several descriptions have been moved out of the codeset name column and into the description column
Corrected OBExternalStatusReason1Code 1180 description (#21)
Moved the BusinessCurrentAccount code from OBInternalCardSchemeType1Code to OBInternalProductType1Code (#13)
Corrected OBExternalAuthorisation1Code to OBInternalAuthorisation1Code (#14)
Fix typo in ExternalPaymentGroupStatus1Code INFA description (#15)

Older Versions

Note: Information that has been removed is marked as ~~struck out~~ and that has changed or added is marked as
underlined.

Refer to KI Page for
all the known issues.

Version No	Created by	Creation Date	Version Notes
v0.1	OBL Standards Team	01-Jul-2024	1) ~~OBExternalDirectDebitFrequency1Code~~ codeset and codevalues are also removed and replaced with OBFrequency6Code 2) Removed incorrect values from OBInternalCardSchemeType1Codes 3) Removed duplicate entries of ExternalBalanceType1Code, ExternalBalanceSubType1Code 4) ~~OBExternalStatus1Code~~ codeset and codevalues are also removed and replaced with ExternalPaymentTransactionStatus1Code 5) Moved all ExternalPaymentTransactionStatus1Code from ISO_External_Codeset to OB_Internal_Codeset 6) Added BusinessCurrentAccount which was missing as a Code Value in OBInternalProductType1Code 7) Replaced few ~~OBInternalProductType1Code~~ with OBExternalOfferType1Code as they were incorrectly under that codeset 8) Removed ~~ACIS~~ from ISO_External_Codeset because it is not applicable 9) Renamed ~~OBExternalPaymentTransactionStatus1Code~~ to ExternalPaymentTransactionStatus1Code for two code values (INFA and INCO) in OB_Internal_Codeset 10) Moved ExternalPaymentGroupStatus1Code from ISO_External_Codeset to OB_Internal_Codeset 11) Added two code sets INFA and INCO under ExternalPaymentGroupStatus1Code 12) Rename ~~OBExternalClassification1Code~~ with OBExternalMandateClassification1Code 13) Updated CodeValue and CodeDefinition of all OBExternalMandateClassification1Code
v0.2	OBL Standards Team	16-Jan-2025	1) (v40_KI26) Added 9 codesets 1100, 1161, 1162, 1163, 1165, 1166, 1177, 1178, 1180 under OBExternalStatusReason1Code 2) (v40_KI27) Added RJCT codeset under ExternalEntryStatus1Code in ISO_External_Codeset 3) (v40_KI28)(TDA-270 and 271) Added new OBL Proprietary code values WODL,FOWK, TWMH, FOMH, FIMH, ALMH, NONE under OBFrequency6 4) (v40_KI31) Removed duplicate entries of ExternalDocumentFormat1code from ISO_External_Codeset and OB_Internal_Codeset 5) Added code definitions for below code values and updated code name in OBInternalPaymentContext1Code in OB_Internal_Codeset: - BillingGoodsAndServicesInAdvance - BillingGoodsAndServicesInArrears - EcommerceMerchantInitiatedPayment - FaceToFacePointOfSale - TransferToSelf - TransferToThirdParty 6) Removed 'OTHER' from OBInternalPaymentContext1Code as it is a deprecated value

Assets 2

05 Jan 12:06

OBPeteS

v4.0.0

de0fe9d

v4.0.0

Version History

| Note: |Information that has been removed is marked as ~~struck out~~ and that has changed or added is marked in blue .
Refer to KI Page for all the known issues.

Version No	Created by	Creation Date	Version Notes
v0.1	OBL Standards Team	01-Jul-2024	1) ~~OBExternalDirectDebitFrequency1Code~~ codeset and codevalues are also removed and replaced with OBFrequency6Code 2) Removed incorrect values from OBInternalCardSchemeType1Codes 3) Removed duplicate entries of ExternalBalanceType1Code, ExternalBalanceSubType1Code 4) ~~OBExternalStatus1Code~~ codeset and codevalues are also removed and replaced with ExternalPaymentTransactionStatus1Code 5) Moved all ExternalPaymentTransactionStatus1Code from ISO_External_Codeset to OB_Internal_Codeset 6) Added BusinessCurrentAccount which was missing as a Code Value in OBInternalProductType1Code 7) Replaced few ~~OBInternalProductType1Code~~ with OBExternalOfferType1Code as they were incorrectly under that codeset 8) Removed ~~ACIS~~ from ISO_External_Codeset because it is not applicable 9) Renamed ~~OBExternalPaymentTransactionStatus1Code~~ to ExternalPaymentTransactionStatus1Code for two code values (INFA and INCO) in OB_Internal_Codeset 10) Moved ExternalPaymentGroupStatus1Code from ISO_External_Codeset to OB_Internal_Codeset 11) Added two code sets INFA and INCO under ExternalPaymentGroupStatus1Code 12) Rename ~~OBExternalClassification1Code~~ with OBExternalMandateClassification1Code 13) Updated CodeValue and CodeDefinition of all OBExternalMandateClassification1Code
v0.2	OBL Standards Team	16-Jan-2025	1) (v40_KI26) Added 9 codesets 1100, 1161, 1162, 1163, 1165, 1166, 1177, 1178, 1180 under OBExternalStatusReason1Code 2) (v40_KI27) Added RJCT codeset under ExternalEntryStatus1Code in ISO_External_Codeset 3) (v40_KI28)(TDA-270 and 271) Added new OBL Proprietary code values WODL,FOWK, TWMH, FOMH, FIMH, ALMH, NONE under OBFrequency6 4) (v40_KI31) Removed duplicate entries of ExternalDocumentFormat1code from ISO_External_Codeset and OB_Internal_Codeset 5) Added code definitions for below code values and updated code name in OBInternalPaymentContext1Code in OB_Internal_Codeset BillingGoodsAndServicesInAdvance BillingGoodsAndServicesInArrears EcommerceMerchantInitiatedPayment FaceToFacePointOfSale TransferToSelf TransferToThirdParty 6) Removed 'OTHER' from OBInternalPaymentContext1Code as it is a deprecated value

Assets 2

Releases: OpenBankingUK/External_Internal_CodeSets

v4.0.1

Version History

v4.0.1 - 2026-04-01

Added

Changed

Removed

Fixed

Uh oh!

v4.0.1 - Release Candidate 2

Version History

v4.0.1 Release Candidate 2 - 2026-02-04

Added

Updated

v4.0.1 Draft 1 - 2026-01-05

Added

Changed

Removed

Fixed

Pull Requests

New Contributors

Contributors

Uh oh!

v4.0.1 - Release Candidate 1

Version History

v4.0.1 - 2026-01-05

Added

Changed

Removed

Fixed

Older Versions

Uh oh!

v4.0.0

Version History

Uh oh!