Zaprite

How to Connect a Wasabi Wallet to Zaprite

Connect your own bitcoin wallet by providing an xpub. Remain in complete control of your funds while also enhancing on-chain privacy.

Zaprite Team

4 min read

connect a wasabi wallet to zaprite using xpub
On this page

Zaprite allows users to connect their own self-custody bitcoin wallets by providing an xpub. This allows users to remain in complete control of their own funds, while also enhancing on-chain privacy by generating a new receiving address for each payment request.

You can use any wallet software that allows you to export an xpub. The following guide outlines the instructions for exporting your wallet xpub from Wasabi Wallet, but the steps will be similar for most wallet software.

If you are not yet running Wasabi Wallet, you can download the latest release from Github:
https://github.com/zkSNACKs/WalletWasabi/releases

Create a New Wasabi Wallet

To create a new wallet, click the Add Wallet button on the bottom of the left-hand side navigation in Wasabi Wallet.

Creating a new wallet in Wasabi Wallet.

  1. Click ‘Create a new wallet‘
  2. Add a Wallet Name (example: Zaprite Wallet)
  3. Write down your Recovery Words. NEVER save these words online or share them with anyone.
  4. Confirm your Recovery Words.
  5. Add a wallet Password and save this in your password manager.
  6. Choose a Coinjoin Strategy. If you are unsure simply choose Maximize Speed. Coinjoins are switched off by default, and you can always change this setting later before activating this feature.

That’s it! You now have a new secure wallet setup for use in Zaprite.

Copy the Wallet xPub

Once you have your wallet setup you will need to copy the wallet’s Extended Public Key (xpub). Click the ellipses menu (⋯) in the top right of the app and then click Wallet Info. Enter the wallet password when prompted.

Accessing the Wallet Info screen in Wasabi Wallet.

Scroll down to the end of the content and click the copy icon to the right of the Extended Account Public Key (SegWit).

Copy the Extended Account Public Key (SegWit) for your wallet.

Connect your Wallet to Zaprite

The next step is to add your wallet to Zaprite. Navigate to the Connections screen and then click the Connect button under the Bitcoin card.

Connect a Bitcoin wallet to Zaprite.

You will be prompted to enter some information about the wallet:

  1. Label: Add a custom label to identify this wallet within Zaprite. This will not be visible to your Customers.
  2. Extended Public Key: Paste your xpub here. This will auto-generate the first receive address for the wallet in the Wallet Validation section at the bottom of the form.
  3. Address Type: Choose the address type your wallet is using. If you setup a new wallet in Wasabi this will default to SegWit (bc1…). However, you may change this setting if you are adding an existing or older wallet (3…).

Adding your wallet information to Zaprite.

Once you have this information entered, the final step is to validate the wallet by confirming if Zaprite has generated the correct receiving address.

Wallet Validation

To validate the wallet connection, go back into Wasabi Wallet and click the Receive button on the top right. Enter an identifier label (example: ‘Zaprite’) and then click Continue.

Generate a new receiving address in Wasabi Wallet.

You will be shown the first receive address for your new wallet. Note the last 6 characters of the address and then return to Zaprite and enter those characters in the field provided.

Validate your wallet xpub by confirming the first receive address.

Click OK to submit the wallet information. If the addresses match, your wallet will be successfully connected and available for use within Zaprite.

Wallet Settings

Once you have validated and connected your wallet, Zaprite will generate and list the first 100 addresses for viewing.

After successfully validating a wallet, the first 100 addresses are displayed.

This list shows which addresses have been Used, Reserved or Locked.

  • Used: The address has received funds and will not be used again.
  • Reserved: The address has been shown on a Checkout and is temporarily reserved for an open Order.
  • Locked: The address is permanently locked for use outside of Zaprite (for example, in a consolidation transaction).

Checkout Settings

Now that you have your Wasabi Wallet connected, you can choose to set this as your preferred Bitcoin payment method for your default Checkout.

Set your new wallet as the default Bitcoin payment method.

Navigate to Checkouts on the main Zaprite menu. Toggle on the new wallet you just connected and Confirm and then Save the settings for your Checkout. When this wallet is in use, Zaprite will generate a fresh unused address for each Customer payment. You can always override the active payment methods on individual Invoices and Checkouts.


Further Information

Published by Zaprite Team

Nov 16, 2023

Keep reading

More guides

Guides

How To Connect Branta

Easily connect your Branta account to Zaprite and enable Branta's address verification features on your Checkouts.

2 min read

Zaprite Aqua Wallet Integration

Guides

How To Connect Your Aqua Wallet

Connect your Aqua Wallet Lightning Address to your Zaprite Checkouts and receive lightning payments directly into your self-custody wallet.

2 min read

Ready to get started?

Start your Free Trial today or reach out to our Sales team with any questions.