> For the complete documentation index, see [llms.txt](https://docs.hyperswitch.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hyperswitch.io/faqs/payment-orchestration-faq.md).

# Payment Orchestration FAQ

### What is payment orchestration?

Payment orchestration is a control layer that sits between your application and multiple payment processors or acquirers. It provides a unified API while enabling routing, retries, failover, observability, and optimization across providers.

Processors continue to handle authorization, clearing, and settlement. The orchestration layer determines how and where transactions are processed.

If you're new to Hyperswitch, start here:

* [What is Hyperswitch?](https://docs.hyperswitch.io/about-hyperswitch/readme-2)
* [Architecture Overview](https://hyperswitch.io/blog/building-hyperswitch-the-world-s-first-open-source-payments-platform)

### Does orchestration replace my payment processor?

No. Orchestration complements processors.

Processors:

* Connect to card networks
* Authorize and settle transactions
* Provide risk tooling

Orchestration:

* Routes transactions
* Applies retry and failover logic
* Normalizes responses
* Centralizes configuration
* Enables cross-PSP reporting

For implementation details, see:

* [Connector Integration](https://docs.hyperswitch.io/explore-hyperswitch/connectors)
* [Payments API Reference](https://api-reference.hyperswitch.io/introduction?_gl=1*1bcxxw7*_gcl_au*MTI0MjY2OTQyLjE3NjU5ODIzNTE.*_ga*MTY2MzIzNjM1OC4xNzI3NjA1NDEy*_ga_1X38KQVJ1S*czE3NzI0MjY1OTUkbzIzMiRnMSR0MTc3MjQyNzYwNSRqMjIkbDAkaDA.*_fplc*ZCUyRjdYWkhSbjAyaTRFM0I4TWRLalZzN00lMkJ6bjhyb2V0UTgyY2hNMEN5dUVLMkFmdUNEeWQlMkZjYUh6YnlKdGxnS1BLTFJzUHRFM0xoRyUyRnd0VHJjT2QxTGxOMXRib1FDJTJGU2QzQTRDdVRYb2hEaXk2dkpFQVQlMkJUYmlQQ0xaMnpRJTNEJTNE)

### Why would I need orchestration if I already use a PSP?

A single PSP may be sufficient early on. Orchestration becomes relevant when payments materially impact revenue, cost, or availability.

Common triggers include:

* Improving authorization rates
* Reducing processing costs
* Expanding to multiple regions
* Avoiding single-provider dependency
* Supporting marketplace or ISV complexity

For routing and configuration examples:

* [Routing Documentation](https://docs.hyperswitch.io/explore-hyperswitch/workflows/intelligent-routing)

### How does orchestration improve authorization rates?

Approval improvements typically come from:

* BIN or country-based routing
* Local acquirer selection
* Success-rate-aware routing
* Automated retry with alternate processors

For technical details:

* [Routing Rules Configuration](https://docs.hyperswitch.io/explore-hyperswitch/workflows/intelligent-routing/rule-based-routing)

### How does orchestration reduce processing costs?

Cost optimization may involve:

* Routing to lower-cost processors
* Domestic versus cross-border optimization
* Negotiating across multiple providers
* Intelligent retry strategies

To configure cost-based routing:

* [Connector Matrix](https://juspay.io/integrations)

### How complex is it to implement?

Implementation typically involves:

1. Integrating with the Payments API
2. Configuring one or more connectors
3. Defining routing rules
4. Testing in sandbox

Start here:

* [Your First Payment Guide](https://docs.hyperswitch.io/#your-first-payment)
* [Unified Local Setup Using Docker](https://docs.hyperswitch.io/hyperswitch-open-source/readme-1/unified-local-setup-using-docker)

For API details:

* [API Reference](https://api-reference.hyperswitch.io/introduction?_gl=1*1bcxxw7*_gcl_au*MTI0MjY2OTQyLjE3NjU5ODIzNTE.*_ga*MTY2MzIzNjM1OC4xNzI3NjA1NDEy*_ga_1X38KQVJ1S*czE3NzI0MjY1OTUkbzIzMiRnMSR0MTc3MjQyNzYwNSRqMjIkbDAkaDA.*_fplc*ZCUyRjdYWkhSbjAyaTRFM0I4TWRLalZzN00lMkJ6bjhyb2V0UTgyY2hNMEN5dUVLMkFmdUNEeWQlMkZjYUh6YnlKdGxnS1BLTFJzUHRFM0xoRyUyRnd0VHJjT2QxTGxOMXRib1FDJTJGU2QzQTRDdVRYb2hEaXk2dkpFQVQlMkJUYmlQQ0xaMnpRJTNEJTNE)

### Can I migrate gradually?

Yes. Migration can be done incrementally using routing rules or traffic splitting.

Common strategies:

* Route a small percentage of traffic
* Pilot by geography or BIN range
* Run A/B comparisons across processors
* Enable instant rollback

### What happens if the orchestration layer fails?

High availability depends on deployment architecture.

Best practices include:

* Horizontal scaling
* Load balancing
* Health checks
* Observability and alerting

See:

* [Deployment Guide](https://docs.hyperswitch.io/hyperswitch-open-source/readme-1)

### How does orchestration affect PCI compliance?

Compliance impact depends on deployment model and integration pattern.

Considerations include:

* Card data handling
* Tokenization strategy
* Encryption key management
* Self-hosted versus SaaS responsibilities

For more details:

* [Security and Compliance Overview](https://docs.hyperswitch.io/explore-hyperswitch/security-and-compliance)

### How does orchestration handle multiple payment methods?

Orchestration normalizes payment methods across connectors while preserving connector-specific capabilities.

Supported methods may include:

* Cards
* ACH
* Wallets
* Buy Now Pay Later
* Alternative payment methods

See:

* [Supported Payment Methods](https://juspay.io/integrations)
* [Connector Documentation](https://docs.hyperswitch.io/explore-hyperswitch/connectors)

### How does reporting and reconciliation work?

Hyperswitch centralizes transaction metadata and routing decisions, enabling unified reporting across processors.

For logging and monitoring:

* Observability Documentation
* Log Export and Storage

This simplifies:

* [Cross-PSP reconciliation](https://docs.hyperswitch.io/explore-hyperswitch/payments-modules/reconciliation-product)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hyperswitch.io/faqs/payment-orchestration-faq.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.