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-03eb1bc48c5d", "created_at": "2025-05-22T13:14:21Z", "data": { "type": "invoic…

:waving_hand: I’m Square Dev AI, here to help answer your question! Based on the information you’ve provided, the following documentation will help answer your question: Payments API Webhooks Learn about the Square webhook notifications supported by the Payments API. …

Yes, this is expected. The “public_url” field in the webhook payload is the URL of the Square-hosted invoice payment page. The URL can be a temporary URL (with “invtmp” in the path) or a permanent URL (with “inv” in the path). The temporary URL is generated when an invoice is first created and becom…

Exactly, I was expecting the URL to end with the same invoice id (and match the URL from the original invoice). Are these tmp URLs always possible?

This invoice was already published, and we sent the published URL to the customer. The customer paid there and the webhook sends me the tmp URL. That doesn’t seem correct.

This was a change that was made in our 2025-04-16 version . Invoice payment links are now temporary and expire after a certain period. Customers can provide the email address or phone number associated with the invoice and request a new link directly from the expired payment page, so no action is r…

Thank you for the helpful pointer to the release notes! One more question: is it possible to retrieve an Invoice object (or invoice_id) from a tmp URL?

It’s not possible to retrieve the invoice_id from a tmp URL. You’ll want to log the invoice_id when you get the webhook event. :slight_smile:

Yep, that’s what I’m changing it to now. Just thought I’d check for the ones I already have in my system

One more one more question: when will the sandbox start producing the tmp invoice URLs?

Invoice.payment_made webhook has tmp public_url

Questions

Bryan-Square May 22, 2025, 4:40pm 3

Are you referring to the tmp in the URL? Did this cause a problem?

Topic		Replies	Views
Public URL for invoice not available via API? Questions payments-api	6	84	October 14, 2025
URGENT BUG - invoice webhook payload and object doesn't include order_id anymore Questions invoices-api , webhooks-api	11	1816	June 21, 2023
New client: How to trigger invoice payment made Webhook Questions webhooks-api	2	665	March 28, 2023
Invoice.published webhook live subscription fires with test but not when the trigger is actually met Questions webhooks-api	2	561	May 21, 2023
`invoice.updated` webhook is not sent on Invoice FAILED status Feature Requests invoices-api , webhooks-api	2	81	July 4, 2025

Invoice.payment_made webhook has tmp public_url

Related topics