IBM Support

V4.0.3 Release Information for Financial Transaction Manager for Interac e-Transfers for Red Hat OpenShift

Fix Readme


Abstract

This document contains release information for Financial Transaction Manager for Interac e-Transfers for Red Hat OpenShift 4.0.3.

Content

Financial Transaction Manager (FTM) for Interac e-Transfers for Red Hat OpenShift 4.0.3 Release Information

 

Contents
Common Across Releases

FTM 4.0.3.0 release table
Release Channel Operator Operand Supported Operands Case
4.0.3.0 v4.0 4.0.0 4.0.3.0 4.0.3.0 v4.0.3
4.0.3.0 interim fix 1 v4.0 4.0.1 4.0.3.0_iFix1 4.0.3.0_iFix1 & 4.0.3.0 v4.0.4
4.0.3.0 interim fix 2 v4.0 4.0.2 4.0.3.0_iFix2 4.0.3.0_iFix2 & 4.0.3.0_iFix1 v4.0.5
4.0.3.0 interim fix 3 v4.0 4.0.3 4.0.3.0_iFix3 4.0.3.0_iFix3 & 4.0.3.0_iFix2 v4.0.6
4.0.3.0 interim fix 4 v4.0 4.0.4 4.0.3.0_iFix4 4.0.3.0_iFix4 & 4.0.3.0_iFix3 v4.0.7
4.0.3.0 interim fix 3.1 v4.0 4.0.5 4.0.3.0_iFix3.1 4.0.3.0_iFix3.1 & 4.0.3.0_iFix3 v4.0.8
4.0.3.0 interim fix 6 v4.0 4.0.6 4.0.3.0_iFix6 4.0.3.0_iFix6 & 4.0.3.0_iFix3.1 v4.0.9
4.0.3.1-Fixpack1 v4.0 4.0.7 (head) 4.0.3.1 4.0.3.1 & 4.0.3.0_iFix6 v4.0.10


  

When you upgrade a fix pack or interim fix (iFix), in addition to the changes in the level that is being upgraded to, be sure to review the changes in the intermediate fix packs or interim fixes (iFixes). 
Example:

  • If currently at level fix pack 6 and upgrading to level 4.0.3.1, then review the changes in both ifix6 and 4.0.3.1.

Back to top
Common Across Releases
 

Fix list
    For a list of fixes, see V4.0.3 Fix List for Financial Transaction Manager for Interac e-Transfers for Red Hat OpenShift.


Data Setup Utility
The following documentation describes the changes for the data setup utility (DSU) and the import and export workbooks:

  • DSUmigration_v4.0.3.pdf
  • DSUMigrationBR_v4.0.3.pdf

These documents are provided in the entitled documentation fix pack. For more information about getting this fix pack, refer to the Entitled Documentation section.


Transaction Server Scheduler XML
   The following documentation describes the changes to the scheduler XML for the Transaction Server component:

  • TransactionServerSchedulerChanges_v4.0.3.pdf
This document is provided in the entitled documentation fix pack. For more information about getting this fix pack, refer to the Entitled Documentation section.

Entitled Documentation
The entitled documentation fix packs for the FTM offerings can be downloaded from Fix Central by using the following links:
Back to top
4.0.3.1-Fixpack1
Db2 Migration
There are no Db2 migration steps required from 4.0.3.0 interim fix 6 (iFix6) to interim 4.0.3.1-Fixpack1

Deployment
Refer to the FTM online documentation for general deployment instructions.
For instructions on upgrading from 4.0.3.0 interim fix 6 (iFix6) to 4.0.3.1 see:

 
Special Notes
Back to top
4.0.3.0 interim fix 6 release
Db2 Migration
There are no Db2 migration steps required from 4.0.3.0 interim fix 3.1 (iFix3.1) to interim fix 6 (iFix6)

Deployment
Refer to the FTM online documentation for general deployment instructions.
For instructions on upgrading from 4.0.3.0 interim fix 3.1 (iFix3.1) to 4.0.3.0 interim fix 6 (iFix6) see:

 
Special Notes
1) Red Hat OpenShift Container Platform 4.8 has a known issue when your deploy uses the containerized Db2 image. You can use version 4.8 to deploy when you are using an external Db2 database and not the containerized Db2 image.
2) 4.0.3.0 interim fix 6 (iFix6) addressed the Log4j vulnerabilities
3) The field lengths of Ultimate Debtor ID, Ultimate Creditor ID, Invoicer ID, and Invoicee ID are increased from 20 to 35 characters.  The Initiating Party ID and Debtor ID fields retain their field length of 20 characters.
API Updates: With this change, the YAML introduces new objects used by the Initiating Party Id and Debtor Id to restrict their field lengths to 20 characters.  These objects are:
  • WslParty38ChoiceLimitedId20,
  • WsIOrganisationIdentification29LimitId20,
  • WsIGenericOrganisationIdentification1LimitId20. 
