Request to Enable Combos API Alpha Feature

Questions
,
1

Dear Square Developer Support Team,

I am writing to request access to the Combos API Alpha feature for our application.

Application Details:

  • Location ID: L9QP48946MCAX
  • Current API Version: 2025-04-16

Use Case:
We are developing an integration for our point-of-sale system that requires the ability to create and process combo items (meal deals, bundled products). The Combos API would allow us to properly model these combo products with multiple selectable components and handle pricing accordingly.

Current Issue:
When making requests to the /v2/orders/calculate endpoint with combo items, the combo pricing logic does not appear to be applied. We suspect this may be due to the Combos Alpha feature not being enabled for our application.

Request Body

{
    "order": {
        "location_id": "L9QP48946MCAX",
        "line_items": [
            {
                "uid": "DF1F9BD6-DB4C-4A0B-89D1-5A730950D1F2",
                "catalog_version": 1773168296540,
                "quantity": "1",
                "variation_name": "",
                "item_type": "ITEM",
                "applied_combo_id": "1E05EFE1-8E25-4D17-B1E6-890A8EC1CDE9",
                "applied_combo_choice_id": "A5OBKZIN2SMYPDS3TNXDLR2M",
                "name": "Popcorn Chicken",
                "catalog_object_id": "G6EFDESRTFBREB6JAVA4VVFT"
            }
        ],
        "line_item_groups": [
            {
                "uid": "1E05EFE1-8E25-4D17-B1E6-890A8EC1CDE9",
                "catalog_version": 1773123029131,
                "base_price_money": {
                    "amount": 1,
                    "currency": "USD"
                },
                "combo_choices": [
                    {
                        "combo_choice_id": "A5OBKZIN2SMYPDS3TNXDLR2M",
                        "num_selections": 1,
                        "uid": "A5OBKZIN2SMYPDS3TNXDLR2M",
                        "name": "Popcorn Chicken",
                        "item_ids": [
                            "MQB3CUVM2WDMVFBSYPL72JPB"
                        ],
                        "item_variation_ids": [
                            "G6EFDESRTFBREB6JAVA4VVFT"
                        ]
                    }
                ],
                "note": "combo test",
                "catalog_item_id": "2L3IMVIKL56523TC5MNX6UBG",
                "catalog_variation_name": "Regular",
                "type": "COMBO",
                "catalog_name": "test1combo",
                "catalog_object_id": "HNCWDGISLZ2XQYSYDPYTERTK"
            }
        ]
    }
}

Request:
Could you please enable the Combos API Alpha feature for our application? If there are any additional steps required or qualifications needed, please let us know.

Thank you for your assistance.

Best regards,

Murphy