Skip to content

Integrations That Fail Politely: Retries, Logs and the ERP That Goes Down at Midnight

Syncing orders to your ERP, sending customer message updates, reconciling payments: the boring integrations run the business. Here is how to build them so they break gracefully.

Ask any operations lead where the hours go and you will hear a familiar list. Orders copied from the storefront into the ERP. Stock levels updated by hand at the end of the day. Payment settlements matched against invoices in a spreadsheet. Customers chasing delivery updates that someone has to send by hand in a chat app.

These are not glamorous problems, which is precisely why they linger. Yet automating them is often the highest-return engineering work a growing company can do. The catch is that a careless integration can be worse than the manual process it replaced, because it fails silently. The goal is not just automation. It is automation that fails politely.

Assume every system on the other end will misbehave

Integrations sit between systems you do not control. The ERP goes down for maintenance at midnight. The payment gateway's webhook arrives twice, or late, or out of order. The messaging provider rate-limits you during a sale. None of this is exceptional; it is the normal weather of integration work.

Designing for that weather means a few non-negotiable habits:

  • Retries with backoff. A failed call should be retried after a short wait, then a longer one, not hammered in a tight loop that makes the outage worse.
  • Idempotency. Processing the same order or webhook twice must not create two invoices or send two messages. Use a stable identifier and check before you write.
  • A queue between systems. Rather than calling the ERP directly when an order is placed, put the job on a queue. If the ERP is unavailable, the work waits instead of disappearing.
  • A dead-letter pile. After a sensible number of retries, failed jobs should land somewhere visible, with enough context for a human to fix and replay them.

Logging is the product

For an integration, the logs are not a debugging aid. They are how your operations team knows whether the business is working. When a customer says they never received a confirmation, someone should be able to search by order number and see exactly what happened: when the message was queued, what the provider replied, and whether a retry succeeded.

That means structured logs with consistent fields, such as the order or payment reference, the target system, the attempt number and the outcome. It also means a simple, readable view for non-engineers. A modest internal page listing today's failed syncs, with a button to retry, often does more for trust than any amount of architecture.

An integration nobody can see into is an integration nobody will trust, and people who do not trust automation quietly go back to spreadsheets.

Reconcile, do not just sync

Even well-built integrations drift. A webhook is missed, a record is edited by hand, a vendor changes a field format without telling anyone. The defence is a regular reconciliation job that compares both sides and reports the differences.

For payments, this might be a nightly comparison of gateway settlements against orders marked paid. For inventory, a daily check of stock counts between the warehouse system and the storefront. The reconciliation does not need to fix everything automatically. It needs to surface mismatches early, while they are still small and explainable.

Customer messaging deserves extra care

Customer-facing messages are where integration mistakes become visible. A few principles help:

  1. Use approved templates and keep their variables predictable, so a missing field does not produce a broken message.
  2. Respect opt-in and opt-out properly, and record consent alongside the customer profile.
  3. Never send from inside the main checkout request. Queue the message so a slow provider cannot slow down the purchase.
  4. Deduplicate aggressively. Two identical "your order has shipped" messages undermine confidence more than one late one.

Scope it narrowly, then extend

The most successful integration projects start with a single flow, done properly: orders from the website into the ERP, with retries, logging and a reconciliation report. Once that runs quietly for a few weeks, adding stock sync or payment matching becomes straightforward, because the plumbing already exists.

Trying to connect everything at once tends to produce a tangle of half-finished flows, none of which anyone fully trusts. Narrow scope is not timidity; it is how you earn the right to automate more.

Notepoint's integrations and automation engagements are built around exactly this pattern: one well-defined flow, with retries, logs and a handover your team can operate. If you are not sure which process to automate first, a short advisory session can help you rank them by effort and payoff.

Put it into practice

Engagements from APIs & Integrations

All in this practice

Payment Gateway Integration

End-to-end payments across UPI, cards and netbanking, with webhooks and reconciliation engineered for real-world traffic.

Complete integration covering UPI, cards, netbanking and wallets

₹24,999

14 working days · GST incl.

Add

REST API Design and Documentation

A versioned API contract with OpenAPI documentation, worked examples and a mock server partners can build against immediately.

OpenAPI 3 specification covering up to 40 endpoints

₹18,999

9 working days · GST incl.

Add

Business Messaging API Integration

Order updates, reminders and support replies over an official business messaging API, with approved templates and tracked delivery.

Business verification and messaging API account setup

₹22,999

15 working days · GST incl.

Add