Existing objects for the other ID fields are updated to support the new 35 character limits
Known Issues
129208 - The Inbound Transactions page of the Control Center can take several minutes to load. 
Solution:
To address this issue, the following alternative view DDL file was provided, which you can applyThe optional DDL, PAY_AND_NON_PAY_TXN_V.PayOnly.ddl can be installed to change the PAY_AND_NON_PAY_TXN_V view to transactions when a customer does not have, or does not want to see, non-payment transactions.
Follow these steps to replace this database view to help improve performance:
Extract the file:
  1. Locate the Interac artifacts pod named: ftm-artifact-interac-*
  2. Copy the file /home/ftmuser/ftm/artifacts/ftm-db2-check-4.0.3-iFix6-latest.zip from the Interac artifacts pod
  3. Extract the contents of this downloaded file.
  4. Locate the ../ibm/ftm/shared/v403/pfs/Database/db2/{os}/util folder in the extracted directory structure.
  5. Locate the PAY_AND_NON_PAY_TXN_V.PayOnly.ddl file.
Apply the update to your database: 
    1.  Back up your FTM databases
    2.  Edit PAY_AND_NON_PAY_TXN_V.PayOnly.ddl
         Make any changes necessary to accommodate your own system configuration.
    3.  Open a Db2 command (For Windows only)
          > db2cmd [RETURN]
    4.  Connect to the database (FTMDB is default)
         > db2 connect to FTMDB [RETURN]
    5.  Set current schema (FTM is default)
         > db2 set current schema FTM [RETURN]
    6.  Set current path (FTM is default)
         > db2 set path=FTM [RETURN]
    7.  Execute PAY_AND_NON_PAY_TXN_V.PayOnly.ddl
         > db2 -tvf PAY_AND_NON_PAY_TXN_V.PayOnly.ddl
Roll back the update - if necessary:
1. Copy DDL commands for the PAY_AND_NON_PAY_TXN_V view from the build izgview.ddl file including COMMENTS.
2. Paste these DDL commands into a new DDL file.
3. Edit the new DDL file.
4. Change "CREATE VIEW PAY_AND_NON_PAY_TXN_V" to "CREATE OR REPLACE VIEW PAY_AND_NON_PAY_TXN_V".
5. Save and exit the editor.
6. Connect to the database.
7. Set schema to FTM.
8. Set path to FTM.
9. Execute new DDL file by using this command
    > db2 -tvf newddlfilename
10.  Connect RESET.
126497 - Swagger user interface not showing length constraints
The Swagger view for the Interac Inbound Notifications web service does not display the length constraints for the header fields.  The constraints are in the associated YAML and are validated by the application.  No loss of functionality occurs because of this issue.
130698 - Inbound Notifications validation message is vague when a header value is missing.
In the Inbound Notifications APIs, if a required header parameter is missing, the validation message returned doesn't mention which field is missing.
Back to top
4.0.3.0 interim fix 3.1 release


Deployment
Refer to the FTM online documentation for general deployment instructions.
For instructions on upgrading from 4.0.3.0 interim fix 3 (iFix3) to 4.0.3.0 interim fix 3.1 (iFix3.1) see:
Db2 Migration
There are no Db2 migration steps required from 4.0.3.0 interim fix 3 (iFix3) to iFix3.1
Special Notes
4.0.3.0 interim fix 3.1 (iFix3.1) fixes the following log4j vulnerabilities:
Back to top
4.0.3.0 interim fix 4 release
Is IBM internal only.
Back to top
4.0.3.0 interim fix 3 release


