{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-vas/vas.sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Product lookup","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":"product-lookup"},"children":["Product lookup"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The product lookup phase is a transaction consisting of a call to obtain product information about the available products. This information is used to process voucher provision requests for that service provider."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This product lookup API call is used to retrieve product information from the master product list (electronic catalogue) that is maintained by the originating system via Electrum."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"operations-and-messages"},"children":["Operations and Messages"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This transaction consists of a single set of messages described by the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/other/lookupproducts"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lookupProducts"]}]}," operation, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /products"]},"."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Response payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/productslookupresponse"},"children":["ProductsLookupResponse"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Error payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/errordetail"},"children":["ErrorDetail"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"message-flows"},"children":["Message Flows"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The sections below describe successful product lookup transactions and error scenarios."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"successful-product-lookup"},"children":["Successful Product Lookup"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system sends a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," call to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/products"]}," API endpoint ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/other/lookupproducts"},"children":["lookupProducts"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The API responds with a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/productslookupresponse"},"children":["ProductsLookupResponse"]}," message payload."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system receives a list of available products."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/successful-voucher-lookup-phase.5f14f742dd9ab40dfbe29ed7aaf10658c721c3c8ee2fb9c3b0e177c6ec7c6168.f0281c88.png","alt":"alt text"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-at-originating-system"},"children":["Error at Originating System"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system sends a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," call to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/products"]}," API endpoint ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/other/lookupproducts"},"children":["lookupProducts"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The API responds with a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/productslookupresponse"},"children":["ProductsLookupResponse"]}," message payload."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An error occurs at the originating system."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The transaction is considered failed. No further action is required, however, the originating system should attempt the transaction again, or the previous day's product list can be used."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/error-at-sp-during-voucher-lookup-phase.dfe6d78055f9cfbdbb6c4d715791580f8916ad312ea85e2b74fafd0fae25521f.f0281c88.png","alt":"alt text"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-upstream"},"children":["Error Upstream"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system sends a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," call to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/products"]}," API endpoint ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/other/lookupproducts"},"children":["lookupProducts"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An error is encountered at Electrum or the Service Provider."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The API responds to the originating system with an ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/errordetail"},"children":["ErrorDetail"]}," message payload."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["No further action is required, however, the originating system should attempt the transaction again, or the previous day's product list can be used."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/error-upstream-during-product-lookup-phase.5b8f575be78cba251b83c99a70e3f5bdfb3363573dc09fdb869c8abb6fb249b6.f0281c88.png","alt":"alt text"},"children":[]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It is recommended that the originating system attempts the transaction again until a successful response is received."]}]}]},"headings":[{"value":"Product lookup","id":"product-lookup","depth":1},{"value":"Operations and Messages","id":"operations-and-messages","depth":2},{"value":"Message Flows","id":"message-flows","depth":2},{"value":"Successful Product Lookup","id":"successful-product-lookup","depth":2},{"value":"Error at Originating System","id":"error-at-originating-system","depth":2},{"value":"Error Upstream","id":"error-upstream","depth":2}],"frontmatter":{"seo":{"title":"Product lookup"}},"lastModified":"2026-01-28T10:41:29.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/vas/public/digital-vouchers/integrate-your-channel/product-lookup","userData":{"isAuthenticated":false,"teams":["anonymous"]}}