¶¶Òõ

Skip to main content

Previous Releases

2025-05-15 | 3.10 Gift and Loyalty

Refer to Change Ticket: CHANGE-12248 when speaking with a Team Member about this release.

Component

Current Version

New Version

Gift and Loyalty API

3.9.93-5

3.10.36

API Updates

Endpoint

Summary

addCustomer

Added terms_and_conditions_confirmed value to customer_details object in addCustomer request value. (XGL-1774)

addCustomer, reverseBalance updateCustomer

Enhanced loyalty service usability and performance by creating new endpoints addCustomer, updateCustomer, and reverseBalance. (XGL-1712, XGL-1714, XGL-1779)

redeemReward, submitOrder

Enhanced performance by updating POSOrderID date to include most recent local date and time. (XGL-1830)

New Features

XGL-1429

Gift and Loyalty API

Process, Backend, UI

Ensured that gift transactions are not double-processed in the following requests: activate, bulkActivate, value, payment. When is_retry flag is false, gift request is sent without changes. When is_retry flag is true, transaction is looked up 24-hour payment history to determine whether request is sent.

XGL-1610, XGL-1647, XGL-1648, XGL-1649, XGL-1650

Gift and Loyalty API

Process, Backend, UI

Added support for integration with third-party loyalty provider with the following enhancements:

  • Enable consumption of loyalty provider from Portal

  • Enable Ìý¾±»å±ð²Ô³Ù¾±´Ú²â°ä³Ü²õ³Ù´Ç³¾±ð°ù²õ request to loyalty provider

  • Enable submission of order to loyalty provider via SubmitOrder request

  • Enable request to redeem loyalty rewards to loyalty provider

  • Enable request for voiding order to loyalty provider

XGL-1746

Gift and Loyalty API

Backend

Enhanced terminal.order value in /redeem and /compute requests to consume body.order.order_number value.

XGL-1757

Gift and Loyalty API

Process, Backend, UI

Improved identifyCustomers response to third-party loyalty service with the following enhancements:

  • Add code value to response

  • Support body.code value for customer lookup

  • Adjust rewards.balance value to reflect rewards quantity rather than amount

XGL-1794

Gift and Loyalty API

Backend

receipt_details response processes successfully.

XGL-1822

Gift and Loyalty API

Backend, UI

Adjusted redemption code format (redemption_code) to 7-8 digit range.

XGL-1823

Gift and Loyalty API

Process, Backend, UI

Ensure that loyalty rewards are validated only when customer is identified by redemption code.

Improvements

XGL-1709, XGL-1717, XGL-1761, XGL-1782

Gift and Loyalty API

Backend

XGL-1749

Gift and Loyalty API

Process, Backend, UI

Accurate loyalty rewards are automatically added to order when multiple same discounts are pre-selected.

XGL-1751

Gift and Loyalty API

Backend, UI

/identifyCustomer loyalty customer request is configured with accurate mapping to Point Of Sale response.

XGL-1765

Gift and Loyalty API

Backend

/submitOrder request to provider with paid credit/debit payment includes MaskedCard value.

XGL-1766

Gift and Loyalty API

Backend, UI

/submitOrder requests are successful when failed /GeneratePromotion requests are also processed.

XGL-1783

Gift and Loyalty API

Backend

LineItemCode to loyalty provider is fetched successfully from loyalty_info node in /submitOrder request with item loyalty discount.

XGL-1784

Gift and Loyalty API

Process, Backend

/voidOrder request successfully voids both rewards and order.

XGL-1789

Gift and Loyalty API

Backend, UI

Fields display and function accurately in /redeem_balance custom loyalty request.

XGL-1790, XGL-1795

Gift and Loyalty API

Backend

/updateCustomerResponse and /reverseBalance request validations perform successfully.

XGL-1821

Gift and Loyalty API

Backend, UI

/submitOrder request for non-existing order number returns request successfully regardless of json format.

XGL-1833

Gift and Loyalty API

Process, Backend

Enhanced identifyCustomers request to ensure that accurate customer data is provided when user scans new loyalty customer.

XGL-1838

Gift and Loyalty API

Backend, UI

/identifyCustomer request processes successfully when body.loyalty_card_number is masked.

2025-03-27 | 3.9 ¶¶ÒõGift and Loyalty

