Documentation

How It Works

Understand how Corridorly orchestrates complex workflows

OrchestrationIntelligent RoutingCompliance-First

Overview

Corridorly is a payment orchestration platform that helps businesses route transactions intelligently across multiple payment providers, manage compliance requirements, and optimise conversion rates—all through a single integration.

One Integration

Connect once to Corridorly, access multiple payment providers and services

Intelligent Routing

Route payments based on cost, conversion, geography, and custom business rules

No-Code Control

Configure routing logic, compliance rules, and workflows without code changes


The Problem

Modern businesses face increasing complexity when managing payments and financial workflows:

Multiple Payment Providers

Each provider requires separate integration, maintenance, and monitoring. Changes require engineering resources and deployment cycles.

Complex Routing Logic

Routing decisions based on geography, currency, payment method, risk assessment, and cost optimisation are hardcoded into your application.

Compliance & Governance

KYC checks, sanctions screening, fraud detection, and regulatory requirements need to be orchestrated alongside payment processing.

Limited Visibility

Tracking transactions across providers, understanding why routing decisions were made, and analysing performance requires significant effort.

The Result: Teams spend time maintaining integrations instead of building features. Business logic lives in code, requiring engineering time for every change. Growth into new markets or adding providers becomes a major project.


The Corridorly Solution

Corridorly provides a unified orchestration layer that sits between your application and payment providers, compliance services, and other integrations. Configure complex workflows without code and adapt instantly to changing business needs.

Workflow Orchestration

Pre-built multi-step workflows (Symphonies) that combine compliance checks, risk assessment, routing decisions, and payment execution in sequence. Configure and customize them for your specific needs.

Dynamic Routing

Route transactions intelligently based on real-time factors like geography, currency, amount, customer history, provider performance, and custom rules.

Marketplace

Battle-tested workflows, compliance checks, and integrations built by Corridorly. Subscribe to marketplace symphonies, configure them to your requirements, and deploy instantly.

Real-time Analytics

Track every decision, monitor provider performance, analyse conversion rates, and understand exactly why each transaction was routed the way it was.


How It Works

Here's what happens when a payment flows through Corridorly:

1

Your Application Makes a Request

Your application sends a single API request to Corridorly with the payment details, customer information, and any context needed for routing decisions.

POST /symphony/execute/marketplace/payment_flow
{
  "context": {
    "amount": 1000,
    "currency": "USD",
    "customerId": "cust_123",
    "paymentMethod": "card",
    "billingCountry": "US"
  }
}
2

Compliance & Risk Assessment

The first stage of the workflow executes compliance checks: KYC verification, sanctions screening, fraud detection. These run in parallel or sequence based on your configuration.

KYC Check

Verify customer identity

Sanctions

Screen against lists

Fraud Score

Assess transaction risk

3

Intelligent Routing Decision

Corridorly's routing engine evaluates all available payment providers simultaneously, scoring each option against multiple factors in real-time: compliance results, historical conversion rates, processing costs, geographic optimisation, currency support, risk tolerance, and provider performance metrics. The system selects the optimal provider that maximises your configured objectives.

Multi-factor optimisation considers:
Cost efficiency

Processing fees, FX rates, total cost

Conversion rates

Historical success by segment

Geographic performance

Regional availability & speed

Risk alignment

Compliance with risk tolerance

Provider health

Real-time uptime & performance

Custom priorities

Your business-specific rules

4

Payment Execution

Corridorly executes the payment with the selected provider, handling provider-specific formatting, authentication, and error handling automatically.

Payment Successful

Transaction processed via Stripe • Fee: $0.29 • Processing time: 245ms

5

Response & Webhooks

Corridorly returns a unified response with results from every stage, execution metadata, and routing decisions. Webhooks notify your application of events.

{
  "executionId": "exec_abc123",
  "status": "success",
  "stages": {
    "compliance": { "approved": true, "riskLevel": "low" },
    "routing": { "provider": "stripe", "reason": "currency_match" },
    "payment": { "transactionId": "txn_xyz", "status": "completed" }
  },
  "totalExecutionMs": 401
}

Key Concepts

Understanding these core concepts will help you get the most from Corridorly:

Symphonies

A Symphony is a pre-built, multi-stage workflow available in the Corridorly Marketplace. For example, a payment symphony might include: KYC check → fraud detection → routing decision → payment execution → notification. Subscribe to a symphony and configure it with your own rules, thresholds, and provider preferences.

Pre-builtConfigurableVersionable

Recipes

Each stage in a Symphony executes a Recipe—a pre-built template for specific business logic like "Route to best payment provider" or "Check sanctions list". Recipes contain the rules and integrations needed for that step, which you can configure to your needs.

Pre-builtConfigurable rules

Rules

Rules define the decision-making logic within Recipes. For example: "If currency is USD and amount is less than $1000, route to Stripe". Rules can be as simple or complex as needed, with support for conditions, priorities, and custom logic.

No-code editingReal-time updates

Marketplace

The Corridorly Marketplace provides battle-tested Symphonies and integrations built and maintained by Corridorly. Subscribe to marketplace symphonies, configure the routing rules and thresholds to match your requirements, and benefit from continuous updates without redeploying.

Ready to useAuto-updatesBattle-tested

Why Corridorly

Corridorly transforms how you manage payments and financial workflows:

Faster Time to Market

Add new payment providers, change routing logic, or deploy compliance checks without engineering work. Configure and deploy in minutes, not weeks.

Reduced Engineering Burden

Business logic lives in Corridorly, not your codebase. No more deployment cycles for routing changes. Your team focuses on product, not payment plumbing.

Optimised Conversion

Route to providers with the best success rates for specific customer segments. A/B test routing strategies without code changes.

Cost Efficiency

Route based on provider fees, currency conversion costs, and total cost of processing. Make data-driven decisions to minimise payment costs.

Complete Visibility

Track every decision, understand why routing happened the way it did, monitor provider performance, and gain insights from detailed execution analytics.

Built for Scale

From hundreds to millions of transactions. Corridorly scales automatically, maintaining exceptional performance as your business grows.


Ready to Get Started?

Explore the marketplace, review our technical documentation, or create an account to start building with Corridorly today.