# Redirect
### đ¤ **Success & Failure & Return Redirect URLs**
These are **redirect URLs** (not webhooks) that return the **user** to your website after an invoice-related action is completed.
* â **Success redirect**:\
Triggered when an invoice is **successfully paid**. The user is redirected to the configured `successUrl`.
* â **Failure Redirect**:\
Triggered when the invoice is **canceled**, **rejected**, **expired**, or if an **error** occurs. The user is redirected to the configured `failureUrl`.
* âŠī¸ **Return Redirect**:\
Triggered when the invoice in a **waiting**, **pending confirm**, **unpaid**, or **underpaid** status. The user is redirected to the configured `returnUrl`.
### đ§ Configuration
To enable redirect functionality, the URLs must be defined in one of the following ways:
* **Merchant-level configuration**:\
Set the `successUrl` and `failureUrl` and `merchantSiteUrl` fields in your merchant profile in the Thedex merchant settings.
1. Sign in at [app.thedex.cloud](https://app.thedex.cloud).
2. After logging in, navigate to the **"Merchants"** section.
3. Click the **"Edit"** button on your merchant.
4. Fill in **Success redirect Url**, **Failure redirect Url** or **Merchant site**.
5. Complete form.
* **Per-request configuration**:\
If not set at the merchant level, you can specify `successUrl` and `failureUrl`, `returnUrl` directly in your **API request** when creating an invoice.
> If both options are used, the values passed in the API request will override the merchant defaults
### đ **Behavior**
* **Automatic redirect (If the invoice was created via API)**:\
The user is redirected automatically to either the success or failure URL as soon as the invoice status is updated or user click a button **"Return to website"** manually.
* **If the invoice was created via Thedex UI**:
The user must click a button (e.g., **"Return to website"**) to initiate the redirect.
> â ī¸ **Important:** These URLs are intended for **user redirection only**. They are **not** intended for server-to-server communication or for receiving payment status updates.\
> Use [webhooks ](https://docs.thedex.cloud/introduction/callback)for backend notification and processing.