Refer to Change Ticket: CHANGE-11922 when speaking with a ¶¶ÒõTeam Member about this release.

Component

Current Version

New Version

Gift and Loyalty API

3.9.93-4

3.9.93-5

Improvements

XGL-1752

Gift and Loyalty API

UI

Encrypted special characters translate and display accurately in third-party payment provider.

2025-03-17 | 3.9 ¶¶ÒõGift and Loyalty

Refer to Change Ticket: CHANGE-11847 when speaking with a ¶¶ÒõTeam Member about this release.

Component

Current Version

New Version

Gift and Loyalty API

3.9.93-3

3.9.93-4

New Features

XGL-1699

Gift and Loyalty

Process, Backend, UI

Improved loyalty provider reporting by exluding return and exchange items from order total and subtotal.

XGL-1721

Gift and Loyalty

Backend, UI

Improved loyalty request performance by consuming and providing store_number value in body of all loyalty requests (identifyCustomers, simulateAccrual, redeemReward, submitOrder, voidOrder)

XGL-1757

Gift and Loyalty

Backend

Enhanced third party loyalty provider processing by adding code value to identifyCustomers response to customer information.

Improvements

XGL-1734

Gift and Loyalty

Process, Backend

CREDITREFUND and TRANSACTIONDETAILS third-party requests return with negative values as expected for voided orders.

2025-03-10 | 3.9 ¶¶ÒõGift and Loyalty

Refer to Change Ticket: CHANGE-11782 when speaking with a ¶¶ÒõTeam Member about this release.

Component

Current Version

New Version

Gift and Loyalty API

3.9.93

3.9.93-3

New Features

XGL-1746

Gift and Loyalty

Backend

Enhanced loyalty service performance by enabling consumption of body.order.order_number from redeemReward and submitOrder requests as terminal.order value in /redeem and /compute requests, and body.terminal_txn_id if body.order.order_number is not present in request.

Improvements

XGL-1749

Gift and Loyalty

Backend, UI

Correct number of rewards are added to order when multiple discounts of same type are pre-selected.

2025-02-13 | 3.9 ¶¶ÒõGift and Loyalty

Refer to Change Ticket: CHANGE-11497 when speaking with a ¶¶ÒõTeam Member about this release.

Component

Current Version

New Version

Gift and Loyalty API

3.9.73

3.9.93

Improvements

XGL-1588, XGL-1591, XGL-1633, XGL-1644, XGL-1676

API

Backend

XGL-1658

API

Process, Backend, UI

Build succeeds without error message.

XGL-1662, XGL-1693, XGL-1694, XGL-1705

API

Backend

Retry sequences are successful and performed according to protocol.

XGL-1664

API

Backend

Enhanced accuracy and efficiency of Point of Sale entitlement error handling.

XGL-1711

API

Backend

Bearer token messaging in entitlement environment displays accurately.

2025-01-06 | 3.9 ¶¶ÒõGift and Loyalty

Refer to Change Ticket: CHANGE-11242 when speaking with a ¶¶ÒõTeam Member about this release.

Component

Current Version

New Version

Gift and Loyalty API

3.9.69

3.9.73

New Features

XGL-1640

Gift and Loyalty

Process, Backend, UI

Enhanced reporting capability by enabling consumption of multiItemDiscountId value when sending item-level loyalty discounts to third-party provider.

2024-12-09 | 3.9 ¶¶ÒõGift and Loyalty

Refer to Change Ticket: CHANGE-11195 when speaking with a ¶¶ÒõTeam Member about this release.

Component

Current Version

New Version

Gift and Loyalty API

3.9.56

3.9.69

New Features

XGL-1520, XGL-1579, XGL-1580

Gift and Loyalty

Process, Backend, UI

Added support for third-party loyalty discounts to be applied to bundled items with Rollup after tax price.

XGL-1521, XGL-1574

Gift and Loyalty

Process, Backend, UI

Added support for sending generic third-party transaction to loyalty service with the following actions:

  • Configured parsing rules to support loyalty check-in code after receiving identifyCustomers request from Point of Sale

  • Configured parsing rules to support multiple automatically applied loyalty rewards after receiving identifyCustomers request from Point of Sale

XGL-1552

Gift and Loyalty

Backend

