The problem orchestration solves
Most businesses start with one payment provider. Over time they add a second for redundancy, a third for a specific payment method, and suddenly every provider has its own API, its own error codes and its own settlement report.
Payment orchestration puts a single, consistent layer between the product and those providers.
What the layer is responsible for
- One API for the product. Checkout and payout code talks to one interface, not five.
- Routing decisions. Each transaction can be routed by method, amount, provider health or cost rules.
- Retries and fallbacks. A failed attempt can be retried on another provider when that is safe to do.
- Normalised data. Statuses, errors and settlement records are translated into one model.
- Reconciliation. Provider reports are matched to internal records automatically.
Design principles we follow
- Every operation is idempotent, so a retried request never charges twice.
- Every state change is recorded as an event, which makes audits and debugging straightforward.
- Routing rules are configuration, not code, so finance and operations teams can change them safely.
Orchestration is not about adding providers. It is about making the number of providers irrelevant to the rest of the product.
When it is worth it
If you use a single provider and a single payment method, orchestration is probably premature. Once you depend on several providers, or downtime at one provider directly costs revenue, a well-designed orchestration layer usually pays for itself in reliability and operational clarity.