Deployment
Refer to the FTM online documentation for general deployment instructions.
For more information about the specific 4.0.3.0 interim fix 3 (iFix3) deployment instructions, see
Known Issues
119795 - Outbound Transmissions help page missing status value
The status of "Unmapped" is not described in the outbound transmission help page.
120368 - Payment gets stuck in Transaction Mapped state with some special characters
When the special character (\b) is included in the unstructured remittance field, the transaction gets stuck in the transaction mapped state.
120369 - (\r) character in payment request string is replaced with space
Including the (\r) character in the payment memo field ends up with the special character converted to a space.
124126 - Funds Transferred column value is displaying as "blank" for success payment in Control Center (Digital Payments user interface page) with default channel config.
If Accounting Request Transaction is not logged (channel config), the event publication to flip the 'Funds Transferred' flag in Digital Payments.
124499 - Transaction stalled in Waiting For Prechecks (Outgoing) after graceful Db2 takeovers.
Transaction stalled in Waiting For Prechecks (Outgoing) after graceful Db2 takeovers. Investigation ongoing.
126188 - Deadlock during load testing with precheck register event
Back to top
4.0.3.0 interim fix 2 release


Deployment
Refer to the FTM online documentation for general deployment instructions.
For more information about the specific 4.0.3.0 interim fix 2 (iFix2) deployment instructions, see
Known Issues
124126 - This results in the 'Funds Transferred' flag in Digital Payments (DP) not being set. 
In the default channel configuration (where accounting request transactions are not logged), the publication rules associated with E_CheckRequestComplete are unable to execute because the ObjectSelector data expected by the publication rule is not available.
This problem results in the 'Funds Transferred' flag in Digital Payments not being set. 
124092 - Multi-byte Characters are Not Supported by Emulators
The Java virtual machines (JVMs) for the Interac emulators (customer, fraud, payments) are missing the configuration option to set character encoding to UTF-8.  All tests that use multi-byte characters must be done with the Interac network.
120369 - Special Characters Sent in string fields of JSON Payload to Web Service APIs May Produce Undesirable Results
Characters '\n', '\r', and '\r' are substituted with a blank (' ') when they are displayed in the user interface applications.
Character '\f', when submitted to the Initiate credit transfer API (/payment/origination/credit-transfer), causes the transaction to get stuck during processing and never complete.
122821 - Duplicate Transaction Might Be Generated in an IBM MQ Failure Scenario
A small window of opportunity exists during an IBM MQ queue manager failure scenario where Gateway Server creates two transmissions / transactions for a single payment.  The Immediate Payments workflow processes only one of the two transactions.
124013 - Data Setup Utility (DSU) export of multi-byte characters produces invalid results
Do not use DSU to export data that might contain multi-byte characters.  The recommended work-around is to maintain a master copy of the configuration data in the worksheets.  When updates are required, reflect the changes in these worksheets so they can be imported later.  For example, imported to other environments.
Back to top
4.0.3.0 interim fix 1 release

Deployment

Refer to the FTM online documentation for general deployment instructions.
For more information about the specific 4.0.3.0 interim fix 1 (iFix1) deployment instructions, see
Known Issues
122994 - Migration from 4.0.3.0 GA to 4.0.3.0 iFix1: Executing InteracImport.properties generates errors during DSU process

Work-around:  Before you do the migration as documented in DSUMigration_v4.0.3.pdf, replace the file FeatureXREF.xls with the updated version (named D122994_FeatureXREF.xls).

This file is in the entitled documentation fix pack. For more information about getting the fix pack, refer to the Entitled Documentation section.

123051 - Two Channel Services Payment APIs Return Incorrect HTTP Status on Interac Network Error
Web service APIs Update Payment Authentication and Cancel Credit Transfer return HTTP status code 400 for certain Interac network errors.  The APIs should return status code 500 under failure conditions.  The API URLs are shown in the following list:
/payment/origination/credit-transfer/{ftm-transaction-id}/update-auth
/payment/origination/credit-transfer/{ftm-transaction-id}/cancel

Feature changes

118847 - General library currency updates
121604 - Added support for Init Container
Framework for providing the Init container support
- Use your own image to integrate with external credential management systems to get the FTM secrets
- You can provide ENV variables, config files, and passwords to the framework by using Red Hat OpenShift ConfigMaps and secrets
- Support for regular values as well as files (with base64 encoding)

121601- Implementation of pre-stop hooks in Java Platform, Enterprise Edition images
Pod shut down logic for Java Platform, Enterprise Edition containers was implemented to help ensure the orderly termination of Liberty application servers.
121485 - Added Node Affinity support for IBM MQ
To assign an IBM MQ pod to a specific worker node, attach the label ftm-mq=yes to the target worker node of OCP cluster.
For more information, refer to the deployment section in the FTM online documentation.
121827 - Add support for CLIENT_CERT authentication in Liberty web services
FTM now supports CLIENT_CERT authentication for all web services components. For more information about how to enable this authentication by using config drop-ins, refer to IBM_FTM_V40_Security_Configuration.pdf, which is available to entitled users.

