# Constructing Referral URLs

Banxa provides you with a base referral URL for your partner account. You construct a transaction-ready URL by appending query parameters.

## URL structure


```
https://{partnerRef}.banxa.com?{parameters}
```

Your `{partnerRef}` is your partner subdomain, provided by Banxa during onboarding. For sandbox, use:


```
https://{partnerRef}.banxa-sandbox.com?{parameters}
```

## Example

A referral URL pre-populated with a wallet address, crypto asset, and fiat currency:


```
https://yourpartner.banxa.com?walletAddress=0xe3BDEFdAeFF070925eB7FfC49F9B30c647Cb751e&coinType=ETH&fiatType=AUD&blockchain=ETH
```

Parameters are standard URL query string format. All parameters are optional — any value not supplied will default to the customer's previous selection or the checkout defaults configured in your Partner Dashboard.

## Encoding

Always URL-encode parameter values, particularly wallet addresses and email addresses which may contain special characters.

## Choosing a checkout mode

Once you have your referral URL, choose how to present it:

- **Redirect** — open the URL in a new tab or the same window.
- **iFrame / WebView** — load the URL inside an embedded component in your app.


→ See [Checkout Experience](/products/hosted-checkout/docs/checkout-experience/redirect/redirect-overview) for implementation details.