After pairing 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 and adjust the machine 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.
This article covers the admin-side of enabling cash-out. Learn how to adjust your dispenser's cash cassettes here: Configuring and loading cash-out cassettes
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 strongly 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 'Settings > Cash Out', set the Cash Out row to On under Enable for the desired machine.
Then, click on the pencil icon in the Edit column and 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 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. Click Save afterwards.
⚠️ WARNING: Dispensing cash upon a zero-confirmation Bitcoin deposit is inherently a risk. Blockcypher scoring mitigates but does not eliminate the chance that your customers' deposits may not confirm. Do not set a '0-conf Limit' for more than you are willing to risk for the sake of facilitating small, immediate cash-out transactions.
In 'Settings > Commissions', click on the pencil icon on the Edit column and set a cash-out commission percentage. This and other values on this panel can be set globally or on a per coin basis.
In 'Settings > Notifications' enable the SMS feature to receive notifications through your Twilio number by setting the toggle to On under Active.
In 'Maintenance > Cash Cassettes', click the pencil icon under the Edit column to input the quantity of bills you placed in the Top cassette and Bottom cassette, afterwards click Save.
In 'Settings > Wallet', go through each currency row and set Bitcoin's 'Confidence checking' as the following:
- BTC: Blockcypher – or – None (if you are not configuring Blockcypher)
- ETH, LTC, DASH, ZCH, BCH: None
Blockcypher is only available on BTC, analyses confidence of incoming 0-conf deposits and pushes to 1-conf flow if confidence is too low. The other coins will have only "None" as an option here.
Place cash-out test transactions at your machine to confirm your cassettes and settings have been properly configured and that dispenses are successful.
If you find that BTC deposits that are expected to be 0-conf (immediate dispense), are instead pushed to a 1-conf flow (requiring a phone number and later redemption), your Blockcypher confidence factor may be too high. Consider lowering the threshold in your Blockcypher settings in the '3rd Party Services' panel.
If your machine stays on the 'Booting up' screen after enabling cash-out, please see the article 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.