standards-maintenance icon indicating copy to clipboard operation
standards-maintenance copied to clipboard

Update description of features[].isActivated to remove default

Open anzbankau opened this issue 4 years ago • 5 comments

Description

The wide range of features and the products to which they may apply reveals more complexity and subtleties associated with the use of the features[object].isActivated property than outlined in the answer to clarification request #171. The single example, together with the default value of true, suggests that there is a simple binary choice. The range of feature types highlights the limitations of having a default value (whether true or false) and the need to enhance the property's description.

The '... false if the feature is available for activation.' part of the current description implies that activation is initiated by the customer and if not, the feature is not active. The 'Defaults to true if absent.' part does not allow data holders to indicate that the activation state is unknown or cannot practically be determined. This is counter to the rest of the standards where a property value may not be available (even for a mandatory property). A default also has the effect of making this optional property a mandatory property.

Many feature types are an inherent part of the product rather than selectively activated by customers e.g. DIGITAL_BANKING, FREE_TXNS, FREE_TXNS_ALLOWANCE, NPP_ENABLED, UNLIMITED_TXNS. The description should indicate this additional meaning of isActivated=true. Refer to the table below for an indicative classification of feature types.

Given the range of features and their applicability to different products, the ability to determine whether a feature has been activated by a customer can be difficult or impossible (as noted in #171). For some customer-activated features there is no reason to record the activation event on the account because they have no effect on regular account processing e.g. ADDITIONAL_CARDS, CARD_ACCESS, NPP_PAYID. This contrasts with customer-activated features that determine the number or values of fees and rates that are therefore important for account-to-product comparisons e.g. OVERDRAFT. The description should permit the absence of the property (or null value) to indicate that the activation state is unknown.

Note: COMPLEMENTARY_PRODUCT_DISCOUNTS ('Indicates that complementary, discounted offerings (such as gift cards, or discounted travel) is available') is an example of a feature type for which a data holder would not be reasonably expected to record the customer's acceptance of offers that are incidental to regular account processing.

Area Affected

Get Account Detail

Change Proposed

Amend the description for features[object].isActivated from: True if the feature is already activated and false if the feature is available for activation. Defaults to true if absent. (note this is an additional field appended to the feature object defined in the Product Reference payload)

to: True if the feature has been activated by the customer or is a standard feature of the product. False if the feature is available for activation. If absent or null, the activation state is unknown. (Note this is an additional field appended to the feature object defined in the Product Reference payload.)


Indicative Classification of Feature Types

Feature Type Description isActivated Level
ADDITIONAL_CARDS Additional cards can be requested Customer
BALANCE_TRANSFERS Balance transfers can be made from the account (eg. for credit cards) Product
BILL_PAYMENT The product can be attached to an automatic budgeting and bill payment service Product
BONUS_REWARDS Bonus loyalty rewards points are available Product
CARD_ACCESS A card is available for the product to access funds Customer
COMPLEMENTARY_PRODUCT _DISCOUNTS Indicates that complementary, discounted offerings (such as gift cards, or discounted travel) is available Product
DIGITAL_BANKING Access is available to online banking features for the product Product
DIGITAL_WALLET A Digital wallet can be attached to the product Product
DONATE_INTEREST Indicates that interest generated from the product can be automatically donated to a charity or community group Product
FREE_TXNS A set number of free transactions available per month Product
FREE_TXNS_ALLOWANCE A set amount of transaction fee value that is discounted per month Product
INSURANCE Insurance is provided as an additional feature of the product Customer
INTEREST_FREE Interest free period for purchases Product
INTEREST_FREE_TRANSFERS Interest free period for balance transfers Product
LOYALTY_PROGRAM A points based loyalty program is available Product
NOTIFICATIONS Advanced notifications are available for the product Product
NPP_ENABLED An account of this product type can be used to receive funds as a result of a BSB/Number based NPP payment Product
NPP_PAYID An account of this product type can be used as the target of an NPP PayID Customer
OFFSET An offset account can be connected to the product Customer
OVERDRAFT An overdraft can be applied for Customer
REDRAW Redraw of repaid principal above minimum required is available Product
UNLIMITED_TXNS Unlimited free transactions available Product

anzbankau avatar Sep 08 '20 08:09 anzbankau