# OMNO API Documentation

OMNO is a payment orchestration platform that processes Pay-In and Pay-Out transactions across multiple PSPs through a single API.

OMNO provides a single production environment. Testing is done in production using fake PSPs configured by OMNO; see the [Testing in Production](https://docs.omno.com/guides/getting-started/testing-in-production) guide.

The final result of any transaction comes from webhooks or the GET transaction endpoints, never from redirects or client-side events.

Version: 2.2.0

## Servers

Production
```
https://api.omno.com
```

## Security

### bearerAuth

Type: oauth2
Token URL: https://sso.omno.com/realms/omno/protocol/openid-connect/token
Scopes:

## Download OpenAPI description

 - [OMNO API Documentation](https://docs.omno.com/_bundle/apis/payments/openapi.yaml)

## Customers

 - [POST /public/customer](https://docs.omno.com/apis/payments/openapi/customer/createorupdatecustomer.md): Creates or updates a customer for the authenticated merchant. Calling again with the same `externalUserId` updates the existing customer. `customerGroups` and `kyc.kycLevels` drive PSP eligibility — s
## Cashier Session

 - [POST /public/cashier/session](https://docs.omno.com/apis/payments/openapi/cashier-session/createcashiersession.md): Creates a cashier session for a customer and returns the `sessionId`, the hosted URLs, and a short-lived `token` used to open the session. Open the session on your frontend with the [Web SDK](https://
## PayIn

 - [POST /public/payin](https://docs.omno.com/apis/payments/openapi/payin/createpayin.md): Creates a pay-in transaction. Used by the Direct Link flow (via `directRouteId`) and the Payment Page (Legacy) flow (via `returnUrls` and the returned iframe URLs). See [Direct Link Pay-In: APM](https
 - [POST /public/payin/{payinId}/process/direct-link](https://docs.omno.com/apis/payments/openapi/payin/startdirectlinkpayinprocessing.md): Starts processing for a Direct Link pay-in created with a `directRouteId`. Provide the collected `browser` data and any method-specific `additionalData`. The response contains a `redirectUrl` the cust
## Payout

 - [POST /public/payout](https://docs.omno.com/apis/payments/openapi/payout/createpayout.md): Creates a payout transaction. Used by the Cashier flow (standard routing via `routerId` or default routing), the Direct Link flow (via `directRouteId`), and the Payment Page (Legacy) flow (load `ifram
 - [POST /public/payout/{payoutId}/process/direct-link](https://docs.omno.com/apis/payments/openapi/payout/startdirectlinkpayoutprocessing.md): Starts processing for a Direct Link payout created with a `directRouteId`. Provide the collected `browser` data and any method-specific `additionalData`. See [Direct Link Pay-Out](https://docs.omno.co
## Confirm / Reject Payout

 - [PUT /public/payout/{payoutId}/reject](https://docs.omno.com/apis/payments/openapi/confirm-reject-payout/rejectpayout.md): Rejects a payout that is in `WAITING_FOR_CONFIRMATION`. After rejection the transaction is **not** sent to a PSP and its status becomes `REJECTED`. Used when a payout requires manual approval, across
 - [PUT /public/payout/{payoutId}/confirm](https://docs.omno.com/apis/payments/openapi/confirm-reject-payout/confirmpayout.md): Confirms a payout that is in `WAITING_FOR_CONFIRMATION`. After confirmation the transaction starts processing and its status becomes `PENDING`. Used when a payout requires manual approval, across Cash
## Get Transaction Info

 - [GET /public/payout/{payoutId}](https://docs.omno.com/apis/payments/openapi/get-transaction-info/fetchpayouttransaction.md): Returns the payout transaction for the given ID. This is the authoritative status check for a payout, used alongside webhooks. Never rely on redirects or client-side events for the final status.
 - [GET /public/payin/{payinId}](https://docs.omno.com/apis/payments/openapi/get-transaction-info/fetchpayintransaction.md): Returns the pay-in transaction for the given ID. This is the authoritative status check for a pay-in, used alongside webhooks. Never rely on redirects or client-side events for the final status.
## PSP

 - [GET /public/psp/{merchantEnabledPspId}](https://docs.omno.com/apis/payments/openapi/psp/fetchmerchantenabledpsp.md): Returns the merchant-enabled PSP configuration for the given ID.