{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/dynamicmonetization/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Information for Producers Using a Custom Back Office","description":"API documentation for Revenera products","siteUrl":"https://developer.revenera.com","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":"information-for-producers-using-a-custom-back-office","__idx":0},"children":["Information for Producers Using a Custom Back Office"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you do not use FlexNet Operations but have your own back office for managing your entitlements, then you will need to use the Dynamic Monetization APIs directly to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create Dynamic Monetization instances for your customer accounts"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create and modify line items in Dynamic Monetization"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You may want to write an integration layer that allows your back office to call these APIs directly."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The remainder of this section on using your own back office walks you through exercises for managing instances and line items:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#creating-a-dynamic-monetization-instance"},"children":["Creating a Dynamic Monetization Instance"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#creating-a-line-item"},"children":["Creating a Line Item"]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For information about authorization requirements for the Dynamic Monetization APIs, see the Dynamic Monetization Authorization Guide. You can download this document from the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://flexerasoftware.flexnetoperations.com/"},"children":["Product and License Center"]}," (login required)."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"creating-a-dynamic-monetization-instance","__idx":1},"children":["Creating a Dynamic Monetization Instance"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authorization"]},": administration token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint information"]},": ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/dynamicmonetization/apis/openapi-spec/instances/addinstance"},"children":["Create an instance"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This section describes the steps for using the POST ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["/instances"]}," API to create an instance for a customer account."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Important: If this is the first instance created for a specific account, it will be created as the default instance."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send a POST to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["/provisioning/api/<version>/instances"]},". Use the values as described in the following table:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Item"},"children":["Item"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["URI"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["/provisioning/api/<version>/instances"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Method"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Query parameters"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/A"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request body"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{ \n  \"shortName\": \"ACME-def-inst\",\n  \"accountId\": \"ACME\"\n} \n","lang":"json"},"children":[]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sample Response"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the request was successful, the response returns the instance information, similar to this:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"id\": \"d889a651-123a-456b-78d9-60d6de8cfes9\",\n    \"shortName\": \"ACME-def-inst\",\n    \"accountId\": \"ACME\",\n    \"defaultInstance\": true,\n    \"created\": 1,\n    \"modified\": 0\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"creating-a-line-item","__idx":2},"children":["Creating a Line Item"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authorization"]},": administration token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint information"]},": ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/dynamicmonetization/apis/openapi-spec/line-items/addactivation"},"children":["Map a line item to an instance"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this exercise, you create a line item which captures an entitlement to a number of metered tokens that a customer has purchased."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send a PUT request to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["/provisioning/api/<version>/instances/{instanceId}/line-items"]}," to map a line item to the instance you created in the previous step, ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/dynamicmonetization/tutorials/creating-a-dynamic-monetization-instance"},"children":["Creating a Dynamic Monetization Instance"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Item"},"children":["Item"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["URI"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["/provisioning/api/<version>/instances/{instanceId}/line-items"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Method"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PUT"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Path parameters"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instanceId"]},": Use the ID returned by the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["/provisioning/api/<version>/instances"]}," API"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request body"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{ \n  \"activationId\": \"ACT01-Elastic\",\n  \"state\": \"active\",\n  \"quantity\": 1000,\n  \"start\": 1695772800000,\n  \"end\": 1790380800000,\n  \"attributes\": {\n    \"elastic\": true,\n    \"rateTableSeries\": \"PublicationApps\",\n    \"overdraftLimit\": 0,\n    \"overdraftType\": \"Number\"\n  },\n  \"instanceId\": \"d889a651-123a-456b-78d9-60d6de8cfes9\"\n} \n","lang":"json"},"children":[]}]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sample Response"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the request was successful, the response returns code 201, indicating that the line item was successfully created."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"message\": \"Success\"\n{\n","lang":"json"},"children":[]}]},"headings":[{"value":"Information for Producers Using a Custom Back Office","id":"information-for-producers-using-a-custom-back-office","depth":1},{"value":"Creating a Dynamic Monetization Instance","id":"creating-a-dynamic-monetization-instance","depth":2},{"value":"Creating a Line Item","id":"creating-a-line-item","depth":2}],"frontmatter":{"seo":{"title":"Information for Producers Using a Custom Back Office"}},"lastModified":"2026-07-20T14:17:47.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/dynamicmonetization/tutorials/back-office-custom","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}