{"templateId":"markdown","versions":[{"version":"1.0","label":"v1.0","link":"/omni-api/overview/offers/merchants","default":true,"active":true,"folderId":"6bec560c"}],"sharedDataIds":{"sidebar":"sidebar-omni-api/@1.0/overview/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Merchants","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"merchants","__idx":0},"children":["Merchants"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Merchants provide the canonical identity and display name for offer discovery."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"endpoints","__idx":1},"children":["Endpoints"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/omni/merchant"]}," returns merchants with at least one live offer for the issuer."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/omni/merchant/{merchantId}"]}," returns one issuer-scoped merchant by UUID, including a merchant needed for historical reconciliation."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"0df83025-5c37-4bb2-a258-f06bc34fd495\",\n  \"name\": \"Example Coffee\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},", not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},", as the durable key. Names can be corrected and are not guaranteed to be unique outside the authenticated issuer's catalog."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An ID lookup returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404"]}," when the merchant is not available to the authenticated issuer, even if that UUID exists elsewhere in Percents. This prevents cross-issuer catalog discovery."]}]},"headings":[{"value":"Merchants","id":"merchants","depth":1},{"value":"Endpoints","id":"endpoints","depth":2}],"frontmatter":{"seo":{"title":"Merchants"}},"lastModified":"2026-08-11T01:36:09.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/omni-api/overview/offers/merchants","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}