Skip to main content

Wallet Button

The Wallet Button is a button that is available only on mobile devices and allows a user to quickly open their partner wallet to complete a transaction.

It is used in two scenarios:

  1. Partner wallets that already have built-in support for the Wallet Button.
  2. C2C and C2F exchanges where the user can be redirected to a wallet to complete the transaction.

A partner can generate a link that automatically pre-fills the transaction details. The following parameters are passed in the link:

  • fromCurrency — currency ticker to be sent (deposit currency ticker)
  • fromNetwork — network of the deposit currency
  • amount — deposit amount
  • memo — extraId, if required (extraId of the deposit pay-in)

User Flow​

1. Exchange Initiation​

The user opens our checkout (exchange page) and selects: the currency, the amount, the payment method

2. Crypto Deposit Step (Standard Flow)​

When the user reaches the step where a manual crypto transfer is required, the typical flow is:

  • the user copies the wallet address,
  • opens their crypto wallet or app,
  • pastes the address and amount,
  • manually confirms the transaction.

This flow is inconvenient: it requires multiple manual actions and carries a risk of errors (e.g., copying the wrong address or amount).

3. New Option — “Send Instantly”​

A new button appears for the user, for example “Pay via Wallet”.

When the user taps it:

  • they are automatically redirected to their wallet or partner app,
  • all required data is pre-filled: currency, amount, and destination address.

The user only needs to confirm the transaction — no copying or manual input.

example example

4. Redirect Back​

After confirming the transfer, the partner (wallet or app) can configure a redirect back to our platform so the user returns to the exchange page.

There, the user sees the transaction status, for example:

  • “Deposit received”
  • “Transaction in progress”

Benefits​

  • Fewer steps for the user — no manual copying of address or amount.
  • Fewer errors — all data is passed automatically.
  • Higher conversion rate — users are more likely to complete the payment.
  • Convenient for partners — full control over the user flow and the ability to return the user to the correct point after the crypto deposit.
  • Flexible support — any coin on any supported network.

Technical instructions on adding this feature for partners​

  1. Once the feature is requested, Guardarian team customizes the Wallet-Button using the partner’s logo in svg format.

  2. From the partner’s end in order to make the feature work it is needed to do the following: Goal: creating the link in format https://wallet.example.com/send?...

    ARCHITECHTURE

    [ URL ]

    ↓

    [ HTTPS domain ]

    ↓

    [ .well-known, checks Mobile, OS ]

    ↓

    [ App ]   or   [ Web ]

Required tools:​

  • Endpoint /send
  • Endpoint …/.well-known/...
  • Universal Links (iOS)
  • App Links (Android)

Required params:​

  • fromCurrency — the crypto currency
  • fromNetwork — the crypto network used
  • address — unique PayIn address where the crypto will be sent
  • memo - *optional

Examples:

example of a deep link with memo

https://adguard-walet.com/send?fromCurrency=xrp&fromNetwork=xrp&amount=0.001&address=rDsbeomae4FXwgQTJp9Rs64Qg9vDiTCdBv$memo=123456789

without memo

https://adguard-walet.com/send?fromCurrency=btc&fromNetwork=btc&amount=0.001&address=bc1q9u7x6k0m2n3c7s5e4f0xv9w8d6p5h3j2k4l8m