Enhanced activateEntitlements and deactivateEntitlements requests by adding new fields terminal_number and terminal_name in body of Point of Sale request.

XGL-1635

Gift and Loyalty

Backend

Improved loyalty service performance by removing trackInfo and swipeFlag from gift requests.

Improvements

XGL-1605

Gift and Loyalty

Backend, UI

after_tax modifier in bundle remains child-item in third-party loyalty service as expected.

XGL-1606

Gift and Loyalty

Backend

Prices with negative amount are sent to third-party loyalty provider as 0.

XGL-1612

Gift and Loyalty

Backend

Validation messaging displays accurately for RedeemReward request to third-party loyalty service with MultiItemDiscounts.

XGL-1576

Gift and Loyalty

Backend

2024-10-31 | 3.9 ¶¶ÒõGift and Loyalty

Refer to Change Ticket(s): CHANGE-10928 when speaking with a ¶¶ÒõTeam Member about this release.

Component

Current Version

New Version

Gift and Loyalty API

3.9.46

3.9.56

New Features

XGL-1478

Gift and Loyalty

Process, Backend

Added support for consumption and caching of preferred_language property at site level, with consumed language sent in header as x-language value.

XGL-1497

Gift and Loyalty

Process, Backend, UI

Added support to add customer's point balance to identifyCustomers response from Point of Sale request.

XGL-1536, XGL-1537

Gift and Loyalty

Process, Backend, UI

Configured Transaction Details request to include the following:

  • Total Discounts

  • Applied Discount Codes

  • Past Discount Codes

  • Tax Value and Discounts in Total Item Price

Improvements

XGL-1538

Gift and Loyalty

Process, Backend, UI

When order is voided/reversed for amount less than gift card balance, amount returns successfully to gift card.

XGL-1598

Gift and Loyalty

Process, Backend, UI

Receipt prints automatically or when selected on prompt screen after loyalty discount is applied.

XGL-1435, XGL-1449, XGL-1547

Gift and Loyalty

Backend

2024-10-10 | 3.9 ¶¶ÒõGift and Loyalty

Refer to Change Ticket(s): CHANGE-10633 when speaking with a ¶¶ÒõTeam Member about this release.

Component

Current Version

New Version

Gift and Loyalty API

3.9.45

3.9.46

New Features

XGL-1532

XGL

Backend

Improved gift transaction experience by standardizing and improving format of PIN numbers for all gift transactions.

2024-09-16 | 3.9 ¶¶ÒõGift and Loyalty

Refer to Change Ticket(s): CHANGE-10487 when speaking with a ¶¶ÒõTeam Member about this release.

Component

Current Version

New Version

Gift and Loyalty API

3.9.29

3.9.45

API Updates

Endpoint

Summary

activateEntitlements

Added new endpoint to list of loyalty endpoints to activate entitlements. Request sent when loyalty provider is configured as custom provider. (XGL-1398)

deactivateEntitlements

Added new endpoint to list of loyalty endpoints to deactivate entitlements. Request sent when loyalty provider is configured as custom provider. (XGL-1399)

Improvements

XGL-9192

Gift and Loyalty

Backend

Included app security file in all repository roots.

XGL-1463

Gift and Loyalty

Backend

Updated Access Control List.

XGL-1505

Gift and Loyalty

Backend

Improved validation for activateEntitlements and deactivateEntitlements responses.

XGL-1443, XGL-1485, XGL-1467

Gift and Loyalty

Backend

2024-08-27 | 3.9 ¶¶ÒõGift and Loyalty

Refer to Change Ticket(s): CHANGE-10293 when speaking with a ¶¶ÒõTeam Member about this release.

Component

Current Version

New Version

Gift and Loyalty API

3.9.29

N/A

Improvements

CHANGE-10293

Gift and Loyalty

Backend

2024-05-16 | 3.9 ¶¶ÒõGift and Loyalty

Refer to Change Ticket(s): CHANGE-9826 when speaking with a ¶¶ÒõTeam Member about this release.

Component

Current Version

New Version

Gift and Loyalty API

3.9.27

3.9.29

New Features

Gift and Loyalty API

Process, Backend, UI

Gift card requests send successfully after configuring requests to use only gift card number from track1 data.

2024-04-25 | 3.9 ¶¶ÒõGift and Loyalty

