Use a computer

For full performance and fluidity, please open Pay Engineers on a desktop or laptop. On mobile, the experience is limited — especially authenticated sections and advanced tools after login.

Engineering

Observability for payment systems

Infrastructure metrics alone consistently miss payment reality: authorisation rates by BIN country, 3DS challenge success and settlement file freshness tell a very different story than CPU graphs. We explain how to trace across acquirer dependencies and alert on customer impact instead of noise.

Jul 2, 2026 5 min 2,715 0

A payment platform can show entirely healthy infrastructure dashboards — green CPU graphs, normal memory usage, no elevated error rates at the load balancer — while customers in a specific country are quietly unable to complete payments because a specific issuer BIN range is failing authorisation. Infrastructure metrics alone consistently miss this class of problem, because the failure is happening correctly, from a systems perspective, at every layer that infrastructure monitoring watches.

The business-level metrics that actually matter

Authorisation rate segmented by BIN country and card type reveals issuer-specific or corridor-specific problems that an aggregate authorisation rate completely hides — a healthy 95% aggregate rate can mask a 40% rate for one specific issuer that a segmented view would surface immediately. 3DS challenge success rate, tracked separately from challenge abandonment, distinguishes a genuine authentication problem from customers simply giving up on a confusing challenge screen. Webhook delivery lag matters because merchants build order fulfilment logic on webhook timing, and a growing lag silently degrades merchant trust before anyone files a support ticket. Settlement file freshness — how current the settlement data available to finance and merchants actually is — determines whether "money in the bank" claims match what your systems are reporting.

Distributed tracing across the acquirer chain

A customer complaint that "payments are slow" is undiagnosable without tracing that follows a single transaction across every hop it takes: gateway, risk engine, acquirer adapter, scheme network, issuer, and back. Without end-to-end tracing, "slow" could mean anything from a risk engine timeout to an acquirer's degraded response time to a genuinely slow issuer — and each of those has a completely different remediation.

Correlating traces with business context

Traces that carry only technical span data (service name, duration, status code) are less useful than traces enriched with business context — merchant ID, corridor, card type, exemption or challenge status. That enrichment is what lets an engineer investigating a trace immediately see "this is a 3DS challenge failure for merchant X in corridor Y" rather than needing to cross-reference three other systems to reconstruct that context.

Alert hygiene: customer impact, not container restarts

A common observability anti-pattern in payment platforms is alerting on every infrastructure-level anomaly — a container restart, a brief CPU spike, a transient connection pool exhaustion — regardless of whether any customer transaction was actually affected. This trains on-call engineers to treat alerts as noise, which is exactly the failure mode you cannot afford when a genuine customer-impacting incident occurs.

Alerts should be tied, wherever possible, to measurable customer or business impact: a sustained drop in authorisation rate for a specific segment, a spike in webhook delivery lag past a threshold that affects merchant fulfilment SLAs, a settlement file that has not refreshed within its expected window. Infrastructure metrics remain valuable for diagnosis once an alert fires, but they should rarely be the trigger for paging someone at 3am.

An observability implementation checklist

  • Segment authorisation rate by BIN country, card type and corridor, not just in aggregate.
  • Track 3DS challenge success and abandonment as distinct, separately monitored metrics.
  • Monitor webhook delivery lag and settlement file freshness as first-class business SLAs.
  • Build distributed tracing across gateway, risk engine and acquirer adapters, enriched with business context.
  • Tie paging alerts to measurable customer impact rather than raw infrastructure anomalies.

Budgeting for observability as part of the product

Observability investment in payment systems is not an infrastructure line item to be minimised — it is part of the product itself, because the ability to diagnose and resolve payment problems quickly is directly experienced by merchants and their customers as reliability. Platforms that budget for this properly resolve incidents in minutes with clear root causes; platforms that do not spend days reconstructing what happened from scattered logs.

"Payments are slow" is not a diagnosis. It is the beginning of an investigation that good observability should resolve in minutes, not days.

Dashboards for different audiences

A single observability dashboard rarely serves everyone who needs payment visibility. Engineers on call need low-level trace and error detail to diagnose quickly. Operations and support teams need merchant- and transaction-level status lookup to answer customer queries without filing an engineering ticket. Finance and leadership need trend-level views of authorisation rates, settlement freshness and dispute volumes over time, without the noise of individual transaction detail.

Building distinct, audience-appropriate views on top of the same underlying telemetry — rather than a single dashboard everyone is expected to interpret correctly for their own purposes — meaningfully reduces both misinterpretation and the number of "can someone check if payments are working" messages that land on an engineering team's plate every day.

Key takeaways

  • Infrastructure health metrics alone routinely miss payment-specific, customer-impacting problems.
  • Segmented authorisation rates and 3DS metrics reveal issues that aggregate numbers hide.
  • Distributed tracing enriched with business context turns vague complaints into diagnosable paths.
  • Alert on measurable customer impact, not every infrastructure-level anomaly.
  • Treat observability investment as part of the product experience, not a cost to minimise.

Comments

0 comments

Sign in to leave a comment.

Accedi

No comments yet. Be the first to comment.

Keep reading

Related articles

More content that may interest you

View all posts
Featured
Engineering

Event-driven settlement pipelines that finance can trust

From authorisation events to books-ready settlement figures, finance teams need deterministic, replayable pipelines rather than eventual-consistency folklore. We explain how explicit batches, checksum reconciliation and human exception workbenches turn month-end from a fire drill into a routine.

18/07/2026 5 min 3,751 0
Engineering

API design principles for merchant integrations

Resource naming, signed webhooks and genuinely usable sandbox credentials do more to reduce support load than any amount of documentation polish. We cover the painful integration paths — partial captures, late refunds, disputed chargebacks — that separate great payment APIs from merely functional ones.

06/07/2026 5 min 1,082 0
Engineering

Migrating between PSPs without a big-bang cutover

Big-bang PSP cutovers are how outages happen, and traffic-shifting migrations with clear rollback plans consistently outperform weekend deploys. We explain dual-running, cohort-based migration and the credential isolation that keeps a provider switch low-drama for merchants.

27/06/2026 5 min 412 0