Routing must be adaptable, but an unrecorded change can make the next incident impossible to explain. Speed and control should be designed together.

State the reason before the rule

Describe the observed problem, affected segment and intended outcome. Name the person who can approve the change. A route edit should not begin from a vague request to send more traffic elsewhere.

Version the policy

Record the previous and new rule set, the exact eligibility or priority change, its effective time and the payments in scope. Historic payments must continue to reference the version that made their decision.

Limit the first exposure

Where the business context permits, introduce the change to a defined segment and keep a qualified fallback available. Confirm credentials, limits, callbacks, monitoring and support readiness before treating a technically integrated route as a safe alternative.

Verify and close

Compare the same segment after the change, including success, failure reasons, latency and operational exceptions. Record whether the result supports keeping, refining or reverting the policy. Closure should include both the metric and the accountable decision.

Prepare rollback before activation

Document the last known policy, the condition that should stop the rollout and the person authorised to restore it. Confirm that the previous route remains technically and commercially usable; a configuration snapshot is not a fallback if its credentials or provider approval have expired. During an incident, the team should be able to reverse a change from the recorded plan and then explain which payments were evaluated under each version.

A routing change is complete only when its reason, version, owner and observed result can be reconstructed.

Make route changes reversible and explainable.

Review policy versions, approvals, fallback readiness and post-change evidence.

Review routing controls →