Refer to Change Ticket(s): CHANGE-9700 when speaking with a ¶¶ÒõTeam Member about this release.

Component

Current Version

New Version

Gift and Loyalty API

3.9.23

3.9.27

New Features

Gift and Loyalty API

Process, Backend, UI

Added ability to void loyalty rewards through void request for each reward to be voided.

Gift and Loyalty API

Process, Backend, UI

Enhanced redeem/reward request functionality by making redeem/reward requests synchronous.

Improvements

Gift and Loyalty API

Backend, UI

Disable order/redemption void request log functionality if no void request is sent.

Gift and Loyalty API

Backend

2024-04-04 | 3.9 ¶¶ÒõGift and Loyalty

Refer to Change Ticket(s): CHANGE-9627 when speaking with a ¶¶ÒõTeam Member about this release.

Component

Current Version

New Version

Gift and Loyalty API

3.9.11

3.9.23

Improvements

Gift and Loyalty

Backend, UI

Improved recognition and processing of account numbers that include an alphabetic letter character.

2024-02-15 | 3.9 ¶¶ÒõGift and Loyalty

Refer to Change Ticket(s): CHANGE-9268 when speaking with a ¶¶ÒõTeam Member about this release.

Component

Current Version

New Version

Gift and Loyalty API

3.9.10

3.9.11

Improvements

Gift and Loyalty

Backend, UI

Improved loyalty rewards response by adjusting request value in redeemReward request.

2024-02-01 | 3.9 ¶¶ÒõGift and Loyalty

Refer to Change Ticket(s): CHANGE-9229 when speaking with a ¶¶ÒõTeam Member about this release.

Component

Current Version

New Version

Gift and Loyalty API

3.8.231

3.9.10

New Features

Gift and Loyalty

Process, Backend, UI

Improved customer transaction process by enabling consumption of Fortress Loyalty Provider data.

Gift and Loyalty

Process, Backend, UI

Added ability to post voidOrder request from Point of Sale in order to void Loyalty orders.

Gift and Loyalty

Backend, UI

Added functionality to register till in Fortress Loyalty Provider with first gift or loyalty transaction through RegisterUpdateTill request.

Improvements

Gift and Loyalty

Backend, UI

loyalty_id and receiptCode fields display and perform successfully in submitOrder request.

Gift and Loyalty

Backend, UI

MediaIdentifier field displays and performs successfully in TransactionDetails request.

Gift and Loyalty

Backend, UI

HSTS Security Headers display and perform successfully in external scan.

Gift and Loyalty

Backend, UI

DiscountAmount field utilizes cents.

Gift and Loyalty

Backend

Unified merchant data structure response.

2024-01-22 | 3.8 ¶¶ÒõGift and Loyalty

Refer to Change Ticket(s): CHANGE-9052 when speaking with a ¶¶ÒõTeam Member about this release.

Component

Current Version

New Version

Gift and Loyalty API

3.8.195

3.8.231

API Updates

Endpoint

Summary

submitOrder

Improved response to support full loyalty flow of orders.

identifyCustomers

Improved efficiency of response in identifying Loyalty customers. Set points_quantity value to 1 in customer.rewards.expiration when there is an expiration_date in response.

redeemReward

Added loyalty_customer_id to both redeemed_rewards and declined_rewards arrays.

submitOrder

Response sends successfully when receipt_details request fails.

voidOrder

Response sends successfully when receipt_details request fails.

simulateAccrual

Improved error messaging.

Punchh/api/pos/locations/configuration

Called every time a locationConfiguration request is received.

New Features

Gift and Loyalty API

Process, Backend, UI

Added support enabling the request of a list of all available rewards for customer.

Gift and Loyalty API

Process, Backend, UI

Increased efficiency by enabling users to specify selected rewards and loyalty coupons to Loyalty provider and have those selections identified in the response.

Gift and Loyalty API

Process, Backend, UI

Added support enabling users to identify Loyalty customers without presence of an order/order object.

Gift and Loyalty API

Process, Backend, UI

Added support enabling users to identify Loyalty redemption flow via Punchh based on locationConfiguration response.

Gift and Loyalty API

Process, Backend, UI

Added support enabling users to post a code presented by client to Loyalty provider via simulateAccrual in order to receive a response with applicable rewards.

