{"templateId":"markdown","versions":[{"version":"v1","label":"v1","link":"/api-reference/components/docs/categories","default":true,"active":true,"folderId":"1b9c9f54"},{"version":"v2","label":"v2 (Beta)","link":"/api-reference/v2/components/docs/categories","default":false,"active":false,"folderId":"1b9c9f54"}],"sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Flute Developer","siteUrl":"https://developer.flute.com","description":"Documentation and API reference for integrating Flute payment processing.","lang":"en-US"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"id":"categories-overview"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Categories organize the line items used on Flute invoices."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Categories are intended to be a convenient way to group and locate line items."," ","Line items are used to create invoices."," ","Each line item is product or service with predefined values such a name, unit type, and price."," ","To build an invoice, add the appropriate line items to itemize billing."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Categories can organize groups of line items."," ","The use of categories is optional."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A category may contain zero, one or more line items."," ","Line items may be assigned to a category."," ","However, line items are not required to be assigned to a category."," ","For more about line items, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#line-items-overview"},"children":["Line Items"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each category has:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A name, which must be unique within a merchant account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An optional default unit type, such as each, hour, or pound, that applies automatically to line items created under it."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A category may be deleted,"," ","This does not delete the line items assigned to it."," ","Those line items will remain but without a category."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each category returned by the API also reports an item count."," ","This gives a quick view of how many line items currently belong to it."," ","With that information, a merchant may decide to rename, reassign, or delete it."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Categories endpoints support listing, creating, updating, and removing categories."," ","The following endpoints are available:"]},{"$$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":"Endpoint"},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Explanation"},"children":["Explanation"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /pay-int-api/categories"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The list endpoint accepts a search string along with paging and sort parameters. A merchant catalog with many categories can be filtered to relevant results rather than paged through in full."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /pay-int-api/categories"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Creates a new category. The category name must be unique within the merchant account."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT /pay-int-api/categories/{categoryId}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Updates an existing category's name or default unit type. The name must remain unique within the merchant account."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE /pay-int-api/categories/{categoryId}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Deletes a category. Line items that referenced it stay in the catalog, now with an empty category."]}]}]}]}]}]},"headings":[],"frontmatter":{"seo":{"title":""}},"lastModified":"2026-09-02T16:16:36.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/api-reference/components/docs/categories","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}