# OMNO Transaction API

Welcome to the OMNO API documentation.

OMNO is a payment orchestration platform that enables merchants and partners to manage Pay-In and Pay-Out transactions across multiple payment providers through a single integration.

Instead of integrating with each Payment Service Provider (PSP) individually, OMNO centralizes payment execution, routing, and provider management, allowing you to scale faster and optimize performance without additional engineering overhead.

## What OMNO Does

OMNO acts as a unified payment layer between your system and external providers.

It is responsible for:

- Managing the full transaction lifecycle for Pay-In and Pay-Out operations
- Routing transactions to the most suitable providers based on configurable rules
- Handling provider communication and normalization
- Managing customer data and KYC requirements
- Delivering real-time transaction updates via webhooks
- Providing analytics and reporting across all providers


## Core Capabilities

### Multi-Provider Processing

Execute transactions across multiple PSPs using a single API without needing direct integrations.

### Smart Routing

Automatically select providers using routing logic based on:

- country
- payment method
- performance
- business rules


### Hosted Payment Experiences

OMNO provides multiple ways to handle payment flows without building everything from scratch:

- Cashier (fully customizable checkout)
- Payment Page (simplified hosted page for fixed flows)
- Direct Links (no UI flow execution)


### Real-Time Webhooks

Receive transaction updates and lifecycle events through webhooks.

### Customer and KYC Management

Control required fields and eligibility for payment methods based on business and compliance rules.

## Integration Options

OMNO supports multiple integration approaches depending on your use case:

### Cashier Integration

A fully customizable hosted checkout that supports:

- card payments
- APMs
- crypto payments
- dynamic routing and KYC flows


Recommended for:

- full payment experience control
- multi-method checkout
- advanced routing logic


### Payment Page Integration

A hosted payment page with a predefined structure and fixed amount.

Supports:

- card payments
- APMs


Recommended for:

- simple integrations
- predefined payment flows
- minimal configuration


### Direct Link Integration

Direct Link is a flow without a payment page or UI layer.

It allows you to directly trigger payment or payout operations using a generated link or request.

Supports:

- direct access to APM payment flows
- crypto wallet address generation (Pay-In)
- payout requests (Pay-Out)


Recommended for:

- invoice-based payments
- quick payment triggers
- backend-driven payment flows
- integrations without user-facing UI


## How It Works

A typical Pay-In flow:

1. Merchant sends a request to OMNO
2. OMNO validates the request and customer data
3. Routing logic selects the appropriate provider
4. Transaction is executed via PSP
5. Status updates are processed
6. Webhooks are sent to the merchant
7. Data is recorded for reporting and analytics


All complexity related to provider selection, retries, and normalization is handled by OMNO.

## API Specification

The OpenAPI specification is defined in:

`openapi_final_casefixed.yaml`

You can explore all available endpoints in the API reference section.

## Getting Started

To begin integration:

1. Generate API credentials in the dashboard
2. Choose your integration type (Cashier, Payment Page, or Direct Link)
3. Create your first transaction
4. Configure webhook endpoints
5. Validate flows in a test environment


## Support

For technical assistance or integration support, contact:

support@omno.com