Merchants

Merchants provide the canonical identity and display name for offer discovery.

• GET /api/v1/omni/merchant returns merchants with at least one live offer for the issuer.
• GET /api/v1/omni/merchant/{merchantId} returns one issuer-scoped merchant by UUID, including a merchant needed for historical reconciliation.

{
  "id": "0df83025-5c37-4bb2-a258-f06bc34fd495",
  "name": "Example Coffee"
}

Use id, not name, as the durable key. Names can be corrected and are not guaranteed to be unique outside the authenticated issuer's catalog.

An ID lookup returns 404 when the merchant does not belong to the issuer's channel-partner network, even if that UUID exists elsewhere in Percents. This prevents cross-issuer catalog discovery.