Individual Terminal settings are described within this section.

note

When using Terminal Templates, many of these options will be located & controlled there.

See: https://generalbytes.atlassian.net/l/c/giG3y00Z

When using Terminal Templates, many of these options will be located & controlled there.

See: https://generalbytes.atlassian.net/l/c/giG3y00Z

Terminal Reports & Logs:

TRANSACTIONS

Transaction Logs & Analytics

EVENTS

Event Log: your BATM Heartbeat

CASH

Cash Control & Reports

ACTIONS

Remotely control your BATM.

Terminal Status & Statistics (quick view):

The following quick reference data is displayed for this specific terminal:

Counters:

Long counters are “forever” - all amounts since the BATM was placed into service on CAS.

Short counters are reset periodically (as needed) typically during cash servicing.


General Settings

  • All settings marked with a double asterisk (**) are required.

  • Items in red can only be changed by users with administrator privileges.

image-20240510-134921.png

Serial Number: from the label! Used throughout CAS to uniquely identify each BATM.

Version: the firmware version currently installed in the BATM.

Network Info: the type of network this BATM was last connected to, and it's last known IP address.

Restore point version: information about the most recent restore point created.

Name: an arbitrary name you call this particular BATM. Be descriptive. Anything that will help you pick it out of a list will do.

Acceptors: the type of bill acceptor (and billset) currently installed in your BATM is displayed here.

Created at: read-only setting that reveals the date this Terminal was added to the database.

Terminal Locked: Terminal settings cannot be changed while locked by an Administrator.

Terminal Active: enables the terminal, otherwise the BATM displays the maintenance message. De-activating the terminal turns off all access except administrative (at the BATM) and CAS (here).

Deactivate outside of opening hours: when enabled, the BATM is deactivated (and cannot be used) outside of the “opening hours” as defined within the assigned Location.

IP Whitelist Enabled: prevents your BATM from connecting to potentially dangerous local networks, and helps prevent loss if your BATM is abducted. See: Error: Check your IP Whitelist

IP Whitelist: the IP of the current (or most recent) router that your BATM is connected to.

Update IP Whitelist automatically unless Terminal restarted: enable when IP’s are dynamically set by the Internet provider. When they assign a new public IP to the router, this setting will automatically accept the new IP and update the setting.

Registration Number: helps identify a BATM from the BATM screen (when implemented).

Top Left Corner Display: Used to display helpful identifying information at the BATM to customers & other third-parties (merchants, handlers, techs, etc) onsite.

Block “Not Registered” by Certain Line Type: changing this setting is an additive restriction to the blocked line types (as set in Organization).

Terminal physical appearance: the BATM display graphics can be modified to match the actual appearance of the machine. Select the physical appearance here.


Terminal settings may be standardized and applied across common models.

Use Terminal Templates to create & share those settings, see: https://generalbytes.atlassian.net/l/c/giG3y00Z


Owner **: the Organization that owns this BATM terminal (admin only).

Notification Policy: be certain to create and select a notification policy for your terminal. If a customer tries to register, you won't be automatically notified unless you specifically activate a policy!

AML/KYC Setting **: select the appropriate AML/KYC policy.

Skin: a custom theme that you may choose to display on this terminal.

Terminal Permission Template: when using a a Terminal Permission Template, select it here.


Administration Key: This is the text to be encoded in a QR code. The resulting QR code is shown to the BATM when requesting access to BATM Admin functions.

Maintenance Message: displays “Out Of Service”, “Gone Fishing”, or whatever you set here.

Diagnostics Key: the text to be encoded in a QR code. The resulting QR code is shown to the BATM when triggering a BATM self-test. This may be left blank during initial setup.

VPN Required (deprecated): a secure VPN tunnel is required for this Terminal to connect to CAS.

Auto Restart: when enabled, this will trigger the BATM to automatically reboot when the Internet has been unavailable for an hour. It will only restart a maximum of 6 times - then give up.

Use Hardcoded Blacklist Addresses: when enabled, destination wallets presented by a customer are scanned against a hardcoded blacklist for fraudulent or other verified malicious actors.

Allow Balance Check: permit your customers to check their coin balances at the BATM.

