Freewallet.io User Manual
Freewallet.io User Manual
  • Getting Started
    • What is Freewallet?
    • What are the features of Freewallet?
    • Where can I access Freewallet?
    • Where can I access previous versions of Freewallet?
    • What is Tokenscan.io?
    • Why do I need small amounts of Bitcoin to do things in Freewallet?
    • What BTC fee should I use?
    • What is the Automatic Donation System? How do I turn it off?
    • What is an Asset/Token/NFT? How can I store them?
    • I want to trade a certain Asset, is it legitimate?
    • How to find the License Agreement
    • What else do I need to know?
  • Exploring Balances, History, Exchange and Dispensers
    • Address Balances
    • Address History
    • Viewing Tokens
    • Exploring Token Information and Enhanced Asset Information
    • Understanding Dispenser Markets
    • Buying XCP and User Created Tokens from a Dispenser
    • The Decentralized Counterparty Exchange (DEx)
    • Understanding Exchange Pairs
    • Buying and Selling XCP and Tokens on the DEx
    • Understanding BTCpay and BTC/TOKEN on the DEx
  • Freewallet Functions
    • Creating a Wallet
    • Locking and Unlocking Your Freewallet
    • Viewing, Creating and Importing Addresses
    • Show a QR Code for your Address
    • Sending and Receiving BTC
    • Sending / Receiving XCP and User Created Tokens
    • Displaying the Seed Phrase and Private Key of your Address(s)
    • Using the Multi Send function
    • Create a Counterparty Token (NFTs and FTs)
    • How to Change Token Properties
    • Changing the Token Description
    • Issuing more Token Units
    • Resetting Your Token Issuance
    • Locking Your Token Issuance
    • Transfer Token Ownership
    • Destroying Tokens
    • Paying Dividends to Token Holders
    • Voting with Tokens
    • Broadcast information on the Bitcoin blockchain
    • Signing a Message Using Freewallet
    • Signing a Transaction Using Freewallet
    • Using the Sweep Function
    • Setting up a Dispenser
    • Closing a Dispenser
    • Cancelling Exchange Orders
    • Starting an Exchange Pair that has no orders up yet on the DEx
    • Minting Open Fairmints
  • Common Questions Using Freewallet (FAQ)
    • What if you make a mistake?
    • Where can I see my current version?
    • How do I check my Freewallet Server settings?
    • How do I use the Debug function on Freewallet?
    • Can I use the Counterparty/Bitcoin Testnet in Freewallet?
    • Can I burn BTC for XCP?
    • What’s a Stamp?
    • What’s an Ordinal?
    • If Tokenscan is down for maintenance, can I still access my funds?
    • Why is there more than one input on my BTC transactions?
    • Does Freewallet support two-factor authentication?
    • Can you lock a Token description?
    • Can I run my own Counterparty server?
    • How do I use Freewallet to mint an Emblem Curated Vault?
    • How do you create a Burn Address for use on Counterparty?
  • Troubleshooting / Issues
    • I sent BTC (or a Token) to Freewallet, why doesn't it show up?
    • Why can't I see my assets I own or created with 0 issuance?
    • "Error While Trying to Broadcast Transaction"
    • "Failure to send not enough BTC in wallet"
    • My Freewallet Exchange/Dispenser tab is resetting the data when I try to sort by BTC Price?
    • "Public key was neither provided nor published in blockchain."
    • I logged in and see none of my assets but I see them on tokenscan!
    • Help! I used too small of a fee and my transaction is not confirming!
    • I sent/dispensed an XCP asset to a Wrapped Segwit Address (address beginning with "3")
    • I sent/dispensed an XCP asset to a Taproot Address (an address that starts with "bc1p")
    • I updated Freewallet and can only see my first 20 addresses! How can I get them back?
    • My second transaction on an MPMA (Multi-send) is not getting confirmed and giving me an error
    • Freewallet gave me a TX link but Tokenscan says "Transaction not found on tokenscan"
    • Error composing dividend transaction via API: ['zero dividend']
    • My MacOS/Windows is saying Freewallet is not verified by the app store. What should I do?
    • Counterparty API Communication Error!
    • What is a Counterparty API Error?
    • Stuck on "Checking Data Encoding Fees"
    • Constructed transaction does not parse correctly
    • My transaction is too low of an "Effective Fee Rate"
    • Error Composing Dispenser TX - Balance History
    • I entered my created password and stuck on "You will need to unlock..."
  • Getting Support
