# Oracle Marketplace

Oracle Cloud Marketplace is the narrowest integration in this documentation, and knowing its boundaries up front will save you a planning cycle. Suger does not create Oracle listings — you publish them in the Oracle Cloud Marketplace Partner Portal and Suger imports them, hourly, as products you can transact against. Only **SaaS** listings sync; container images, machine images, stacks, and Helm charts are skipped. Buyers are identified by their tenancy OCID, and every offer carries a contract document as a PDF.

What Suger adds is the private offer motion: a single total contract value in USD over a fixed term, sent from the console and tracked through acceptance. Pricing is one-time by design — there are no installments, and usage metering is a separate, entitlement-level capability that bills on top of the contract value. Connecting is organization-wide and uses an OCI API signing key belonging to a dedicated, least-privilege IAM user in your tenancy.

## Connect and start transacting

1. **[Integration](/oracle-marketplace/integration/)** — create the least-privilege IAM user, grant it Marketplace Publisher permissions, and connect with an unencrypted API signing key.
2. **[List Product](/oracle-marketplace/list-product/)** — how the hourly sync imports your published SaaS listings as Suger products, how Oracle lifecycle states map to Suger product statuses, and how to force a sync after publishing.
3. **[Private Offers](/oracle-marketplace/private-offers/)** — send an offer to a buyer's tenancy: total contract value, a term within Oracle's 375-day maximum, and the EULA PDF Oracle requires.

## Meter usage and troubleshoot

- **[Usage Metering](/oracle-marketplace/usage-metering/)** — how Oracle metering behaves, and the one rule that differs from every other cloud: you report a monetary amount, not a quantity.
- **[FAQ](/oracle-marketplace/faq/)** — short answers to the questions that come up in practice, including why an offer can sit in Pending Create, what makes integration verification fail, and how to rotate the API signing key.

## Drive it from your own systems

- **[Create a Private Offer via API](/oracle-marketplace/create-private-offer-api/)** — the request shape for sending an Oracle offer programmatically, including the EULA fields and the additional-document option the console form does not expose.
- **[Report Usage via API](/oracle-marketplace/report-usage-api/)** — submit metered usage without the console, and the window and per-call record limits that apply.

## Scope and limits

:::info
**SaaS listings only.** Other Oracle Marketplace listing types are not synced and cannot be used in offers created through Suger.

**Private offers are one-time contract value in USD** — whole dollars, a term of 6 months, 1, 2, or 3 years, and no installment plans. Oracle requires a minimum of **10,000 USD** and a maximum total contract length of **375 days**, and rejects anything outside those at send time — so in practice only the 6-month and 1-year terms are usable.

**Usage metering is enabled** (as of August 2026). Suger submits each entitlement's pending usage to OCI hourly, and metered usage bills on top of the contract value.

**Passphrase-protected private keys are not supported.** Generate the API signing key without one.

This section has no revenue guide. The FAQ above is where to look for what Suger pulls from Oracle's disbursement reports and the roughly three-month window Oracle exposes.
:::