On this page
  1. Why it matters
  2. Three families
  3. The landscape
  4. Protocols and formats
  5. How to choose
  6. Trade-offs
  7. Pitfalls
  8. Questions for a design review

Why it matters

A bank runs a core, card systems, loan systems, payment hubs, channels, fraud engines, data platforms and dozens of third-party connections. Each speaks its own language: fixed-width files, SOAP web services, REST APIs, ISO payment messages. Integration technology is what lets them work together. Done well, it hides that variety. Done badly, it becomes the least-understood and most fragile part of the estate.

Three families

An enterprise service bus (ESBEnterprise service bus. Middleware that connects many applications through a central hub, often translating messages between them.) is central middleware that routes, transforms and orchestrates messages between applications. Many banks introduced one to replace point-to-point links with a hub. Its risk is that business logic accumulates inside it.

An APIApplication programming interface. A defined way for one system to request data or actions from another. gateway is a front door for APIs. It handles identity, rate limits, validation and logging, and passes requests to the services behind it. It should route and protect, not hold business logic. See API-first and open banking.

A service mesh manages traffic between services inside a platform, usually containers. It adds mutual TLS, retries, time-outs and telemetry to every service-to-service call without changing the services’ code.

The landscape

Integration technologies
TechnologyFamilyTypical use in Indian bankingNotes
IBM App Connect, TIBCO, Oracle SOA SuiteEnterprise service bus and integration suitesConnecting cores, card systems and older applicationsMature; often the oldest integration layer in a bank
MuleSoft AnypointAPI-led integration platformExposing core functions as APIs; partner integrationCommercial licensing
WSO2Open-source API management and integrationAPI gateways and integration, on-premises or cloudOpen-source core with commercial support
Kong, Apigee, cloud API gatewaysAPI gatewayChannel and partner APIsChoose by where APIs run and how they are governed
Envoy, Istio, LinkerdProxy and service meshTraffic between microservices on container platformsOperational complexity; best on mature platforms
File transfer (managed SFTP and similar)Batch integrationBulk files such as NACH, statements and regulatory extractsStill essential; secure and monitor it like any interface

Typical uses are general industry patterns, not claims about named banks. Product names are for reference only.

Protocols and formats

  • SOAP and XML are common in older enterprise systems, with strict contracts.
  • REST and JSON are the default for new APIs: simple, widely understood, easy to test.
  • gRPC uses compact binary messages and suits fast internal service-to-service calls.
  • ISO payment messages, ISO 8583ISO 8583. An international standard for card and similar transaction messages, used by card networks and ATM switches. for cards and ISO 20022ISO 20022. An international standard for richly structured financial messages, increasingly used for high-value and cross-border payments. for richer payment data, need specialist parsers and validation.
  • Flat files remain the backbone of batch processing.

Much of an integration layer’s work is protocol translation: accepting a REST call from an app and turning it into the SOAP call or file the core understands, then translating the answer back. Shared specifications reduce this work. For example, in the Account Aggregator framework Financial information users in the Account Aggregator framework adopt technical specifications published by ReBIT.1Securities and Exchange Board of India. Consultation paper on Financial Information Users in the securities markets under the Account Aggregator framework. As of 1 August 2023.

How to choose

Use a gateway for anything exposed to channels or partners. Use a service mesh only when many services on one platform need consistent security and traffic control, and the team can run it. Keep an ESB or integration suite for connecting systems that cannot speak modern APIs, and resist adding new business logic to it. For every interface, decide whether it must be synchronous (the caller waits) or can be asynchronous (a message on a queue or log); many can be asynchronous, which makes them more resilient.

Trade-offs

Integration choices
ChoiceYou gainYou give up
Central ESBOne place to connect and monitorA bottleneck and a single point of failure; logic hides inside it
API gateway plus servicesClear contracts; logic stays in servicesMore services to build and run
Service meshUniform security and telemetry between servicesA complex platform component to operate
Point-to-point linksQuick for one connectionUnmanageable as connections multiply

Pitfalls

  • The smart pipe. Business rules added to the ESB or gateway, where nobody can test them properly.
  • Chained synchronous calls, where one request waits on five others and fails if any of them is slow.
  • No time-outs, so a slow downstream system ties up every thread upstream.
  • Unmonitored file transfers that fail quietly at night.
  • Undocumented transformations, so nobody knows how a field in one system maps to another.

Questions for a design review

  • Where does each business rule live, and is any of it in the integration layer?
  • Which calls could be asynchronous instead of waiting for an answer?
  • What are the time-out and retry settings for each downstream call?
  • How is a failed file transfer detected, and by whom?
  • Is every field mapping documented and tested?