Orchestra API vs Orchestra Library – Choose Your Integration

Orchestra offers two integration approaches for payment orchestration. Both eliminate the complexity of managing multiple payment gateway integrations, but serve different architectural needs.

Your implementation choices

Orchestra API

Orchestra API provides direct payment gateway orchestration via REST API. You send transaction data in our standardized format, we handle gateway-specific requirements, and return consistent JSON responses regardless of which gateway processes the payment. Since you handle card collection, this enables the use of third-party tokenization providers.

Orchestra Library

Orchestra Library delivers a complete payment experience with pre-built UI components for both card alternative payment methods. The JavaScript library handles payment collection, authentication, and processing automatically while keeping your business outside PCI-DSS scope. Built-in support for 3D Secure, OTP authentication, and modern payment methods means faster deployment.

Feature comparison

CapabilityOrchestra APIOrchestra Library
Integration MethodREST API callsJavaScript library
Payment CollectionYou handle card details (directly or through third-party tokenization)We handle all payment details
PCI ComplianceYour responsibilityYou are out of scope
UI ControlFull customizationPre-built components
Gateway Failover✓ Automatic✓ Automatic
Tokenization✓ Orchestra or gateway✓ Orchestra or gateway
3D Secure/OTPManual implementation✓ Built-in
Digital WalletsAPI integration required✓ Native support
Regional MethodsAPI integration required✓ Native support
Deployment SpeedCustom developmentRapid deployment
Payment Gateway AdditionsNo additional costNo additional cost
Payment Method Additions(Not applicable)No additional cost

Which approach is right for you?

Choose API if you:

  • Have existing payment flows
  • Need specific UI control
  • Want to manage credit cards internally and/or use third-party tokenization providers
  • Prefer building custom experiences

Choose Library if you:

  • Want rapid deployment
  • Prefer to avoid PCI compliance scope
  • Need modern payment methods immediately
  • Want battle-tested payment experiences.

Both approaches provide automatic gateway failover and payment gateway additions at no additional cost. The choice comes down to control versus speed.

Free to start • No credit card required