This file is in the entitled documentation fix pack. For more information about getting the fix pack, refer to the Entitled Documentation section.

Supported components:
WebServices_BusinessRules
WebServices_Gateway
WebServices_PFS
WebServices_Interac
WebServices_InteracInboundNotifications
WebServices_InteracCustomerEmulator
WebServices_InteracFraudEmulator
WebServices_InteracPaymentEmulator
WebServices_EAR (Engine)
Note: WebServices_EAR (Engine) no longer displays a login page by default. It now defaults to BASIC authentication, which is a pop-up-based dialog box for the user to enter credentials when they access the web services by using the FTM Web Service Browser (ws/svc).

Migration

Database migration is required. Use the instructions in the MIGRATE from Release 4.0.3.0 TO Release 4.0.3.0 iFix1.txt file. This file is in the entitled documentation fix pack. For more information about getting the fix pack, refer to the Entitled Documentation section.

Also, data migration is required for existing WIP RECORD entries.  For each business day, do the following update per the command in the FTM_Database_Migration_Update_Command.txt file. This file is provided in the entitled documentation fix pack. For more information about getting this fix pack, refer to the Entitled Documentation section.

Back to top
4.0.3.0 release
 

Deployment

Refer to the FTM online documentation for general deployment instructions.
Known Issues

121368 - Resolved in 4.0.3.0 interim fix 1

Gateway Server has an SQL CODE: -302 error when the initiateCreditTransfer clearing_system_member_identification value has length of 32 to 35 characters.

 

High Availability

Additional resiliency is needed in some scenarios to improve the handling of error detection or auto recovery. This resiliency is addressed in the interim fix delivery.

121354
Accounting errors are not showing in Digital Payments and are not in the API response.

120369

Interac Payments with backspace character in the payment payload are not supported and are rejected immediately in the FTM Outbound (Channel) API. Interac Payments with tab, new line, and carriage return characters are posted to the Interac Network correctly, but render as \t, \n and \r in the Control Center and OAC user interfaces.

119353 - Resolved in 4.0.3.0 interim fix 1
The Interac solution can support only Debtor names of 20 characters. If debtor name is longer than 20 characters, it is truncated to 20 characters and stored in database.

121619 - Resolved in 4.0.3.0 interim fix 1

FTM is not looking at the response body for HTTP 503 errors when it is communicating with the Interac network.  This change in the response body by Interac for 503 return codes was accidentally overlooked.  This problem means that the code and text that was supplied in the error scenario is not reported in the FTM repository and response to the caller.

1211147 - Resolved in 4.0.3.0 interim fix 1

Retry Delay set to 2 seconds for realtime payment types. In testing, the delay can take 2 - 7 seconds to send a retry attempt.


Feature changes

Enhanced UTF-8 Support
Implemented UTF-8 character support for DSU, Distribution Manager, and Business Rules Server.
- DSU can import and export configuration with UTF-8 characters.
- Operator is able to activate release (build and validate TBL file)
- Business Rules Server successfully receives the activated descriptors or file and process the activated releases.
- Business Rules Server is able to process transmissions and transactions that include UTF-8 characters.

Enhanced software upgrade capabilities and process management

Improved reliability of the Business Rules Server rules activation
The Business Rules Server now uses a database polling mechanism to load business rules upon activation by using the ENVIRONMENT database table settings.

Improved flexibility and scaling capabilities for the IBM App Connect Enterprise and IBM MQ containers
FTM split the combined containers into separate IBM App Connect Enterprise and IBM MQ containers.

The IBM MQ container is now a separate container that is running IBM MQ 9.2. IBM App Connect Enterprise 11.0.0.11 is running in separate IBM App Connect Enterprise containers.
Benefits of the split:
- Ability to deploy IBM App Connect Enterprise and IBM MQ separately
- Ability to have IBM App Connect Enterprise connect to a remote queue manager
- Ability to customize the IBM App Connect Enterprise deployment topology as required
- Ability to have multiple IBM App Connect Enterprise containers
- Ability to set resources (CPU and memory) for the IBM App Connect Enterprise and IBM MQ containers separately
- Provide features of both auto and manual scaling for IBM App Connect Enterprise containers

Additional error codes to better identify the source system in error scenarios
FTM is providing more error codes to help better identify the source system in which an error scenario occurs.
These additional error codes are provided with the FTM configuration sheets for the TCH and Interac references.
The following error codes were added and linked to categories for better clarity. The category linked to these error codes represents the source system (or process) that identified the issue.

