# \#refunds-api

**URL:** https://developer.squareup.com/forums/tag/refunds-api/61.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)

---

## [Unlinked Refunds](https://developer.squareup.com/forums/t/unlinked-refunds/28408)

<div class="topic-metadata">

**Author:** [@HeadPinz](https://developer.squareup.com/forums/u/HeadPinz)\
**Replies:** 3\
**Last updated:** [November 6, 2026, 4:34am UTC](https://developer.squareup.com/forums/t/unlinked-refunds/28408 "2026-11-06T04:34:17Z")

</div>

We’re a US seller in production on Square-Version 2026-09-16. Every unlinked refund we create fails, even though the request matches the Unlinked Refunds guide: Please note that this was enabled on our Square account. P…

---

## [Refund transactions stuck in PENDING status in Sandbox since yesterday](https://developer.squareup.com/forums/t/refund-transactions-stuck-in-pending-status-in-sandbox-since-yesterday/27975)

<div class="topic-metadata">

**Author:** [@asouare](https://developer.squareup.com/forums/u/asouare)\
**Replies:** 1\
**Last updated:** [September 24, 2026, 6:54pm UTC](https://developer.squareup.com/forums/t/refund-transactions-stuck-in-pending-status-in-sandbox-since-yesterday/27975 "2026-09-24T18:54:48Z")

</div>

Hi everyone, Since yesterday, I’ve noticed that refunds created in my Square Sandbox environment stay stuck in PENDING status and never transition to COMPLETED (or FAILED), which was not the case before. Details: Env…

---

## [How do I get an API refund to keep the item category and the tax?](https://developer.squareup.com/forums/t/how-do-i-get-an-api-refund-to-keep-the-item-category-and-the-tax/27486)

<div class="topic-metadata">

**Author:** [@BKSVL](https://developer.squareup.com/forums/u/BKSVL)\
**Replies:** 1\
**Last updated:** [September 8, 2026, 5:14pm UTC](https://developer.squareup.com/forums/t/how-do-i-get-an-api-refund-to-keep-the-item-category-and-the-tax/27486 "2026-09-08T17:14:26Z")

</div>

I manage a bowling center and wrote a small internal app that rings our weekly league dues into Square. It creates an order against the league’s item variation with auto\_apply\_taxes, then takes a cash payment. Those sa…

---

## [How do I determine the processing (return) location for a cross-location refund via the API?](https://developer.squareup.com/forums/t/how-do-i-determine-the-processing-return-location-for-a-cross-location-refund-via-the-api/27369)

<div class="topic-metadata">

**Author:** [@CapeGlass](https://developer.squareup.com/forums/u/CapeGlass)\
**Replies:** 1\
**Last updated:** [September 2, 2026, 8:05pm UTC](https://developer.squareup.com/forums/t/how-do-i-determine-the-processing-return-location-for-a-cross-location-refund-via-the-api/27369 "2026-09-02T20:05:11Z")

</div>

How do I determine the processing (return) location for a cross-location refund via the API? I have a multi-location Square account and I sync refunds into an external inventory/accounting system. I am hitting a case I c…

---

## [Question about Refunds with Discounts](https://developer.squareup.com/forums/t/question-about-refunds-with-discounts/23799)

<div class="topic-metadata">

**Author:** [@murphyzhang](https://developer.squareup.com/forums/u/murphyzhang)\
**Replies:** 2\
**Last updated:** [August 28, 2025, 3:26pm UTC](https://developer.squareup.com/forums/t/question-about-refunds-with-discounts/23799 "2025-08-28T15:26:06Z")

</div>

Hi Square Team, I have a question regarding how Square handles refunds when an order includes a discount: When a refund is processed for an order that used a discount, does the discount get automatically revoked or a…

---

## [In sandbox, can't find issue refund option](https://developer.squareup.com/forums/t/in-sandbox-cant-find-issue-refund-option/22659)

<div class="topic-metadata">

**Author:** [@vigneshp2](https://developer.squareup.com/forums/u/vigneshp2)\
**Replies:** 2\
**Last updated:** [June 5, 2025, 4:17pm UTC](https://developer.squareup.com/forums/t/in-sandbox-cant-find-issue-refund-option/22659 "2025-06-05T16:17:49Z")

</div>

Hello, I can’t find the issue refund option in square invoice. Usually I find it on the top. But it seems to be missing. I have checked multiple transactions, new and old as well. Still the same. I need to test refund…

---

## [Square Afterpay/Clearpay Refund](https://developer.squareup.com/forums/t/square-afterpay-clearpay-refund/20239)

<div class="topic-metadata">

**Author:** [@the\_one\_dev](https://developer.squareup.com/forums/u/the_one_dev)\
**Replies:** 1\
**Last updated:** [February 11, 2025, 5:33pm UTC](https://developer.squareup.com/forums/t/square-afterpay-clearpay-refund/20239 "2025-02-11T17:33:59Z")

</div>

I have implemented Square Afterpay/Clearpay inside my ticketing portal. And related to the place order everything is working fine. But Now when I try to refund the order Specifically from placed from the Afterpay payment…

---

## [FELICA Refund fail](https://developer.squareup.com/forums/t/felica-refund-fail/20642)

<div class="topic-metadata">

**Author:** [@wald](https://developer.squareup.com/forums/u/wald)\
**Replies:** 2\
**Last updated:** [January 15, 2025, 6:55pm UTC](https://developer.squareup.com/forums/t/felica-refund-fail/20642 "2025-01-15T18:55:45Z")

</div>

Hi, I’m trying to process a refund for a payment made with FELICA, but it’s not working. I used the Refund API, and the response was as follows: { “errors”: \[ { “code”: “REFUND\_DECLINED”, “detail”: “Payment could …

---

## [List payments depending on refund status](https://developer.squareup.com/forums/t/list-payments-depending-on-refund-status/18486)

<div class="topic-metadata">

**Author:** [@osd3](https://developer.squareup.com/forums/u/osd3)\
**Replies:** 3\
**Last updated:** [August 29, 2024, 5:57pm UTC](https://developer.squareup.com/forums/t/list-payments-depending-on-refund-status/18486 "2024-08-29T17:57:31Z")

</div>

currently if I want to use the APIs to determine if a refund was applied to a payment, I’d have to call several functions from the payments and the refunds api and match up the data, which would result in me receiving er…

---

## [Payments API: Offline Timestamps + Cross-tender Refunds to Square Gift Cards (GA) 🚀](https://developer.squareup.com/forums/t/payments-api-offline-timestamps-cross-tender-refunds-to-square-gift-cards-ga/18395)

<div class="topic-metadata">

**Author:** [@wootmoot](https://developer.squareup.com/forums/u/wootmoot)\
**Replies:** 0\
**Last updated:** [August 21, 2024, 9:59pm UTC](https://developer.squareup.com/forums/t/payments-api-offline-timestamps-cross-tender-refunds-to-square-gift-cards-ga/18395 "2024-08-21T21:59:56Z")

</div>

We’ve acted on your feedback and are thrilled to launch offline timestamps and cross-tender refunds to Square Gift Cards for the Payments API in GA, both highly requested by our developer community. Payments API: Offlin…
