Guides API reference Use cases Changelog

Product catalog

Build a product catalog to use across transfers and payment links.

Use the product API to create a product catalog for transfers and payment links. For each product, you can specify an image, title, description, and base price. You can also set additional option groups like size and color, each with their own images and additional price modifiers.

For example, a cafe has a product catalog that contains each of the drinks on their menu. Each drink product has an option group set up for alternative milk choices which adds a price modifier to the overall cost.

Create a product

To create a new product for the catalog, pass the accountID and specify a title and base price. Additionally, you can specify a description, an image, and option groups. The example below creates a lunch special with an option group that has price modifications for alternative milks.

You can upload and store images with Moov.

categoryID is supported in API v2026.07.00 and higher. isTaxable is supported in API v2026.10.00 and higher.

curl -X POST "https://api.moov.io/accounts/{accountID}/products" \
  -H "Authorization: Bearer {token}" \
  -H "x-moov-version: v2026.07.00" \
  --data '{
    "basePrice": {
      "currency": "USD",
      "valueDecimal": "14.95"
    },
    "title": "Monday lunch special 1",
    "categoryID": "ccadd123-4e06-47ab-207a-e8753cd4c02a",
    "description": "Sandwich, chips, latte",
    "images": [
      {
        "imageID": "bbdcb050-2e05-43cb-812a-e1296cd0c01a"
      }
    ],
    "optionGroups": [
      {
        "description": "Alternative milk options",
        "name": "Milk options",
        "minSelect": 0,
        "maxSelect": 1,
        "options": [
          {
            "description": "Fancy brand oat milk",
            "images": [
              {
                "imageID": "bccbd070-3e04-45cd-603b-b1496cb0c01b"
              }
            ],
            "name": "Oat milk",
            "priceModifier": {
              "currency": "USD",
              "valueDecimal": "1.00"
            }
          },
          {
            "description": "Fancy brand almond milk",
            "images": [
              {
                "imageID": "bbdcb060-3e07-88cb-802a-e3295cd0c01c"
              }
            ],
            "name": "Almond milk",
            "priceModifier": {
              "currency": "USD",
              "valueDecimal": "1.00"
            }
          }
        ]
      }
    ]
  }'

If you want to use a product you've created, you'll need to use the product API to retrieve product data and map it to lineItems when creating transfers and payment links. You can, however, create freeform line items when initiating a transfer or payment link.

Manage products

Once a product catalog has been created, you can retrieve, update, and disable products.

List products

You can list all active products, or retrieve a single active or disabled product.

This endpoint will only return active products.

curl -X GET "https://api.moov.io/accounts/{accountID}/products" \
  -H "Authorization: Bearer {token}" \
  -H "x-moov-version: v2026.07.00"

Update a product

Every part of a product and its options can be updated. Updating a product initiates a complete replacement of the product model, so while only the title and base price are required, any omitted fields will be removed from the model if not included in the update request.

curl -X PUT "https://api.moov.io/accounts/{accountID}/products/{productID}" \
  -H "Authorization: Bearer {token}" \
  -H "x-moov-version: v2026.07.00" \
  --data '{
    "basePrice": {
      "currency": "USD",
      "valueDecimal": "15.05"
    },
    "title": "Monday lunch special 1",
    "description": "Sandwich, chips, latte",
    "images": [
      {
        "imageID": "bbdcb050-2e05-43cb-812a-e1296cd0c01a"
      }
    ],
    "optionGroups": [
      {
        "description": "Alternative milk options",
        "name": "Milk options",
        "minSelect": 0,
        "maxSelect": 1,
        "options": [
          {
            "description": "Fancy brand soy milk",
            "images": [
              {
                "imageID": "bbdcb050-2e05-43cb-812a-e1296cd0c01a"
              }
            ],
            "name": "Oat milk",
            "priceModifier": {
              "currency": "USD",
              "valueDecimal": "1.05"
            }
          },
          {
            "description": "Fancy brand coffee milk",
            "images": [
              {
                "imageID": "bbdcb050-2e05-43cb-812a-e1296cd0c01b"
              }
            ],
            "name": "Almond milk",
            "priceModifier": {
              "currency": "USD",
              "valueDecimal": "1.05"
            }
          }
        ]
      }
    ]
  }'

Disable a product

A disabled product remains in the system for historical and reporting purposes. To disable a product, pass the accountID and productID.

curl -X DELETE "https://api.moov.io/accounts/{accountID}/products/{productID}" \
  -H "Authorization: Bearer {token}" \
  -H "x-moov-version: v2026.07.00"

Upload and store images

Use the images API to upload a PNG, JPG, or WebP image. You can supply alt-text through the metadata field. Duplicate images and images larger than 16MB will be rejected.

When you upload an image, you'll receive a imageID, which can be used to point to the image when you create or update a product.

curl -X POST "https://api.moov.io/accounts/{accountID}/images" \
  -H "Authorization: Bearer {token}" \
  -H "x-moov-version: v2026.07.00" \
  --data '{
    "image": "00010101011111000101010110",
    "metadata": {
      "altText": "Blue oat milk carton by Fancy Brand"
    }
  }'

View the images guide for more information.

In the Dashboard

Navigate to Products in the Dashboard to create a product catalog for transfers, invoices, and payment links. For each product, you can specify an image, title, description, base price, and category, as well as option groups like size and color, each with their own images and price modifiers.

Create a product in the Dashboard

Click the New product button and fill out the information in the product modal. A product title and base price are required. A description, image, category, and group are optional. Images can be in PNG, JPG, or WebP format. Duplicate images and images larger than 16MB will be rejected.

Add a product to the catalog in the Dashboard

Manage products in the Dashboard

Once you've created products, they'll appear on the main product catalog view. All elements of a product can be edited. Click on a product to view it, and click the ... menu button to edit or delete the product.

Product list in the Dashboard

When you view or edit a product, your image library is available. Any images you add while editing a product are also added to your image library.

Categories

Assign a category to a product to organize your catalog and make products easier to find. Categories come from a standard, read-only product taxonomy (for example, Food, Beverages & Tobacco > Beverages). Select a category from the list when creating or editing a product.

When you create a payment link or transfer in the Dashboard, you can either select an existing product or enter a custom amount. You can search for a specific product, or scroll through all your products.