Don't Accept Cash If You Don't Have Enough Supply: stop a BUY if there’s insufficient coin in your hot wallet. “Supply” does not include fiat balances, only coin balances (BTC, ETH, etc).

If the transaction fails, you may always opt to send the coin manually to the customer.

  • depending on your BUY strategy, you may choose to disable this option.

Allow Receipt Delivery: allow electronic receipt delivery from the confirmation screen.

Allow Email Or SMS Purchases: your customers will have the option to have a private key sent to them directly. Accessed via “Don’t Have a Wallet?” option during BUYs.

Allow Voice Call: when using SMS authentication, the code may fail to be received by your customer.

QR Code Sticker Detection: this option detects a QR code sticker attack. Setup a notification policy if this attack is active and/or common in your deployment area.

Show Exchange Price Chart Screensaver: displays a price chart if you use an Exchange in your Crypto Settings BUY.

Private Administration: reduces the admin screen size/profile when administering the BATM models with larger screens (BATMThree/BATMFour).

Hide redeem button when sell is not possible: in some situations, you may still accept redemptions even when SELL transactions are not possible (2-way BATMs only).

Ignore Transaction Failures: do not report transaction failures to the onsite customer. This might be implemented when a standby Operator is monitoring all transactions & is manually competing the transactions.

Cash Fraud Detection: when equipped with door sensors, the BATM will reject any attempted transactions while a vault sensor is triggered (door is open) and this setting is enabled.

