Invoice Return URL

Overview

Invoice return URL is the merchant-controlled web address to which a payer can be sent after leaving or completing a hosted invoice checkout. Its practical value comes from making the payment lifecycle deterministic for the payer, merchant, support team, and accounting system.

The payment page may use it for a back button, cancellation flow, or general return to the merchant site. The browser can carry an invoice or session reference, but the merchant must retrieve or receive authoritative payment status separately. In practice, the system should preserve the original request, the observed blockchain or checkout evidence, and every status change that affects this value. This makes support investigations and financial reconciliation possible without reconstructing the payment from screenshots or mutable client data.

The URL should use HTTPS, restrict allowed domains, avoid open-redirect behavior, and never place secrets in query parameters. The destination page should handle unpaid, pending, expired, and paid states safely. The implementation should use exact asset precision, authenticated server-side updates, and idempotent processing wherever repeated API calls, blockchain observations, or webhook deliveries can occur.

It differs from a success URL, which is specifically used after a successful checkout outcome, and from a callback URL, which is a server-to-server notification endpoint. It should be interpreted alongside Invoice Success URL, Invoice Callback URL, Invoice Payment Session. These concepts belong to the same workflow, but each answers a different operational question and should not be collapsed into one ambiguous field.

A payer who cancels a checkout can be returned to the order page, where the merchant displays the latest server-verified invoice status rather than trusting the redirect itself. The practical test is whether a merchant can explain how the value was produced, verify it independently, and apply the same rule consistently when the payment is delayed, duplicated, partially paid, refunded, or reviewed manually.