Skip to main content

Return URL

The return URL is where the payment page sends the buyer after a successful payment. Set it per order with the returnURL field of orderCreate.

Supported formats:

  • a website URL, e.g. https://shop.com/order/INV-1001/success
  • an app deep link, e.g. shop://order/INV-1001/success

The URL is used exactly as you send it — Sevi does not add query parameters or substitute placeholders. Put your own order/invoice number in the URL so your page knows which order the buyer is returning for:

https://shop.com/sevi/return?invoice=INV-1001

If the payment fails or the buyer cancels, they stay on the Sevi payment page where they can retry; they are not redirected.

Do not trust the redirect alone​

The redirect happens in the buyer's browser and can be missed (closed tab, lost connection) or faked. Use it only to show the buyer a nice page. Mark the order as paid when your backend receives the ORDER webhook — or, if you need to check immediately, call orderSearch from your server and check paymentStatus = "PAID".