Error Code Category
INT-ScorePayment Interac Network
INT-CreatePayment Interac Network
ACCT-Inquiry Accounting System
ACCT-Credit Accounting System
ACCT-DebitCredit Accounting System
ACCT-FundsReserve Accounting System
DUPLICATE Duplicate Detection
FRAUD Fraud Detection
SANCTION Sanctions

For Interac, the error code and category is available on the JSON Response for 'Initiate Credit Transfer' for information purposes.

Improved security of communication between FTM components
FTM communication between components is now more secure with TLS encryption.
IBM MQ and Db2 communications are running over TLS.
The Java Platform, Enterprise Edition, J2SE, and IBM App Connect Enterprise client applications connect over a TLS protocol.
The procedure to generate (if self-signed certificates) and configure TLS certificates used by all the FTM components is documented by FTM. The default CipherSuite/CipherSpec used by IBM MQ and all the clients is SSL_RSA_WITH_AES_128_CBC_SHA256/TLS_RSA_WITH_AES_128_CBC_SHA256. This default can be customized during deployment with the Operator Instance YAML.

LTPA keys by default
No customization is required. LTPA keys are managed by the individual Java Platform, Enterprise Edition Liberty server instances. The default configuration is used and LTPA keys are created when the application pod starts.

Readiness and liveness health check probes and prestop pod lifecycle event
FTM now comes with health check probes (readiness and liveness) and with prestop pod lifecycle events implemented.
Readiness and liveness probes: During the rolling upgrades, the new version pod is created and when it becomes ready, Red Hat OpenShift deletes the old pod. Red Hat OpenShift runs the readiness probe to decide whether the pod is ready or not. Unless the probe returns success, it does not mark the new pod in ready state.
Liveness probes are run periodically, like a readiness probe. If a liveness probe fails, Red Hat OpenShift restarts the container.
Prestop pod lifecycle event: Red Hat OpenShift allows adding the PreStop hook to be run inside the container before Red Hat OpenShift deletes the container. This script is called by Red Hat OpenShift before it deletes the container.

Customize FTM by using ConfigMaps
FTM operator now supports configmap-based approach to let user provide custom server.xml or other configuration files in addition to the persistent volume-based approach. Separate ConfigMaps are created for each FTM component, and the customer can place all the customized files in those ConfigMaps. This method is useful for customers who do not use persistent volumes or do not have easy access to the persistent volumes from outside the container. This method is supported for JSE and Java EE components.

Usage count metering differentiates between production and non-production environments
The FTM metering application, which is in the OAC pod, now differentiates between production and non-production usage counts. The differentiation is made based on the "Environment type" variable under "License" category of IBM FTM Base Operator.
- Customers should set this variable to "Production" or "NonProduction" based on the type of environment they are building during the operator installation.
- Regardless of "Environment type" value, all usage counts are calculated and stored in the database.
- Only production mode usage counts are reported to the IBM License Server, which is in the "ibm-common-services" namespace and is shared across all projects.

Enhance Interac Fraud Flow to propagate Interac participantFraudInstruction

Participant Fraud Instruction
The Participant Fraud Instruction field in the send payment call to Interac provides the participant FI the option to override the Interac fraud detection decision.
This field is an optional field and if the participant FI does not provide the ‘participant_fraud_instruction’ field, Interac does a rescore of the payment.  
Interac accepts one of the following values in the ‘participant_fraud_instruction’ field.
 
    1. INTERAC_TO_ALLOW:
        This value from participant FI notifies Interac to simply trust the fraud judgment that was made by the participant FI and to let the payment through.
 
    2. INTERAC_TO_BLOCK:  
        This value from participant FI applies only for non-real time payments. It is used to notify Interac to initiate the payment, but to keep it in a blocked state.
 
     3. INTERAC_TO_SCORE:
        This value from participant FI notifies Interac to proceed and score the payment as usual.
        Note: If Participant FI does not share the value of participant_fraud_instruction’, ‘INTERAC_TO_SCORE’ behavior is used as the default by Interac.
FTM accepts one of these values in the response from the fraud system of the customer and it is passed to Interac as-is.
The fraud simulator allows the fraud response to be enriched according to the input value (debtor name),
How to test with simulator:
    1) Use the debtor name value to test the various cases ALLOW, SCORE, and BLOCK
    2) Based on the debtor name value, the fraud response has the data under supplementary data section with key as participant_fraud_instruction
    3) Based on fraud response values, the send payment request call has the value for participant_fraud_instruction.
        To ALLOW debtor name value in input: SOF.ALLOW
        To BLOCK debtor name value in input: SOF.BLOCK
        To SCORE debtor name value in input: SOF.SCORE

