When you first pair your machine, it will first go to one-way mode, showing a 'Buy' button only. If you have a two-way machine, you will need to configure additional settings in the admin before a 'Sell' option is present.
Enabling cash out involves adjusting the cash cassettes to fit your intended denominations, stocking the cassettes with cash, setting up two third-party services, and then applying your cash-out related admin settings.
Adjusting and loading the cash cassettes
Open the door of your machine and locate the cash dispenser. Remove both cash cassettes by pushing in on their green buttons.
Once removed, open them by pressing on the other green button on the back of the cassette.
Decide on the bill denominations you'll use for each cassette. Each cassette holds up to 500 notes of a single denomination.
Have at least a couple of bills of each denomination with you. You'll need to adjust the spacers within the cassettes to fit the length and width of each denomination, using the bills as a guide.
With the cassette open, carefully lift the green flaps. You'll find three Philips-head screws at the bottom which fix the spacers in place. Loosen these and adjust to the denomination's width and length, tightening them back into place.
Mind the metal nuts on the bottom side of the cassette. Hold these in place while tightening the screws of the spacers.
After the cassette spacers have been adjusted, load the cassette with bills, and carefully lower the two green flaps. We recommend having a minimum of 10-15 bills of both denominations at any one time, in order to ensure sufficient downwards pressure on the next bill that the dispenser will retrieve.
Reinsert both cassettes into the dispenser. They will need to be present before cash-out can be enabled.
When making transactions that require a confirmation on the blockchain, customers will need to provide their phone number and a confirmation code so that they may later identify themselves in order to redeem their cash.
SMS messages are sent via Twilio. Follow our article 'Twilio for SMS' to set up an account and configure its credentials in your admin.
Then, return to the steps in this article.
Blockcypher is a service that provides a confidence analysis for your customers' incoming Bitcoin deposits. It is consulted for transactions that are meant to be immediately dispensed with zero confirmations.
If the incoming transaction is rated above your configurable confidence factor, then the transaction is dispensed. If it falls below, then the user is directed to confirm their phone number and instead wait for a confirmation before redeeming.
Blockcypher is recommended, but not required. Follow our article to configure Blockcypher. Then, return to the steps in this article.
Pairing the machine
If you haven't already, the machine will need to be paired to your admin before the option to enable cash-out is present.
Configuring cash-out settings
In 'Machine Settings > Cash Out', set the Cash Out column to On for the desired machine.
Then, enter the Cash-out denominations of the bills you placed into the Top cassette and Bottom cassette. These are not the amount of bills you placed in the cassettes (that will be a different screen), but rather these are the face-value denominations of each cassette's bills.
⚠️ NOTE: What you enter here must be valid bill denominations in your currency. For example: There is no $1 CAD bill, so 1 would be an invalid denomination that would cause an error, but 5, 10, 20, 50, and 100 are valid Canadian dollar denominations. Similarly, 100 is not a valid British pound note, but 50 GBP is.
Set a Virtual amount that is a multiple of one or both denominations. This adds another button to the machine screen (see image below) as a convenient way for customers to select larger amounts than your highest denomination. For example: If you are using 20 and 50 CAD, the Virtual value can be 40, 60, 70, 80, 100, 200, 250, etc., but cannot be 25 or 75, because you are not using 5 CAD notes.
Machine cash-out screen showing two cash denominations and 'virtual' denomination.
Set a 0-conf Limit. Below this amount, your machine will dispense cash as soon as the customer's cryptocurrency deposit is seen. Above this value, the customer confirms their phone number, deposits cryptocurrency, and is then sent a text message to come back and redeem the cash when a confirmation has occurred on the blockchain.
In 'Machine Settings > Commissions', set a cash-out commission percentage. This and other values on this panel can be set globally or on a per coin basis.
In 'Global Settings > Notifications' set the SMS Gateway to Twilio.
In 'Maintenance > Machines', input the quantity of bills you placed in the Top cassette and Bottom cassette and click 'Update Counts'.
Zero Conf settings
In 'Global Settings > Wallet Settings', go through each currency tab and set the 'Zero Conf' as the following:
- BTC: Blockcypher – or – Always 0-conf (if you are not configuring Blockcypher)
- ETH: Always 1-conf
- ZEC: Always 0-conf
- BCH: Always 0-conf
- DASH: Always 0-conf
- LTC: Always 0-conf
What these mean:
- Blockcypher – Only available on BTC, analyses confidence of incoming 0-conf deposits and pushes to 1-conf flow if confidence is too low.
- Always 0-conf – For those transactions below your set 0-conf Limit, dispense as soon as the user has sent their coins and the transaction is seen on the network. This is the default expectation, and transactions above your 0-conf Limit will still require one-confirmation before dispensing.
- Always 1-conf – Always require the user to confirm their phone number and wait for their deposit to have one-confirmation before redeeming their cash. NOTE: This conflicts with your 0-conf Limit on all coins other than ETH, meaning, if you want to ensure that all transactions require one-confirmation, then set your 0-conf Limit at the first dollar instead of using this setting. (In the case of ETH, the user is prompted to wait ~10-15 seconds at the machine as their deposit confirms and subsequently dispenses.)
Place test transactions at the machine to confirm 0-conf and 1-conf dispenses are working across all coins.
If your machine stays on the 'Booting up' screen after enabling cash-out, please see the article on addressing the 'Booting up' screen.
If you experience issues confirming phone numbers, please carefully review each step of the 'Twilio for SMS' article.
If you experience issues in dispensing, please consult our Cash-Out Troubleshooting section.