← Back to insights

Infrastructure

What a TSYS Integration Actually Buys You

Direct TSYS integration is not a vendor swap. It is a different way of operating payments. What changes in latency, settlement, and risk posture when the integration is engineered correctly.

Hitpixel··8 min

A direct TSYS integration is not a vendor swap. It is a different way of operating payments. The difference shows up in the median authorization latency, in the settlement timing, in the granularity of the chargeback feed, and in what a client can do when an issuer pushes back on a corridor at 3am. This post is about what changes when a client moves from an aggregated processor to a direct TSYS integration, and what the engineering practice looks like once they do.

What an aggregated processor hides

The pitch from an aggregated processor is that the integration is simple. You ship the SDK, you call the charge endpoint, and the platform handles everything underneath. That is true, until it stops being true.

The endpoint that hides the network call also hides the latency budget. When the aggregator routes through a chain of intermediaries to reach the issuer, every hop costs 40 to 80 milliseconds. A median-tier aggregator adds 250 to 400 milliseconds of avoidable latency to every authorization before the network even sees the request. Most product teams never measure this, because the dashboard the aggregator provides is the dashboard the aggregator wants them to see.

The endpoint that hides the network call also hides the failure modes. When an issuer responds with a soft decline that means "retry in 30 seconds with a slightly different request shape," the aggregator typically translates that to a hard decline because the aggregator does not have the staff to maintain a per-issuer translation table. The client absorbs the lost transaction and never sees what the issuer actually said.

The chargeback feed is the third thing the aggregator hides. Most aggregators batch chargeback notifications on a 24 to 72 hour cadence. By the time the chargeback hits the client's dashboard, the fraud pattern that caused it has moved on to the next merchant. A direct TSYS feed delivers chargeback labels in near real time, which is the difference between a fraud model that learns and one that does not.

What changes with a direct TSYS integration

The Hitpixel payments practice runs TSYS integrations for clients in regulated and high-trust verticals. The engineering pattern is consistent across engagements. Authorization flows hit the TSYS platform directly. The response handling lives in code we wrote, which means soft declines are translated against a per-issuer table we maintain across the practice. The chargeback feed comes in near real time and lands in the client's risk pipeline within seconds of issuance.

The numbers we measure on a typical migration from an aggregated processor to a direct TSYS integration are consistent enough to write down. Median authorization latency drops by 280 to 350 milliseconds. The approval rate climbs by two to four percentage points in the first 30 days, almost entirely from converting soft declines that the aggregator had been translating into hard declines. Chargeback signal latency drops from 24 hours to under 60 seconds, which compounds in the fraud model over the next quarter.

The settlement piece is the other change. A direct TSYS integration gives the client transparent settlement timing, configurable per-funding-instrument. The aggregator's settlement timing is whatever the aggregator decides it is, which is usually optimized for the aggregator's cash management, not the client's.

What the integration engineering actually looks like

The integration code is not the hard part. The hard parts are the operational posture, the failure-mode coverage, and the per-issuer translation table that has to be maintained against changes the networks ship continuously.

The operational posture means somebody on the engineering team is on the pager when TSYS issues a maintenance notice. The platform sends real-time advisories. A client without a direct integration partner sees those advisories second-hand, through their aggregator's communication channels, with whatever delay the aggregator's process introduces. A direct integration means the client's engineering team gets the advisory at the same time TSYS publishes it.

The failure-mode coverage is the difference between an integration that runs for three years without incident and one that drops one percent of transactions when an issuer changes a downgrade rule. Failure modes accumulate. Each issuer, each scheme update, each new soft-decline reason code is a translation rule that needs to land in the integration. The teams that maintain this well treat it as a continuous engineering practice, not as a project that ends at go-live.

The per-issuer translation table is the asset that compounds. Three years into a TSYS integration practice, the translation table is the moat. A new entrant building against TSYS for the first time can read the documentation. They cannot get to the same approval rate on day one, because the documentation does not contain the years of operating signal that the table encodes.

What it does not buy you

A direct TSYS integration does not eliminate the fraud problem. The fraud model still has to be engineered against the client's own data, and that work is described in detail in another post on this site. The TSYS integration delivers cleaner signal into the fraud model. It does not replace the model.

A direct TSYS integration does not eliminate the compliance work. PCI DSS posture still has to be engineered into the system, certified by an external auditor, and maintained on an annual cadence. Hitpixel partners with ValueMentor for the certification work; the integration architecture lands inside the certified scope on day one rather than being retrofitted afterwards. This is covered in more detail in our PCI DSS post.

A direct TSYS integration does not eliminate the operational cost. It shifts the cost from "fees paid to the aggregator" to "engineering time spent on the integration." For clients below a certain volume threshold, the aggregator math is correct. Above that threshold, the direct integration is the only answer that does not leak revenue. The break-even point is volume-dependent and conversation-dependent, and most clients hit it sooner than they think.

How to know if you are ready

Three quick tests.

First, look at your aggregator's reporting. Can you see, per authorization, which acquirer carried the request, what the issuer's response code was, and what the aggregator's interpretation of that response was? If the answer is no, the aggregator is hiding signal that a direct integration would expose.

Second, look at your chargeback feed. How long is the gap between when a chargeback is issued and when it lands in your risk pipeline? If the answer is more than four hours, your fraud model is being trained on stale data.

Third, look at your monthly statement. How many line items can you actually reconcile to specific transactions? If the answer is "the total and a few category buckets," the aggregator's reporting is below the threshold a TSYS-grade integration would deliver.

If any of those three answers is uncomfortable, the conversation about a direct TSYS integration is one worth having. The integration practice that delivers it is the work our team does for clients across the verticals on the portfolio page.

paymentstsysintegrations

Speak with operations

Partnerships, press, and direct enquiries.

We reply within two business days.

Get in touch