Update Initiating Party handling to incorporate usage of Interac Registration ID when Participant ID is provided

The Interac API expects only the Initiating Party to be present in the send/score request to Interac, if it's different from the Debtor ID.
If Initiating Party ID is a Participant registered with Interac, fetch its Interac registration ID from participant directory and enrich in the PACS008 ISF as the Initiating Party Identification with the scheme DomainValueCode as INTERAC. If the Initiating Party ID and Debtor IDs are same, the Initiating Party block to the Interac's request is suppressed.
It is possible that the Initiating Party does not exist in the participant directory at all. In that case, the channel-provided value in the PAIN001 is propagated to the PACS008.
This enrichment is applicable for all the calls such as Score and Send and to the internal calls Accounting debit, Accounting reversal, fraud, sanction, and Account Inquiry as well.

Interac Events - Request for Payment Schedule Notifications

Interac Notifications API:  FTM accepts Interac pushed Request for Payment Scheduled notifications.  FTM logs the notification and can be customized to publish the notification to external systems.

Reject Interac Payment When Assigned to Open (Not Active) Business Day

Interac Send Money
FTM rejects an Interac Send Money transaction when the transaction gets assigned to a business day that is not active.  The feature ensures a payment does not accidentally get stalled due to system misconfiguration.

Implement Interac Inbound Heartbeat

Interac Notifications API:  FTM implemented the /heartbeat operation of the Interac Notifications API.  FTM responds positively to the Interac Network's heartbeat requests when FTM is healthy and can receive and process Interac Push Notifications and responds negatively when FTM is unable to receive and process Interac Push Notifications.

Enhance eTransfers Workflow to Assign Error Code to Items Whose ISF Data field is Not Current

Interac Send Money:  FTM rejects an Interac Send Money transaction if the transaction with a specific error code when the FTM Gateway is misconfigured.  The feature ensures a payment does not accidentally get stalled due to system misconfiguration.

Reject payment when debtor not enrolled into Interac

Interac Send Money:
FTM rejects an Interac Send Money transaction when its debtor is not enrolled in the Interac e-Transfers scheme.
A valid debtor means:
Gateway’s Transmission Rule does the following checks:
-       Originator is Defined
-       Originator is Authorized for Product
Interac Events - Payment Schedule Notifications
Interac Notifications API
FTM accepts Interac pushed Payment Scheduled notifications.  FTM logs the notification and can be customized published the notification to external systems.
Cancel payment from Control Center UI

FTM now supports canceling Interac transactions by using the Digital Payments Control Center user interface, on the Inbound Transaction page at Origination & Receipt > Transactions.
This action can be run by using More > Actions > Cancel, and requires transactions to have the 'Interac e-Transfers' Payment Scheme and have an FTM base Status of 'Outgoing Payment Pending Creditor Action' (S_OutgoingCTPendingCreditorAction).
When the user clicks Cancel, a dialog box opens. The dialog box has three cancel actions available, Cancel, Force Cancel, and Force complete, each with different workflows and user input fields.
After the cancel is initiated, a message is sent to the Immediate Payments command queue and is then processed by an Immediate Payments workflow.

PFS Participant Directory UI: Interac Customer Support (Toggle, Create, Update)

 Interac Customer Screen

A new participant directory page was added to 4.0.3, which allows viewing, creating, editing, and toggling of an Interac customer with the Interac Network.

Permissions

New view and edit permissions for access control were added. Note: Edit permission is required for using the toggle button.

image-20210318225835-1

Interac Customer page

A new Interac customer page is visible if the user has view permission and the selected participant has the Interac Customer role. This page is an operational data page that is editable only when the latest, active version of the participant is viewed.

If a participant is not registered with the Interac network, the page is in create mode. In create mode, the Interac participant user ID is editable. By default, this value is set to the participant ID, but can be changed.   

image-20210318225835-2

image-20210318225835-3

After it is saved, the Interac participant user ID cannot be changed. If the user has edit permission, a toggle button appears to activate or deactivate the Interac customer.

image-20210318225835-4

Note: If the participant has no addresses, you cannot select address information

image-20210318225835-5

image-20210318225835-6

image-20210318225835-7

When the toggle button is clicked, a dialog box that asks for a reason for toggling this Interac customer is opened.

image-20210318225835-8

