Invoice Return URL
Pronunciation: IN-voys rih-TURN YOO-AR-EL
Definition
Invoice return URL is the merchant-controlled web address to which a payer can be sent after leaving or completing a hosted invoice checkout. A return URL describes where a user can navigate after leaving the invoice page; it does not prescribe a payment state. It may handle a back button, cancellation, an abandoned session, or navigation after another step.
Overview
Meaning and boundaries
Invoice return URL is the merchant-controlled web address to which a payer can be sent after leaving or completing a hosted invoice checkout. A return URL describes where a user can navigate after leaving the invoice page; it does not prescribe a payment state. It may handle a back button, cancellation, an abandoned session, or navigation after another step. The destination should recover the existing order with a safe opaque reference rather than create a replacement invoice automatically.
How it works in practice
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. 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. 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.
Checks and failure points
A payer can close the tab, switch devices, or return several times. The server must determine whether the invoice is unpaid, awaiting confirmation, expired, or complete. Do not infer cancellation or success from a return event.
How it differs from related terms
A general return URL differs from a success URL, which is intended for a successful checkout path; neither substitutes for an authenticated payment notification. Related entries: Invoice Success URL; Invoice Callback URL; Invoice Payment Session.
Example
A shopper presses 'Return to store' without sending funds. The store opens the same order as unpaid and offers an appropriate next action rather than recording a completed sale.
Comparison
A general return URL differs from a success URL, which is intended for a successful checkout path; neither substitutes for an authenticated payment notification.
Key Takeaway
Navigation back to a site is not a financial event.
Sources
- Welcome to Checkout APIs — Coinbase Developer Documentation (2026-08-02)
- Create Checkout — Coinbase Developer Documentation (2026-08-02)
- Payment Links — Stripe Documentation (2026-08-02)