Enable CashBox Video Recording: record cashbox servicing (useful when your cash is handled by a third-party (e.g. armored-car service). See: CashBox Video Recording

Customer can cancel transaction: after cancelling, the customer will have to contact you for a cash refund, but this option permits the customer to cancel the transaction despite having inserted cash.

Disable Door Sensor: check this option if you’re having detection issues. You must reboot the BATM after disabling the option (and thus re-enabling the door sensor).

Skip Privacy Notice: don’t show the “Privacy Notice” normally displayed prior to requesting AML/KYC required documents (during a transaction).

Show Marketing Agreement Screen: when enabled, will show the contents of the Custom String:

Skip Asking for Marketing Agreement E-mail: when checked/enabled, the BATM won’t request the customer’s email (for marketing). Useful when the email is already known/set.

Blur Detection Limit: (default=3) set this to change the number of times the BATM requests a rescan of “blurry” documents presented during KYC verification. Zero (“0”) = turn off this feature.

Withdraw Configuration: (for Terminals supporting cash dispensers).


Banknote Labels

When configured in your Organization, banknote labels allow you to gain provisional credit for cash on hand in Terminals assigned the label. This is specifically used for Bankline support. Assign the label to this Terminal where appropriate, and the banknotes are then further marked in Banknote History.

See: https://generalbytes.atlassian.net/wiki/spaces/ESD/pages/2748186625/Organization#Banknote-Labels

See: https://generalbytes.atlassian.net/wiki/spaces/ESD/pages/965771371/Cash#BANKNOTE-HISTORY


Currencies

You'll need to have at least one type of paper currency setup in (“Fiat Settings”) and one type of crypto-currency setup in (“Crypto Settings”) to complete this section.

Main Cash Currency **: select the primary type of currency your bill acceptor is designed to receive. Your particular bill acceptor model can be determined from the BATM admin screen.

This is a mandatory field and must be entered to save the Terminal setting.

See Acceptors (above) to identify your supported billset.

  • Each of these may be added and configured in the main menu “Fiat Settings”.

  • The first currency (i.e. USD in USDCADEUR) must be used & listed first.

Additional Cash Currencies: if your bill acceptor takes multiple currencies, specify them here. See the bill acceptor specifications for your BATM to determine what currencies are supported.

note

Example: for US sales - the US Dollar, the Euro, & the Canadian Dollar (USDEURCAD) billsets are installed by default in the BATM, so in this example you would set “USD” as the “Main Cash Currency” (above) and add “EUR” and “CAD” here. You may skip this area if you only want to accept the main cash currency (USD).

Example: for US sales - the US Dollar, the Euro, & the Canadian Dollar (USDEURCAD) billsets are installed by default in the BATM, so in this example you would set “USD” as the “Main Cash Currency” (above) and add “EUR” and “CAD” here. You may skip this area if you only want to accept the main cash currency (USD).

Crypto Currency **: select the types of crypto-currency you support. Each type will need an entry in the main menu's “Crypto Settings”.

This is a mandatory field and must be entered to save the Terminal setting.

Setup each coin with its own Crypto Setting.

Fiat Settings

Assign a fiat setting to each Cash Currency identified in the previous step.

This is a mandatory field and must be entered to save the Terminal setting.

Crypto Settings

Assign a Crypto Setting to each Crypto Currency identified in the previous step.

This is a mandatory field and must be entered to save the Terminal setting.


Languages

General Bytes' products supports many languages, and is constantly adding more!

Default Language **: the language that the BATM uses unless another is selected (see appendix “B”).

This is a mandatory field and must be entered to save the Terminal setting.

Preferred Languages **: the languages you wish to offer the customer for BATM usage.

This is a mandatory field and must be entered to save the Terminal setting.


Custom Strings

These messages are displayed on your BATM, receipts, and messages.

See: Custom Strings


Location

These settings allow you to record deployment locations for documentation purposes. It allows you to identify what sales happened where, which is a prudent record to have available.

This is a mandatory field and must be entered to save the Terminal setting.

Location **: the location at which this BATM will installed. This will show up on CoinATMRadar.

Location From Date **: the starting date this BATM will be at this location.


Printing Settings (for BATMs with attached printers)

Allow Paper Wallet Print: enable to allow paper wallets as an option.

Disable Printer Warnings: turn off “low paper” (etc) warnings.

Mandatory Paper Wallet Scan: when enabled, forces your customer to scan their printed QR code (after printing) to ensure the print was completely successful (and physically/legally received).

Print POS Receipt: (deprecated, undocumented & unsupported)

Print Withdrawal Receipt: [Never / Always]

Print Buy Receipt: [Never / Always / On Demand]

Sell Tickets Delivery: [Print / Send via SMS / None] enables your customer to conduct a SELL offsite and retrieve their fiat via any of your 2-way machines.


Cash/Card Settings

Dispense Cash Algorithm: choose the preferred method of dispense operations:

Cash Collection Mode:

Display Last Cash Collection In Terminal Administration: when enabled, displays the most recent cash collection time, date, and amount on the BATM’s onsite ADVANCED ADMINISTRATION screen.

Risk Box: if you’re feeling particularly trusting with your business model, you may allow customers to withdraw SELL transactions under this specified amount without the required mining confirmations. This is a dangerous practice, but it is your choice. Use at your own risk!

Card Issue Mode (for NFC card-enabled machines):


Face Search

Face Capture Active: will capture a silent selfie during every transaction when enabled.


Publish Settings

You may choose to keep your BATM hidden - otherwise, publish it! The information is shared with third-party websites that steer customers towards the nearest Bitcoin ATM. The customers then give you money. You like money, right?

Setup your account with these companies to add your BATMs to their website:

Publish To HQ (GENERAL BYTES): check to enable publication. CoinATMRadar.com polls our reporting API periodically to share the information you provide with the world.

Show Terminal Location: as set in “Locations” for the applicable Terminal.

Show Terminal Prices: the crypto prices as set in “Crypto Settings”.

Show Terminal Fees: as set above in “Crypto Settings”.

Show Terminal Limits: these are any AML/KYC limits set for the Terminal.

Show AML Type: whether or not AML/KYC is implemented on this BATM, and those requirements.

Report Buy Available: turns “Buy” on/off at Coin ATM Radar.

Report Sell Available: turns “Sell” on/off at Coin ATM Radar.

Report Cashboxes Contains Of IN Type: the supported currencies accepted (as set in “Fiat Settings”).

Report Cashboxes Contains Of OUT Type: the supported currencies dispensed (as set in “Fiat Settings”).

Terminal Public Name: a description of the BATM, visible to the customer at the BATM location.

Terminal Comment: a comment that will help the customer with additional info about the BATM.

Operator Public Name: as displayed in the “Operator details” section of CoinATMRadar.com

Operator Website: as displayed in the “Operator details” section of CoinATMRadar.com


SUBMIT

Save your Terminal settings.

Changes take effect within 15 seconds of the terminal going live and connecting to CAS.