Retry Requirements from (send Money only)

FTM can Retry Interac Send Money calls under the following scenarios:
State level static timeout (that uses standard IP timeout configuration)
HTTP Error Code (by default only HTTP code 408 is retried)
The codes that can be retried are configurable by using
    Category       : HTTP_RESPONSE_CODES
    Key                 : RETRY
    Value             : comma-separated code lists
    Category       : HTTP_RESPONSE_CODES_SENDMONEY
    Key                 : RETRY
    Value             : comma-separated code lists
    Category      : HTTP_RESPONSE_CODES_SENDMONEY
    Key                : REJECT
    Value            : comma-separated code lists

    Category       : HTTP_RESPONSE_CODES
    Key                 : INDETERMINATE
    Value             : comma-separated code lists
    Category       : HTTP_RESPONSE_CODES_SENDMONEY
    Key                 : INDETERMINATE
    Value             : comma-separated code lists
The RETRY lists allow a global and interface-specific list of codes that can be retried (for the Send Money call these 2 lists are concatenated).
The REJECT list supersedes the RETRY list and causes a reject.
The INDETERMINATE lists indicate that at the end of retries the payment must not be auto rejected.  This behavior is because it is not known whether the payment was received by the external system.
A Retry Delay is configurable by using
    Category       : RETRY_DELAY
    Key                 : INTERAC_SENDMONEY
    Value             : integer value in seconds
    Category       : RETRY_DELAY
    Key                 : INTERAC_SENDMONEY/<interac payment type>
    Value             : integer value in seconds
A Retry Limit is configurable by using
    Category       : MAX_REPEAT_VALUE
    Key                 : INTERAC_SENDMONEY
    Value             : integer value
    Category     : MAX_REPEAT_VALUE
    Key                 : INTERAC_SENDMONEY/<interac payment type>
    Value             : integer value

Automatically Reject Interac Payment When Stalled in Transaction Mapped

An automated workflow that identifies stalled Interac Payments and causes the payments to be rejected was implemented. The payment could be stalled due to several technical reasons such as the Gateway or Business Rules servers not running, or encountering an unexpected exception, or other reasons.

The design of the automated workflow includes the following changes:
1.Each WS can define a timeout setting by using Digital Payments configuration entries that are used to seed the OBJ_BASE.TIMEOUT value at insert.
2.Timeout Config:
 
Digital Payments Integration Package adds the following config value:
    Category       : IP_OBJ_STATUS_TIMEOUT
    Key                 : S_TxnMapped
    Value             : 60 (seconds)
 
The default values for Reason code and Reason can be changed by updating FTM.VALUE table by setting the CATEGORY to ‘IP_CONFIG’ and the KEY value to one of the following values:
(a) INTERNAL_TIMEOUT_REASONCODE for Reasoncode
(b) INTERNAL_TIMEOUT_REASON for Reason

Available general options – Events configuration for WS transaction timeout
FTM supports configuration of various events for WS transaction timeout. The details of the events raised for each action are provided along with the database table name, category, and key.
Table: VALUE
    Category    : CORE  
    Key              : MAP_TIMEOUT_ACTION
    Value           : see the following table
Options configured for WS transaction timeout Events raised
OPERATOR
(Available operator actions are: Cancel or Continue)
E_MapTimeoutOperator
CONTINUE            E_MpInTxnMapped
FAILED E_MpInTxnMapFailure
Event Specific event
Default E_MapTimeoutFailed
ABORT: For Future use E_MpInMappingAborted
A transition is added to the outgoing payment FSM to allow timeout events to cause a transition to a Reject path. It also creates an Error record and sends the channel status. The channel response ISF is an Acknowledgment type or structure, which includes original transaction ISF and reason for failure.

Enrich/Fetch Interac Participant ID information from participant directory and pass it to Interac