Powered by GitBook
On this page
  1. Freewallet Functions

Closing a Dispenser

PreviousSetting up a DispenserNextCancelling Exchange Orders

Last updated 6 months ago

It is possible to close a dispenser right from the My Dispenser tab in the Dispensers tab or to manually close it using the Transaction Hash with the Actions tab in Freewallet.

  • It will require a Bitcoin transaction to do so and comes with a bit of responsibility when doing so.

  • Once a Close Dispenser transaction is confirmed it will take five Bitcoin confirmation blocks for the asset in the dispenser to be returned to you.

It is important to first note ANY unconfirmed transactions on your dispenser before you close it. Though it is possible to close a dispenser before someone’s dispense has finished (especially if they used too low of a fee), if you do not refund the funds sent from Unconfirmed Dispenses it is seen as a very disrespectful and a fraudulent action to do to your buyers.

To check if there are any unconfirmed Dispenses, view your Dispenser on Tokenscan.io and click the "Unconfirmed" tab at the bottom of the page:

Since all of these transactions are publicly broadcasted on the Bitcoin blockchain, this data will be easy to access and unchangeable in the future.

It is much more responsible to openly express you are in control of the dispenser and will accurately address if any buyer issues arise because of low transaction fees or unconfirmed attempts at dispenses.

To close a dispenser, first navigate to the address you created the dispenser from (also called the Origin Address) or navigate to the address the dispenser is currently live on (also called the Source Address).

  • You are able to close a dispenser from the Origin OR Source address in Freewallet.

Then go to the “Dispensers” tab on the top of Freewallet.

If you do not see your asset in the My Dispensers tab and you verify you are selected on the Origin or Source address for this dispenser, you can also manually close it by clicking the "Actions" tab on the upper right and choosing "Close Dispenser":

Here you will see the option to “Close” your dispenser on the right side. Simply click that red "Close" button and Freewallet will pop up this prompt:

Since you are able to close an open dispenser from the Source or Origin address, Freewallet asks you for the specific transaction ID for this dispenser.

This information can be found on Tokenscan and is marked as the "Transaction Hash" of that specific dispenser:

  • If you have closed this dispenser from the Origin address, the asset(s) will be returned to the Origin address after five Bitcoin confirmation blocks after the Close Dispenser transaction has been initially confirmed.

  • If you have closed this dispenser from the Source address, the asset(s) will be returned to the Source address after five Bitcoin confirmation blocks after the Close Dispenser transaction has been initially confirmed.

After you click close dispenser, the transaction will be sent to the Bitcoin network and when it is confirmed your Dispenser will now be closed.

After five confirmation blocks you will now be able to freely send and access the token(s) that were once in the dispenser.

To review what the Origin and Source addresses are, look over the section of the User Manual.

From the close dispenser popup you can also choose your BTC fee you would like to use. If you are wondering what BTC fee to use, check out the section of this User Manual.

This dispenser feature is still in discussion and many Community Members have voiced their opinions on making this feature better in the future. Please check out the and the for more information on this discussion.

Setting up a Dispenser
What BTC fee should I use?
Counterparty Forums
Counterparty Github
Unconfirmed dispense shown on the bottom (in the screenshot this unconfirmed transaction was broadcasted 2 minutes ago).
The manual way to close a dispenser: Actions tab shown with Green arrow and Close Dispenser button shown with Green oval.
Transaction Hash shown in Red, Origin address shown in Orange, Source address shown in Blue