Skip to content

Releases: OpenBankingUK/External_Internal_CodeSets

v4.0.1 - Release Candidate 2

04 Feb 15:16

Choose a tag to compare

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

New Contributors

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

v4.0.1 - Release Candidate 1

05 Jan 12:08

Choose a tag to compare

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

v4.0.0

05 Jan 12:06

Choose a tag to compare

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