Introducing Charges for Items & Modifiers - POS Integration

[Release on: 08th April, 2026]

This update enhances the order ingestion payload by introducing support for granular charge-level details at both item and modifier levels. This allows partners to better represent and process additional fees associated with individual items and modifiers.

Key Updates:

1. New Object: "charges"
   • A new optional object, "charges", is introduced within the order ingestion payload.
   • This object enables partners to define charges separately for each item and modifier, rather than aggregating them at the payment level.
2. Improved Charge Representation:
   • Previously, additional charges were included in the "payment" object as a summed total.
   • With this enhancement, each charge is now represented individually, providing better transparency and flexibility.
3. Charge Types Supported:
   • The "type" field supports the following enum values:
   SERVICE_FEE, DELIVERY_FEE, DELIVERY_TIPS, WAITER_TIPS, SURCHARGE, OTHER_FEES, PACKAGING_FEE, ENVIRONMENTAL_FEE
4. Charge Breakdown Details:
   Each charge can include:
   • "total": Total charge amount
   • "discountAmount": Discount applied to the charge (if any)
   • "taxAmount": Tax applied to the charge
   • "tax": Detailed tax breakdown including name and rate

Example Structure:

"charges": [
  {
    "type": "SERVICE_FEE",
    "total": {
      "amount": 5200,
      "currencyCode": "AED",
      "formattedAmount": "AED 52.00"
    },
    "discountAmount": {
      "amount": 5200,
      "currencyCode": "AED",
      "formattedAmount": "AED 52.00"
    },
    "taxAmount": {
      "amount": 5200,
      "currencyCode": "AED",
      "formattedAmount": "AED 52.00"
    },
    "tax": [
      {
        "amount": {
          "amount": 5200,
          "currencyCode": "AED",
          "formattedAmount": "AED 52.00"
        },
        "name": "VAT",
        "rate": "5%"
      }
    ]
  }
]

Notes:

• The "charges" object is optional and will not impact existing integrations by default.
• Partners may adopt this enhancement based on their implementation needs.

Release Information:

• Production Release Date: 08/04/2025