# \#loyalty-api **URL:** https://developer.squareup.com/forums/tag/loyalty-api/13.md [Latest](https://developer.squareup.com/forums/latest.md) · [Categories](https://developer.squareup.com/forums/categories.md) · [Tags](https://developer.squareup.com/forums/tags.md) --- ## [SearchLoyaltyRewards returns abnormal response for a single merchant](https://developer.squareup.com/forums/t/searchloyaltyrewards-returns-abnormal-response-for-a-single-merchant/27356)
**Author:** [@katsuda](https://developer.squareup.com/forums/u/katsuda)\ **Replies:** 3\ **Last updated:** [September 25, 2026, 3:52am UTC](https://developer.squareup.com/forums/t/searchloyaltyrewards-returns-abnormal-response-for-a-single-merchant/27356 "2026-09-25T03:52:34Z")
Summary When a customer redeems a loyalty reward at the POS, we needed to detect how much points the customer has used. We have been able to do so via the following steps. Receive an order.created webhook. Resolve the… --- ## [The Sandbox Dashboard is unresponsive](https://developer.squareup.com/forums/t/the-sandbox-dashboard-is-unresponsive/27309)
**Author:** [@shubhamadoshi](https://developer.squareup.com/forums/u/shubhamadoshi)\ **Replies:** 1\ **Last updated:** [August 24, 2026, 5:36pm UTC](https://developer.squareup.com/forums/t/the-sandbox-dashboard-is-unresponsive/27309 "2026-08-24T17:36:08Z")
the Sandbox Dashboard is unresponsive across multiple sections (Loyalty, sandbox test account details). Refer the screenshot below. It is stuck at this for forever. Did a hard refresh but didnt work. My App ID is sq0idp… --- ## [VIP API Availability](https://developer.squareup.com/forums/t/vip-api-availability/26840)
**Author:** [@dktnLegends](https://developer.squareup.com/forums/u/dktnLegends)\ **Replies:** 2\ **Last updated:** [July 15, 2026, 7:51am UTC](https://developer.squareup.com/forums/t/vip-api-availability/26840 "2026-07-15T07:51:19Z")
Having browsed the loyalty API I did not see mention of the new VIP tiers support in the API. Is it just undocumented or has this functionality not made it’s way to the API’s yet? --- ## [Square Loyalty not accumulating points for third-party integrated application orders — “Loyalty was disabled in POS during this transaction”](https://developer.squareup.com/forums/t/square-loyalty-not-accumulating-points-for-third-party-integrated-application-orders-loyalty-was-disabled-in-pos-during-this-transaction/26662)
**Author:** [@Charin](https://developer.squareup.com/forums/u/Charin)\ **Replies:** 1\ **Last updated:** [July 7, 2026, 3:33pm UTC](https://developer.squareup.com/forums/t/square-loyalty-not-accumulating-points-for-third-party-integrated-application-orders-loyalty-was-disabled-in-pos-during-this-transaction/26662 "2026-07-07T15:33:21Z")
We are seeking clarification regarding a Square Loyalty point accumulation issue encountered with one of our merchants. Merchant ID: BR1GQW7WBEVSP The issue is occurring only for orders placed through our third-party k… --- ## [Request for API Rate Limit Review / Increase](https://developer.squareup.com/forums/t/request-for-api-rate-limit-review-increase/26353)
**Author:** [@murphyzhang](https://developer.squareup.com/forums/u/murphyzhang)\ **Replies:** 4\ **Last updated:** [June 11, 2026, 7:08pm UTC](https://developer.squareup.com/forums/t/request-for-api-rate-limit-review-increase/26353 "2026-06-11T19:08:37Z")
Hello Square Team, We would like to discuss the API rate limits for our integration and seek your guidance on possible solutions. Our Business Scenario We support a merchant organization that currently operates more th… --- ## [Inquiry: "Loyalty was disabled in POS during this transaction" Appearing in Dashboard Orders](https://developer.squareup.com/forums/t/inquiry-loyalty-was-disabled-in-pos-during-this-transaction-appearing-in-dashboard-orders/26203)
**Author:** [@murphyzhang](https://developer.squareup.com/forums/u/murphyzhang)\ **Replies:** 1\ **Last updated:** [June 2, 2026, 7:10pm UTC](https://developer.squareup.com/forums/t/inquiry-loyalty-was-disabled-in-pos-during-this-transaction-appearing-in-dashboard-orders/26203 "2026-06-02T19:10:55Z")
Dear Square Support Team, We are reaching out for assistance regarding an issue we are observing in our Square Dashboard related to Loyalty behavior during certain transactions. Issue Description In the Square Dashboar… --- ## [NFC loyalty tap (Apple VAS / Google Smart Tap)](https://developer.squareup.com/forums/t/nfc-loyalty-tap-apple-vas-google-smart-tap/25512)
**Author:** [@ara](https://developer.squareup.com/forums/u/ara)\ **Replies:** 1\ **Last updated:** [March 23, 2026, 9:49am UTC](https://developer.squareup.com/forums/t/nfc-loyalty-tap-apple-vas-google-smart-tap/25512 "2026-03-23T09:49:58Z")
Do Square terminals/POS support loyalty identification via Apple VAS and/or Google Smart Tap? If yes, can the tap event / identifier be exposed to partners (API/webhook) for matching and attribution? Is “enroll/add a Wa… --- ## [Question Regarding Delay in Loyalty Program Discount Issuance](https://developer.squareup.com/forums/t/question-regarding-delay-in-loyalty-program-discount-issuance/24987)
**Author:** [@murphyzhang](https://developer.squareup.com/forums/u/murphyzhang)\ **Replies:** 4\ **Last updated:** [January 22, 2026, 2:48am UTC](https://developer.squareup.com/forums/t/question-regarding-delay-in-loyalty-program-discount-issuance/24987 "2026-01-22T02:48:46Z")
Hello Square Support Team, I have configured a rule in Square Loyalty with the following promotion: “Get 15% off when you join our loyalty program.” During testing, I noticed that after successfully registering as … --- ## [Clarification on Loyalty Sign-up Behavior with Same Email but Different Phone Numbers](https://developer.squareup.com/forums/t/clarification-on-loyalty-sign-up-behavior-with-same-email-but-different-phone-numbers/24327)
**Author:** [@murphyzhang](https://developer.squareup.com/forums/u/murphyzhang)\ **Replies:** 3\ **Last updated:** [October 31, 2025, 2:22am UTC](https://developer.squareup.com/forums/t/clarification-on-loyalty-sign-up-behavior-with-same-email-but-different-phone-numbers/24327 "2025-10-31T02:22:48Z")
Dear Square Support Team, I hope you’re doing well. We’ve recently encountered an issue when customers attempt to register for Square Loyalty using the same email but a different phone number — the new phone number doe… --- ## [Question About Changes to SMS Subscription When Registering for Loyalty](https://developer.squareup.com/forums/t/question-about-changes-to-sms-subscription-when-registering-for-loyalty/24192)
**Author:** [@murphyzhang](https://developer.squareup.com/forums/u/murphyzhang)\ **Replies:** 10\ **Last updated:** [October 16, 2025, 8:27pm UTC](https://developer.squareup.com/forums/t/question-about-changes-to-sms-subscription-when-registering-for-loyalty/24192 "2025-10-16T20:27:48Z")
Hi Square Team, I hope you’re doing well! I have a question regarding the SMS subscription behavior when registering for Square Loyalty. Has Square made any changes in October 2025 to the automatic SMS subscription … --- ## [Missing “CREATE\_REWARD” loyalty events in the webhook delivery](https://developer.squareup.com/forums/t/missing-create-reward-loyalty-events-in-the-webhook-delivery/23636)
**Author:** [@murphyzhang](https://developer.squareup.com/forums/u/murphyzhang)\ **Replies:** 11\ **Last updated:** [October 11, 2025, 2:10am UTC](https://developer.squareup.com/forums/t/missing-create-reward-loyalty-events-in-the-webhook-delivery/23636 "2025-10-11T02:10:40Z")
Hi Square Team, I’ve noticed a possible issue with missing “CREATE\_REWARD” loyalty events in the webhook delivery. Here’s what happened: Using the Loyalty Events API, I can see that my customer selected two REWARDs a… --- ## [Wrong Item Getting Reward Discount](https://developer.squareup.com/forums/t/wrong-item-getting-reward-discount/24120)
**Author:** [@nHiRanZ](https://developer.squareup.com/forums/u/nHiRanZ)\ **Replies:** 2\ **Last updated:** [October 1, 2025, 4:22pm UTC](https://developer.squareup.com/forums/t/wrong-item-getting-reward-discount/24120 "2025-10-01T16:22:20Z")
We have an integration with Square. We’re using Square Loyalty as well. In it, we have created a loyalty program where if the user uses 150 points, they can redeem a few item options. Item 1: 4.50 Item 2: 2.25 On our… --- ## [Reward Tier ID Changing on Editing](https://developer.squareup.com/forums/t/reward-tier-id-changing-on-editing/24101)
**Author:** [@nHiRanZ](https://developer.squareup.com/forums/u/nHiRanZ)\ **Replies:** 2\ **Last updated:** [September 29, 2025, 4:24pm UTC](https://developer.squareup.com/forums/t/reward-tier-id-changing-on-editing/24101 "2025-09-29T16:24:17Z")
We have created a Reward Program in Loyalty. State 1: { “program”: { “id”: “fd3f86f3-c753-45d9-afee-05aa67f8b5b6”, “status”: “ACTIVE”, “reward\_tiers”: \[ { “id”: “c5693b5c-0bd7-4aad-92db-3921bd32c74a”, “points”: … --- ## [Inquiry: Duplicate loyalty.account.updated Webhook with Same Event ID but Different Balance Points](https://developer.squareup.com/forums/t/inquiry-duplicate-loyalty-account-updated-webhook-with-same-event-id-but-different-balance-points/23847)
**Author:** [@murphyzhang](https://developer.squareup.com/forums/u/murphyzhang)\ **Replies:** 2\ **Last updated:** [September 3, 2025, 3:53pm UTC](https://developer.squareup.com/forums/t/inquiry-duplicate-loyalty-account-updated-webhook-with-same-event-id-but-different-balance-points/23847 "2025-09-03T15:53:41Z")
Dear Square Support Team, I encountered an unusual issue with the loyalty.account.updated webhook. On 2025-08-28, our system received two webhook deliveries for the same loyalty account within one second. Both had the s… --- ## [Unexpected Order of Loyalty Event Payloads in loyalty.account.updated Webhook](https://developer.squareup.com/forums/t/unexpected-order-of-loyalty-event-payloads-in-loyalty-account-updated-webhook/23794)
**Author:** [@murphyzhang](https://developer.squareup.com/forums/u/murphyzhang)\ **Replies:** 2\ **Last updated:** [August 27, 2025, 11:07pm UTC](https://developer.squareup.com/forums/t/unexpected-order-of-loyalty-event-payloads-in-loyalty-account-updated-webhook/23794 "2025-08-27T23:07:20Z")
Hi Square Team, I’ve observed an issue with the loyalty.account.updated webhook payloads that seems inconsistent with expectations. The customer’s current Loyalty point balance is 185. However, when inspecting the … --- ## [Upgrade from Square Java SDK v40.1.0 to v44.2.0 - Questions About Optional\ Structure](https://developer.squareup.com/forums/t/upgrade-from-square-java-sdk-v40-1-0-to-v44-2-0-questions-about-optional-t-structure/23136)
**Author:** [@murphyzhang](https://developer.squareup.com/forums/u/murphyzhang)\ **Replies:** 6\ **Last updated:** [August 26, 2025, 2:10am UTC](https://developer.squareup.com/forums/t/upgrade-from-square-java-sdk-v40-1-0-to-v44-2-0-questions-about-optional-t-structure/23136 "2025-08-26T02:10:02Z")
Hi Square Team, I am preparing to upgrade the Square Java SDK from version 40.1.0.20240604 to 44.2.0.20250521. However, I’ve noticed that all the get methods now return Optional\, requiring me to unwrap the Optional\ **Author:** [@June](https://developer.squareup.com/forums/u/June)\ **Replies:** 4\ **Last updated:** [July 30, 2025, 8:51am UTC](https://developer.squareup.com/forums/t/if-the-delete-reward-points-expire-will-they-be-returned-to-the-loyalty-account/23344 "2025-07-30T08:51:45Z") When the points are about to expire, you create a reward, and then delete the reward after a while. However, the points returned to the user have expired. Will these points still be returned to the user normally at this … --- ## [Question About Missing Order ID in Refund Loyalty Events](https://developer.squareup.com/forums/t/question-about-missing-order-id-in-refund-loyalty-events/22670)
**Author:** [@murphyzhang](https://developer.squareup.com/forums/u/murphyzhang)\ **Replies:** 11\ **Last updated:** [June 18, 2025, 2:13am UTC](https://developer.squareup.com/forums/t/question-about-missing-order-id-in-refund-loyalty-events/22670 "2025-06-18T02:13:44Z")
Hi Square Team, I noticed that Loyalty Events generated from Square Order refunds do not include the associated order\_id. Could you please clarify why the order\_id is not included in refund-related Loyalty Events? … --- ## [Loyalty Account Created via API Not Reflected in Customer Directory (Sandbox)](https://developer.squareup.com/forums/t/loyalty-account-created-via-api-not-reflected-in-customer-directory-sandbox/22707)
**Author:** [@murphyzhang](https://developer.squareup.com/forums/u/murphyzhang)\ **Replies:** 8\ **Last updated:** [June 13, 2025, 4:41pm UTC](https://developer.squareup.com/forums/t/loyalty-account-created-via-api-not-reflected-in-customer-directory-sandbox/22707 "2025-06-13T16:41:20Z")
Hi Square Team, In the sandbox environment, I used the Loyalty API to successfully create a loyalty account for a customer. However, in the Square Customer Directory (Dashboard), the customer’s profile still shows the “… --- ## [Intermittent API Timeout with Square Java SDK](https://developer.squareup.com/forums/t/intermittent-api-timeout-with-square-java-sdk/22713)
**Author:** [@murphyzhang](https://developer.squareup.com/forums/u/murphyzhang)\ **Replies:** 4\ **Last updated:** [June 12, 2025, 1:36pm UTC](https://developer.squareup.com/forums/t/intermittent-api-timeout-with-square-java-sdk/22713 "2025-06-12T13:36:20Z")
Hi Square Team, Our project is integrated with the Square Java SDK, and we’ve configured the request timeout to 20 seconds. During runtime, we occasionally encounter exceptions where a Square API call exceeds the 20… --- ## [Question About Deprecated definition Field in LoyaltyProgramRewardTier](https://developer.squareup.com/forums/t/question-about-deprecated-definition-field-in-loyaltyprogramrewardtier/22671)
**Author:** [@murphyzhang](https://developer.squareup.com/forums/u/murphyzhang)\ **Replies:** 2\ **Last updated:** [June 6, 2025, 4:11pm UTC](https://developer.squareup.com/forums/t/question-about-deprecated-definition-field-in-loyaltyprogramrewardtier/22671 "2025-06-06T16:11:35Z")
Hi Square Team, I noticed that the definition field in the LoyaltyProgramRewardTier object has been marked as deprecated in the API documentation. However, I’m still able to retrieve this field when querying the API. … --- ## [Customer Loyalty Points Accumulation – Orders & Payments API](https://developer.squareup.com/forums/t/customer-loyalty-points-accumulation-orders-payments-api/22434)
**Author:** [@Sithum2020](https://developer.squareup.com/forums/u/Sithum2020)\ **Replies:** 2\ **Last updated:** [May 22, 2025, 3:43pm UTC](https://developer.squareup.com/forums/t/customer-loyalty-points-accumulation-orders-payments-api/22434 "2025-05-22T15:43:33Z")
Hi, We’re currently using the Square Orders API and Payments API to manage orders and payments. At the time of placing an order through the Orders API, we attach the customer to the order. We’d like to clarify the foll… --- ## [Loyalty Account Search API Returns Empty Response Despite Customer Being Enrolled](https://developer.squareup.com/forums/t/loyalty-account-search-api-returns-empty-response-despite-customer-being-enrolled/22051)
**Author:** [@Sithum2020](https://developer.squareup.com/forums/u/Sithum2020)\ **Replies:** 14\ **Last updated:** [May 22, 2025, 3:44pm UTC](https://developer.squareup.com/forums/t/loyalty-account-search-api-returns-empty-response-despite-customer-being-enrolled/22051 "2025-05-22T15:44:40Z")
Hi team, We’re currently using the Square Loyalty API to search for a customer’s loyalty account using their phone number, but we’re encountering an issue where the API response is empty even though the customer is enro… --- ## [Customer check-in with QR code not adding loyalty points UK](https://developer.squareup.com/forums/t/customer-check-in-with-qr-code-not-adding-loyalty-points-uk/22318)
**Author:** [@GetBrikly](https://developer.squareup.com/forums/u/GetBrikly)\ **Replies:** 2\ **Last updated:** [May 14, 2025, 6:06pm UTC](https://developer.squareup.com/forums/t/customer-check-in-with-qr-code-not-adding-loyalty-points-uk/22318 "2025-05-14T18:06:04Z")
We’re creating QR codes containing a UUID for a customer’s reference ID for our users to allow their customers to check-in when in-store. If a customer is not enrolled in the loyalty program then we use the api to creat… --- ## [Search Loyalty Rewards API returns an empty response](https://developer.squareup.com/forums/t/search-loyalty-rewards-api-returns-an-empty-response/21718)
**Author:** [@katsuda](https://developer.squareup.com/forums/u/katsuda)\ **Replies:** 6\ **Last updated:** [April 15, 2025, 4:46pm UTC](https://developer.squareup.com/forums/t/search-loyalty-rewards-api-returns-an-empty-response/21718 "2025-04-15T16:46:29Z")
Search Loyalty Rewards API does not return anything, it returns an empty dict {}. I have a production square account with Loyalty Program enabled. I have created a loyalty account for a customer, and have multiple even… --- ## [What happens to loyalty data when a merchant cancels their loyalty plan?](https://developer.squareup.com/forums/t/what-happens-to-loyalty-data-when-a-merchant-cancels-their-loyalty-plan/20737)
**Author:** [@mmaccou](https://developer.squareup.com/forums/u/mmaccou)\ **Replies:** 2\ **Last updated:** [January 21, 2025, 8:46pm UTC](https://developer.squareup.com/forums/t/what-happens-to-loyalty-data-when-a-merchant-cancels-their-loyalty-plan/20737 "2025-01-21T20:46:29Z")
If a merchant cancels their loyalty plan, can the data still be queried? Or does it become unavailable. --- ## [Standing up basic app to read out store data](https://developer.squareup.com/forums/t/standing-up-basic-app-to-read-out-store-data/19858)
**Author:** [@lrrichie](https://developer.squareup.com/forums/u/lrrichie)\ **Replies:** 14\ **Last updated:** [December 17, 2024, 5:41pm UTC](https://developer.squareup.com/forums/t/standing-up-basic-app-to-read-out-store-data/19858 "2024-12-17T17:41:40Z")
I’m trying to build a Square app that, when installed by the Square user, reads out available store data to another platform. (This other platform will use the store data in combination with other data to make recommenda… --- ## [Configuring Loyalty Program for Multi Locations](https://developer.squareup.com/forums/t/configuring-loyalty-program-for-multi-locations/19496)
**Author:** [@bhanuka](https://developer.squareup.com/forums/u/bhanuka)\ **Replies:** 3\ **Last updated:** [November 8, 2024, 9:02pm UTC](https://developer.squareup.com/forums/t/configuring-loyalty-program-for-multi-locations/19496 "2024-11-08T21:02:52Z")
We are looking to set up a loyalty program that works across multiple locations, allowing customers to earn and redeem points at any location, regardless of where they first signed up. For example, if points are earned a… --- ## [Not enough permission to accumulate order loyalty points](https://developer.squareup.com/forums/t/not-enough-permission-to-accumulate-order-loyalty-points/18381)
**Author:** [@wsdzy2010](https://developer.squareup.com/forums/u/wsdzy2010)\ **Replies:** 10\ **Last updated:** [August 29, 2024, 5:59pm UTC](https://developer.squareup.com/forums/t/not-enough-permission-to-accumulate-order-loyalty-points/18381 "2024-08-29T17:59:16Z")
Hi, Our Square application is supposed to have the loyalty points permission and it works well for all other merchant clients. Only this merchant has the issue and we have tried several times to de-auth and re-auth it. … --- ## [Are there legal reasons not to create loyalty accounts via my application?](https://developer.squareup.com/forums/t/are-there-legal-reasons-not-to-create-loyalty-accounts-via-my-application/18489)
**Author:** [@robertgreenstreet](https://developer.squareup.com/forums/u/robertgreenstreet)\ **Replies:** 2\ **Last updated:** [August 29, 2024, 12:04am UTC](https://developer.squareup.com/forums/t/are-there-legal-reasons-not-to-create-loyalty-accounts-via-my-application/18489 "2024-08-29T00:04:47Z")
The Cat Cafe I’m working for is using a third-party booking system that “integrates” with Square, in that it sends over transaction and customer data–however it does not create loyalty accounts nor accumulate loyalty poi… [Next page](https://developer.squareup.com/forums/tag/loyalty-api/13.md?match_all_tags=true&page=1&tags%5B%5D=loyalty-api)