The Channel Credit Transfers Request (PAIN.001) debtor ID contains the FTM Participant ID. FIs can register their customer at Interac with a different Interac Registration ID. When a customer is registered with a different ID, then the workflow should retrieve the Interac Registration ID from Participant Directory and enrich it as the debtor ID on the Outbound Score and Send requests to the Interac network
Debtor ID as received from Channel should be stored in master ISF under Identification[xsi:type="isf:OrganisationIdentification"]/OtherIdentification/Identification (under Party)
FTM fetches a registration ID from Digital Payments for the transactions and stores it in the object value table. Key = INTERAC_ID, CATEGORY = IP_ENRICH_FROM_PD
Across all interface requests like score, fraud, sanctions, send payment, and account reversal - System sends only one debtor identification as enriched from the Digital Payments layer (if it is unavailable, the ID as received from the channel API is sent)
Include clearing system ref (network ID) in published response events for update auth and cancel workflows
FTM now includes the Clearing System Reference of the payment in the Channel Ack ISF for Update Auth and Cancel.
Therefore, publication of same also includes this field.
Add supplementary data section to update authentication API and include in ISF mapping
Added a supplementary data section mapping to ISF for the Update Authentication API, similar to that of the Cancel Payment API.
Dynamic action based on fraud response and instructed time [#8 and #10]
FTM can accept an enhanced Pending / Hold response where the fraud system gives a time limit and then a default response to take if it does not respond.
 
     <Addenda xsi:type="isf:ISFMessageAddenda">
            <SourceData>
                    <MessageData>
                            <Expiry>
                                   <Period>10000</Period>
                                   <Action>RJCT</Action>
                            </Expiry>
                    </MessageData>
            </SourceData>
     </Addenda>
A Hold Period/Action supersedes a Pending one.  Both supersede the default PreCheck static configuration.
Include configured Category for PFS errors in Status to Debtor ISF
This function is related to [Payment APIs] Add to Error Code a Source System Attribute and Include in RESTful API Responses [#23] (116606)


Where the system is configured to record PFS errors as additional error records in Immediate Payments, the Status to Debtor ISF includes the PFS error Category in the Originator element of the StatusReason ISF.
Refresh Interac Provided/Required APIs Based Upon Oct 2020 Interac YAMLs
Updated the YAML Specification changes for November 2020.
1) EmailAddress field maxLength changed to 256
2) For a few fields, minLength is added.
[Accnt Reversal] Enrich/Fetch Interac Participant ID information from Participant Directory and pass it to Interac
The Channel Credit Transfer Request (PAIN.001) debtor ID contains the FTM Participant ID. Financial institutions (FIs) can register their customer at Interac with a different Interac Registration ID. When a customer is registered with a different ID, the workflow retrieves the Interac Registration ID from the participant directory and enriches it as the debtor ID on the Outbound Score and Send requests to the Interac network
Debtor ID as received from Channel should be stored in master ISF under Identification[xsi:type="isf:OrganisationIdentification"]/OtherIdentification/Identification (under Party)
FTM fetches a registration ID from Digital Payments for the transactions and stores it in the object value table. Key = INTERAC_ID, CATEGORY = IP_ENRICH_FROM_PD
Across all interface requests like score, fraud, sanctions, send payment, and account reversal - System sends only one debtor identification as enriched from the Digital Payments layer (if it is unavailable, the ID as received from the channel API is sent)
Propagate Fraud Case ID to Sanction system in ISF
Interac generates a unique fraud case ID as part of score payment response, which can be used during rescoring and sending a payment. This fraud case ID is used to keep track of the fraud case and update Interac on outcome of the payment.
FTM includes the fraud case ID in the ISF message that is transmitted to the fraud system of the bank for RTD fraud check and sanction check. It also includes this fraud case ID in the send payment request to Interac.
Avoid execution of ImageContentSourcePolicy multiple times
When FTM, Immediate Payments, Digital Payments, or Interac is deployed by using air gap case bundle commands, the process has a cloudctl case launch step that configures the OCP cluster for image mirroring. Similar steps are documented here: https://www.ibm.com/docs/SSGT7J_20.2/install/mirroring_operators.html. Search for "Configure a global image pull secret and ImageContentSourcePolicy."

The FTM base, Immediate Payments, Digital Payments, or Interac case bundles have the same ImageContentSourcePolicy that configures the cp.icr.io/cp and docker.io/ibmcom to mirror to the local customer repository. The ImageContentSourcePolicy should be applied in the FTM base case bundle. You do not need to reapply the policy for Immediate Payments, Digital Payments, or Interac e-Transfers. By applying the policy only one time, the worker nodes are restarted only during the FTM base installation.

Red Hat OpenShift plans to avoid restarting the worker nodes on ImageContentSourcePolicy configuration in future releases.

[{"Line of Business":{"code":"LOB10","label":"Data and AI"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSPKQ5","label":"IBM Financial Transaction Manager"},"ARM Category":[{"code":"a8m50000000ClaTAAS","label":"Product Documentation"}],"ARM Case Number":"","Platform":[{"code":"PF016","label":"Linux"}],"Version":"4.0.3"}]

Document Information

Modified date:
10 June 2022

UID

ibm16430593