# Integration overview

The Omni CLO integration has two independent read workflows and one asynchronous write workflow.

## Merchant and offer discovery

Use the merchant and offer endpoints to synchronize the catalog available to your issuer. Every response is scoped by the issuer represented by the API token.

```text
Issuer server -> GET /api/v1/omni/merchant -> merchant catalog
Issuer server -> GET /api/v1/omni/offer    -> offer catalog
```

List endpoints return currently relevant catalog data. ID endpoints support reconciliation and historical lookup, including an offer that has ended.

## Transaction-file processing

```text
Issuer server -> GET /api/fileUpload -> presigned URL
Issuer server -> PUT presigned URL    -> object storage
Percents      -> download and validate schema
Percents      -> signed validation webhook -> issuer webhook receiver
Percents      -> ingest and process transactions asynchronously
```

Getting the presigned URL only creates an upload slot. Processing does not begin until bytes are uploaded and Percents detects the object. For `plaid-txn-stream`, Percents downloads and validates the complete JSON contract during regular periodic file processing, which runs no less frequently than hourly. Downstream transaction processing and audits do not produce a second public file-result webhook.

## Issuer scope

Merchant and offer reads are scoped to the authenticated issuer. Uploaded files use the content format enabled for that issuer.

## Environments

| Environment | Base URL | Purpose |
|  --- | --- | --- |
| Sandbox | `https://sandbox.percents.com` | Contract development and acceptance testing |
| Production | `https://prod.percents.com` | Live catalog and transaction processing |


Credentials, source-IP allowlists, upload enablement, and webhook destinations are configured separately per environment.

Sandbox does not perform live transaction processing. It is used to coordinate contract validation with Percents; see [Sandbox access](/omni-api/overview/sandbox-access) for the validation model.