Gift and Loyalty API

Process, Backend, UI

Added support enabling highlighting of rewards promoted by customers and currently applicable rewards in identifyCustomers transaction.

Gift and Loyalty API

Process, Backend, UI

Added support enabling exclusion of coupons from identifyCustomers response to customer.

Improvements

Gift and Loyalty API

Backend, UI

Enhanced loyalty flow by improving single-scan code format and locationConfiguration response.

Gift and Loyalty API

Backend, UI

Added support for sending surcharge fee as service item in menu_items object.

Gift and Loyalty API

Backend, UI

Customer not found error message displays successfuly when customer is not found.

Gift and Loyalty API

Backend, UI

Correct error message is returned when coupon is invalid.

Gift and Loyalty API

Backend, UI

Email is sent following submitOrder request is sent to checkin request only as expected.

Gift and Loyalty API

Backend

Order-level discounts are filtered successfully in submitOrder requests to Punchh endpoint.

Gift and Loyalty API

Backend

Adjusted rewarded_items amount value and mapping in validates_rewards and redeemed_rewards arrays.

Gift and Loyalty API

Backend

Adjusted and improved locationConfiguration response.

Gift and Loyalty API

Backend

Adjusted and improved identification_method values in identifyCustomers response.

Gift and Loyalty API

Backend

Removed offer_transaction_id from identifyCustomers and simulateAccrual responses.

Gift and Loyalty API

Backend

Enabled skipping of errors on attempt to retrieve Punchh basket via simulateAccrual.

Gift and Loyalty API

Backend

Expanded and improved sending of user agent value with each call to loyalty provider.

Gift and Loyalty API

Backend

rewards_data object contains empty validated_rewards array when there are no rewards.

Gift and Loyalty API

Backend

item_id value in rewarded_items is accurately mapped.

Gift and Loyalty API

UI

Body in api/pos/discounts/unselect displays properly.

Gift and Loyalty API

Backend, UI

Customers are identified successfully after requests with a body.customer_id and without the following:

  • order.customer.email

  • order.customer.phone_cell

  • customer.loyalty_info.customer.email

  • customer.loyalty_info.customer.phone

Gift and Loyalty API

Backend, UI

After submitOrder request, the following actions perform successfully:

  • Value display in order.customer.phone_cell and customer.loyalty_info.customer.phone

  • Order is submitted for checkin, receipt_details and api/pos/meta

  • Receipt-related message is returned

2023-11-20 | 3.8 ¶¶ÒõGift and Loyalty

Refer to Change Ticket(s): CHANGE-8776 when speaking with a ¶¶ÒõTeam Member about this release.

Component

Current Version

New Version

Gift and Loyalty API

3.8.174-3

3.8.195

New Features

Gift and Loyalty

Process, Backend, UI

Added functionality enabling users to get list of applicable rewards for customer orders.

Improvements

Gift and Loyalty

Backend

Enhanced performance and response of submit/void order adjustments.

Gift and Loyalty

Backend

Enhanced performance of identifyCustomers response.

Gift and Loyalty

Backend

Clarified ID type for rewards.id value for consistency.

2023-10-05 | 3.8 ¶¶ÒõGift and Loyalty

Refer to Change Ticket(s): CHANGE-8218, CHANGE-8381 when speaking with a ¶¶ÒõTeam Member about this release.

Component

Current Version

New Version

Gift and Loyalty API

3.8.169

3.8.174

Improvements

Gift and Loyalty API

Backend, UI

Loyalty integration for Gift requests works as expected after configuration to obtain mapping domain value from "merchant_id" field in gift provider subscription.

Gift and Loyalty API

Backend

Optimized loyalty controller by defining it with the separate file "src/routes/loyalty-controller.js"

2023-08-17 | 3.8 ¶¶ÒõGift and Loyalty

Refer to Change Ticket(s): CHANGE-8134 when speaking with a ¶¶ÒõTeam Member about this release.

Component

Current Version

New Version

Gift and Loyalty API

3.8.157

3.8.167

Improvements

Gift and Loyalty

Backend, UI

Enhanced loyalty integration by improving mapping of item-level discounts for Encounter Point of Sale application.

Gift and Loyalty

Backend

Fortress cache resets as anticipated.