> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omneo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Commerce Layer

> The Omneo Commerce Layer integration connects Commerce Layer to Omneo for profile sync, order-to-transaction recording, and incentive management in headless commerce implementations.

The Omneo Commerce Layer integration connects Commerce Layer to Omneo for profile sync, order sync, and incentive management in headless commerce implementations.

## What the integration covers

* Profile sync: Commerce Layer customer to Omneo profile
* Order sync: Commerce Layer order to Omneo transaction on placement or fulfillment
* Incentive balance display and redemption in Commerce Layer-powered storefronts

## Profile resolution

Commerce Layer customers are linked to Omneo profiles via the `commerce-layer` identity handle. On checkout, your middleware resolves the Omneo profile from the Commerce Layer customer ID.

## Order to transaction

Configure a Commerce Layer webhook on `orders.place` or `shipments.shipping`. The webhook handler creates the Omneo transaction from the order data.

## Storefront integration

Commerce Layer is typically used in headless architectures. Generate an [Omneo ID token](/dev-guides/frontend/omneo-id) server-side in your middleware or edge function, then pass it to the Omneo SDK for front-end profile data display.

<Note>
  Full integration architecture, Commerce Layer webhook configuration, and a reference implementation are available from your Omneo implementation team.
</Note>