# \#invoices-api

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

---

## [Feature request: expose "Goods and services confirmation" in the Invoices API](https://developer.squareup.com/forums/t/feature-request-expose-goods-and-services-confirmation-in-the-invoices-api/28135)

<div class="topic-metadata">

**Author:** [@sfbaysuv](https://developer.squareup.com/forums/u/sfbaysuv)\
**Replies:** 2\
**Last updated:** [October 15, 2026, 8:25pm UTC](https://developer.squareup.com/forums/t/feature-request-expose-goods-and-services-confirmation-in-the-invoices-api/28135 "2026-10-15T20:25:20Z")

</div>

Hello Square team, I own SF Bay SUV LLC, a Bay Area black-car service. We create draft invoices automatically from our website booking form using the Orders and Invoices APIs. Before sending each one, I have to open it i…

---

## [CreateInvoice returns INVALID\_CARD for a card created seconds earlier with CreateCard](https://developer.squareup.com/forums/t/createinvoice-returns-invalid-card-for-a-card-created-seconds-earlier-with-createcard/28049)

<div class="topic-metadata">

**Author:** [@raycionic](https://developer.squareup.com/forums/u/raycionic)\
**Replies:** 1\
**Last updated:** [October 5, 2026, 1:48pm UTC](https://developer.squareup.com/forums/t/createinvoice-returns-invalid-card-for-a-card-created-seconds-earlier-with-createcard/28049 "2026-10-05T13:48:41Z")

</div>

We’re seeing intermittent INVALID\_CARD errors from CreateInvoice in production, and we’d like to understand what causes them and how to avoid them. Our flow (Web Payments SDK, then server-side calls) The browser calls…

---

## [Sandbox invoice remains PAID after the full payment refund is COMPLETED](https://developer.squareup.com/forums/t/sandbox-invoice-remains-paid-after-the-full-payment-refund-is-completed/27863)

<div class="topic-metadata">

**Author:** [@MBSM](https://developer.squareup.com/forums/u/MBSM)\
**Replies:** 1\
**Last updated:** [September 17, 2026, 5:23pm UTC](https://developer.squareup.com/forums/t/sandbox-invoice-remains-paid-after-the-full-payment-refund-is-completed/27863 "2026-09-17T17:23:59Z")

</div>

We reproduced an invoice/refund status disagreement in the Square Sandbox with two entirely synthetic test invoices. Create an order and invoice, then publish with SHARE\_MANUALLY. Pay the invoice on Square’s hosted san…

---

## [Square POS - Invoice Print in A5 Format](https://developer.squareup.com/forums/t/square-pos-invoice-print-in-a5-format/27292)

<div class="topic-metadata">

**Author:** [@Sreejith](https://developer.squareup.com/forums/u/Sreejith)\
**Replies:** 5\
**Last updated:** [August 26, 2026, 6:16pm UTC](https://developer.squareup.com/forums/t/square-pos-invoice-print-in-a5-format/27292 "2026-08-26T18:16:34Z")

</div>

Hi All I would like to know about the possibility of printing Invoice in A5 format.

---

## [Search UNPAID Invoices](https://developer.squareup.com/forums/t/search-unpaid-invoices/25357)

<div class="topic-metadata">

**Author:** [@ff.clt](https://developer.squareup.com/forums/u/ff.clt)\
**Replies:** 8\
**Last updated:** [June 3, 2026, 5:43pm UTC](https://developer.squareup.com/forums/t/search-unpaid-invoices/25357 "2026-06-03T17:43:43Z")

</div>

Has anyone figured out the JSON format for filtering the v2/invoices/search to only return invoices that are in UNPAID invoice status? I keep getting a 400 cause I cannot get the sweet spot of the invoice status filter …

---

## [Can we get the invoice status(Viewed, Not Viewed) through Square Invoice API?](https://developer.squareup.com/forums/t/can-we-get-the-invoice-status-viewed-not-viewed-through-square-invoice-api/11750)

<div class="topic-metadata">

**Author:** [@Ketan\_Chavda](https://developer.squareup.com/forums/u/Ketan_Chavda)\
**Replies:** 3\
**Last updated:** [April 9, 2026, 8:21am UTC](https://developer.squareup.com/forums/t/can-we-get-the-invoice-status-viewed-not-viewed-through-square-invoice-api/11750 "2026-04-09T08:21:13Z")

</div>

Hi, We are creating invoice through Square Invoice API. Can we get the status of invoice like “Viewed, Not Viewed” by customer through Invoice API? We are getting the invoice status like “PAID, UNPAID, REFUNDED, CANCEL…

---

## [API Invoice missing "Allow Partial Payment", dashboard does](https://developer.squareup.com/forums/t/api-invoice-missing-allow-partial-payment-dashboard-does/25735)

<div class="topic-metadata">

**Author:** [@rpostwvu](https://developer.squareup.com/forums/u/rpostwvu)\
**Replies:** 0\
**Last updated:** [April 4, 2026, 11:17am UTC](https://developer.squareup.com/forums/t/api-invoice-missing-allow-partial-payment-dashboard-does/25735 "2026-04-04T11:17:35Z")

</div>

I cannot find an option in Square.Invoice to “Allow Partial Payments” to an invoice, but if I save the Invoice as a draft, and go into the dashboard I can toggle that permission. I don’t know if or how much the customer…

---

## [Create Invoice by Importing Excel doc](https://developer.squareup.com/forums/t/create-invoice-by-importing-excel-doc/25464)

<div class="topic-metadata">

**Author:** [@AshleyBarnard](https://developer.squareup.com/forums/u/AshleyBarnard)\
**Replies:** 1\
**Last updated:** [February 28, 2026, 2:15am UTC](https://developer.squareup.com/forums/t/create-invoice-by-importing-excel-doc/25464 "2026-02-28T02:15:11Z")

</div>

Hi, I need to map Excel to invoice fields to automate invoice creation. Right now, we spend hours manually creating invoices using information from EOBs. But I can export EOB claims information. I am hoping to create a…

---

## [Invoices API Download PDF of Invoice](https://developer.squareup.com/forums/t/invoices-api-download-pdf-of-invoice/22732)

<div class="topic-metadata">

**Author:** [@nbkhwjm](https://developer.squareup.com/forums/u/nbkhwjm)\
**Replies:** 5\
**Last updated:** [February 27, 2026, 1:01am UTC](https://developer.squareup.com/forums/t/invoices-api-download-pdf-of-invoice/22732 "2026-02-27T01:01:45Z")

</div>

This IS NOT IN REFERENCE TO THE SANDBOX!!! While using the production API I MUST be able to download the PDF of the API to send directly to the customer, or have the Invoice PDF with the initial email. The Square API l…

---

## [Subscription ID in invoices](https://developer.squareup.com/forums/t/subscription-id-in-invoices/13362)

<div class="topic-metadata">

**Author:** [@Mr.Qinu](https://developer.squareup.com/forums/u/Mr.Qinu)\
**Replies:** 12\
**Last updated:** [February 12, 2026, 5:25am UTC](https://developer.squareup.com/forums/t/subscription-id-in-invoices/13362 "2026-02-12T05:25:30Z")

</div>

Hi there, As far as I can tell, Subscriptions API appears to be built on top of Invoices API, so I am tagging both in hopes it is specific enough. Our subscription service requires the subscription to be paused immedia…

---

## [Integrating Square with Microsoft D365 Business Central](https://developer.squareup.com/forums/t/integrating-square-with-microsoft-d365-business-central/22996)

<div class="topic-metadata">

**Author:** [@AshJones](https://developer.squareup.com/forums/u/AshJones)\
**Replies:** 4\
**Last updated:** [October 22, 2025, 9:58am UTC](https://developer.squareup.com/forums/t/integrating-square-with-microsoft-d365-business-central/22996 "2025-10-22T09:58:58Z")

</div>

Hello, I hope you can help me please. I have a client using Xero as the accounts/finance back-end for their Square EPOS systems in their bars and restaurants. The client is considering introducing D365 Business Centra…

---

## [What are the differences between subscriptions and recurring invoices?](https://developer.squareup.com/forums/t/what-are-the-differences-between-subscriptions-and-recurring-invoices/10210)

<div class="topic-metadata">

**Author:** [@axme](https://developer.squareup.com/forums/u/axme)\
**Replies:** 7\
**Last updated:** [October 14, 2025, 4:15pm UTC](https://developer.squareup.com/forums/t/what-are-the-differences-between-subscriptions-and-recurring-invoices/10210 "2025-10-14T16:15:02Z")

</div>

Hi, I have a customer who instead of using the subscriptions feature is using the recurring invoices feature on their POS\> If it’s a recurring invoice, is the cancel invoice the equivalent endpoint to listen to for a s…

---

## [POS payment vs Invoice Payment](https://developer.squareup.com/forums/t/pos-payment-vs-invoice-payment/23856)

<div class="topic-metadata">

**Author:** [@santbob](https://developer.squareup.com/forums/u/santbob)\
**Replies:** 3\
**Last updated:** [September 4, 2025, 5:58pm UTC](https://developer.squareup.com/forums/t/pos-payment-vs-invoice-payment/23856 "2025-09-04T17:58:14Z")

</div>

I am looking for a way to differentiate between a payment made for an invoice sent to the customer and the payment made live through the payment terminals at POS. Is there any field in the payment response that can be r…

---

## [Receiving invoice email after remove test app](https://developer.squareup.com/forums/t/receiving-invoice-email-after-remove-test-app/23607)

<div class="topic-metadata">

**Author:** [@jgarcrol](https://developer.squareup.com/forums/u/jgarcrol)\
**Replies:** 2\
**Last updated:** [August 11, 2025, 4:28pm UTC](https://developer.squareup.com/forums/t/receiving-invoice-email-after-remove-test-app/23607 "2025-08-11T16:28:22Z")

</div>

Hi people, I have a small issue regarding subscription emails. I created an app in the sandbox environment and used it to test subscription flows in my development environment. I made several test subscriptions, and onc…

---

## [\`invoice.updated\` webhook is not sent on Invoice FAILED status](https://developer.squareup.com/forums/t/invoice-updated-webhook-is-not-sent-on-invoice-failed-status/23077)

<div class="topic-metadata">

**Author:** [@nshiv](https://developer.squareup.com/forums/u/nshiv)\
**Replies:** 2\
**Last updated:** [July 4, 2025, 9:51am UTC](https://developer.squareup.com/forums/t/invoice-updated-webhook-is-not-sent-on-invoice-failed-status/23077 "2025-07-04T09:51:44Z")

</div>

After repeated failed payment attempts towards an Invoice, Invoice transitions to FAILED status - however no webhook event is emitted to notify this change. Ideally we expect an invoice.updated event with the latest stat…

---

## [Invoices API: 90-Day Expiration for Payment Links](https://developer.squareup.com/forums/t/invoices-api-90-day-expiration-for-payment-links/22629)

<div class="topic-metadata">

**Author:** [@Jordan-Square](https://developer.squareup.com/forums/u/Jordan-Square)\
**Replies:** 0\
**Last updated:** [June 3, 2025, 3:46pm UTC](https://developer.squareup.com/forums/t/invoices-api-90-day-expiration-for-payment-links/22629 "2025-06-03T15:46:51Z")

</div>

Invoices API: 90-Day Expiration for Payment Links Hey everyone, We’ve updated the Invoices API to set a 90-day expiration date on invoice payment links, which will now expire 90 days after being generated. Buyers can re…

---

## [Invoice.payment\_made webhook has tmp public\_url](https://developer.squareup.com/forums/t/invoice-payment-made-webhook-has-tmp-public-url/22450)

<div class="topic-metadata">

**Author:** [@raycionic](https://developer.squareup.com/forums/u/raycionic)\
**Replies:** 11\
**Last updated:** [May 27, 2025, 5:55pm UTC](https://developer.squareup.com/forums/t/invoice-payment-made-webhook-has-tmp-public-url/22450 "2025-05-27T17:55:53Z")

</div>

On our invoice webhook, we compare the public\_url to confirm the payment. This morning we recieve a payload that had a tmp URL in it: { ... "type": "invoice.payment\_made", "event\_id": "0f2893d5-a18c-5960-a198-03eb1b…

---

## [Inconsistent handling of updated\_at across modifiable entities and their API List/Search endpoints](https://developer.squareup.com/forums/t/inconsistent-handling-of-updated-at-across-modifiable-entities-and-their-api-list-search-endpoints/22394)

<div class="topic-metadata">

**Author:** [@jhardin\_accumula](https://developer.squareup.com/forums/u/jhardin_accumula)\
**Replies:** 1\
**Last updated:** [May 20, 2025, 5:06pm UTC](https://developer.squareup.com/forums/t/inconsistent-handling-of-updated-at-across-modifiable-entities-and-their-api-list-search-endpoints/22394 "2025-05-20T17:06:05Z")

</div>

Folks: We’re starting development of a data integration with Square, and my review of your various APIs reveals a (to me) pretty glaring omission: there is no consistent way to request data that has been modified since …

---

## [New API for invoice attachments error : Received multiple request parts. Please only supply zero or one \`parts\` of type application/json](https://developer.squareup.com/forums/t/new-api-for-invoice-attachments-error-received-multiple-request-parts-please-only-supply-zero-or-one-parts-of-type-application-json/22126)

<div class="topic-metadata">

**Author:** [@chrisstanley](https://developer.squareup.com/forums/u/chrisstanley)\
**Replies:** 15\
**Last updated:** [May 5, 2025, 5:55pm UTC](https://developer.squareup.com/forums/t/new-api-for-invoice-attachments-error-received-multiple-request-parts-please-only-supply-zero-or-one-parts-of-type-application-json/22126 "2025-05-05T17:55:48Z")

</div>

I keep getting the following error: \*\*\* square.core.api\_error.ApiError: status\_code: 400, body: {'errors': \[{'category': 'INVALID\_REQUEST\_ERROR', 'code': 'INVALID\_CONTENT\_TYPE', 'detail': 'Received multiple request part…

---

## [Mark Invoice as Paid](https://developer.squareup.com/forums/t/mark-invoice-as-paid/6336)

<div class="topic-metadata">

**Author:** [@fusiled](https://developer.squareup.com/forums/u/fusiled)\
**Replies:** 6\
**Last updated:** [May 5, 2025, 4:38pm UTC](https://developer.squareup.com/forums/t/mark-invoice-as-paid/6336 "2025-05-05T16:38:25Z")

</div>

Using the Square dashboard, it is possible to mark an invoice as paid Clicking Add Payment Setting the Method to Record Payment Setting the Payment type to Other How can I do this through the Invoice API? See the …

---

## [Retrieve transfers](https://developer.squareup.com/forums/t/retrieve-transfers/22061)

<div class="topic-metadata">

**Author:** [@wjps](https://developer.squareup.com/forums/u/wjps)\
**Replies:** 3\
**Last updated:** [April 24, 2025, 7:12pm UTC](https://developer.squareup.com/forums/t/retrieve-transfers/22061 "2025-04-24T19:12:08Z")

</div>

Hi, Is there any way to retrieve a list of transfers to the owner bank account via the api? Basically the equivalent of https://app.squareup.com/dashboard/square-card/activity/transfers via the API? Thanks Will

---

## [Two phase invoice missing for first phase?](https://developer.squareup.com/forums/t/two-phase-invoice-missing-for-first-phase/22021)

<div class="topic-metadata">

**Author:** [@bTrustedComm](https://developer.squareup.com/forums/u/bTrustedComm)\
**Replies:** 3\
**Last updated:** [April 21, 2025, 6:56am UTC](https://developer.squareup.com/forums/t/two-phase-invoice-missing-for-first-phase/22021 "2025-04-21T06:56:22Z")

</div>

This is my subscription ID on sandbox c4ce63a5-a7bd-46a8-997b-d9455fb5268a I managed to get an invoice when it was just one phase. But when its discounted on the first phase only. There is no invoice generated. Even …

---

## [Automatically Charge ACH Bank on File Functionality](https://developer.squareup.com/forums/t/automatically-charge-ach-bank-on-file-functionality/3405)

<div class="topic-metadata">

**Author:** [@scobar](https://developer.squareup.com/forums/u/scobar)\
**Replies:** 6\
**Last updated:** [March 21, 2025, 7:12pm UTC](https://developer.squareup.com/forums/t/automatically-charge-ach-bank-on-file-functionality/3405 "2025-03-21T19:12:00Z")

</div>

Our system needs to create an Order via the Square Orders API. Then, create and publish an Invoice for that order ID via the Square Invoices API in order to accept ACH payments. It needs to utilize BANK\_ON\_FILE as the au…

---

## [Pay upon receipt](https://developer.squareup.com/forums/t/pay-upon-receipt/21081)

<div class="topic-metadata">

**Author:** [@terryj72](https://developer.squareup.com/forums/u/terryj72)\
**Replies:** 4\
**Last updated:** [March 3, 2025, 5:26pm UTC](https://developer.squareup.com/forums/t/pay-upon-receipt/21081 "2025-03-03T17:26:46Z")

</div>

Using the square API, I am able to create my invoices, publish my invoices but I seem to be having a problem getting my dates to work out the way that I want them to. I am usually processing my invoices the day before t…

---

## [VERSION\_MISMATCH when trying to cancel invoice](https://developer.squareup.com/forums/t/version-mismatch-when-trying-to-cancel-invoice/20442)

<div class="topic-metadata">

**Author:** [@freshsourcefarms](https://developer.squareup.com/forums/u/freshsourcefarms)\
**Replies:** 4\
**Last updated:** [January 2, 2025, 9:25pm UTC](https://developer.squareup.com/forums/t/version-mismatch-when-trying-to-cancel-invoice/20442 "2025-01-02T21:25:33Z")

</div>

I’m trying to use the API example from this URL: I’ve successfully deployed MANY API calls to Square, but for some strange reason, this one requires “version: 0” to be sent, unlike almost every other call I’ve used. I…

---

## [Unpaid Subscription Invoices \[Questions about "swap-plan" and MERGE"\]](https://developer.squareup.com/forums/t/unpaid-subscription-invoices-questions-about-swap-plan-and-merge/20402)

<div class="topic-metadata">

**Author:** [@NemoNoman](https://developer.squareup.com/forums/u/NemoNoman)\
**Replies:** 0\
**Last updated:** [December 31, 2024, 6:20pm UTC](https://developer.squareup.com/forums/t/unpaid-subscription-invoices-questions-about-swap-plan-and-merge/20402 "2024-12-31T18:20:57Z")

</div>

When my system creates a new yoga class subscription, I create a new Square Customer and Save the ID, add a customer card and save the ccof ID, and use these to create the subscription. If a person later updates info (c…

---

## [How to filter Invoice endpoint by "updated\_at" field](https://developer.squareup.com/forums/t/how-to-filter-invoice-endpoint-by-updated-at-field/20180)

<div class="topic-metadata">

**Author:** [@myOZexpRPA](https://developer.squareup.com/forums/u/myOZexpRPA)\
**Replies:** 4\
**Last updated:** [December 19, 2024, 11:52pm UTC](https://developer.squareup.com/forums/t/how-to-filter-invoice-endpoint-by-updated-at-field/20180 "2024-12-19T23:52:22Z")

</div>

Is there any possibility to retrieve all the Invoice data for one location from a single api call? or Can we filter the Invoice data by specific fields? (ex: created\_at, updated\_at)

---

## [Can we archive the invoice by invoices-api?](https://developer.squareup.com/forums/t/can-we-archive-the-invoice-by-invoices-api/19404)

<div class="topic-metadata">

**Author:** [@KOKO](https://developer.squareup.com/forums/u/KOKO)\
**Replies:** 3\
**Last updated:** [November 14, 2024, 9:56am UTC](https://developer.squareup.com/forums/t/can-we-archive-the-invoice-by-invoices-api/19404 "2024-11-14T09:56:03Z")

</div>

i need archive the invoice which has “PAID” status by invoices-api. can we archive the invoice by invoices-api?

---

## [We cannot filter invoice data by "status": "PAID"](https://developer.squareup.com/forums/t/we-cannot-filter-invoice-data-by-status-paid/19403)

<div class="topic-metadata">

**Author:** [@KOKO](https://developer.squareup.com/forums/u/KOKO)\
**Replies:** 2\
**Last updated:** [October 31, 2024, 4:40pm UTC](https://developer.squareup.com/forums/t/we-cannot-filter-invoice-data-by-status-paid/19403 "2024-10-31T16:40:31Z")

</div>

when we use invoices-api , are there any method to filter invoice data by “status”=“PAID”?

---

## [Duplicates payments when change month billing anchor in Subscriptions](https://developer.squareup.com/forums/t/duplicates-payments-when-change-month-billing-anchor-in-subscriptions/19298)

<div class="topic-metadata">

**Author:** [@jgarcrol](https://developer.squareup.com/forums/u/jgarcrol)\
**Replies:** 9\
**Last updated:** [October 30, 2024, 7:09pm UTC](https://developer.squareup.com/forums/t/duplicates-payments-when-change-month-billing-anchor-in-subscriptions/19298 "2024-10-30T19:09:35Z")

</div>

Hello Square, I’m working with the Subscriptions API, which is the core of my work. We need to update the monthly billing anchor (our subscriptions are monthly). We implemented the billing anchor update last month (Sep…

[Next page](https://developer.squareup.com/forums/tag/invoices-api/19.md?match_all_tags=true&page=1&tags%5B%5D=invoices-api)
