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.

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}

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.

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

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 for implementation details.