Terminal Settings

Individual Terminal settings are described within this section.

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

See: Terminal Templates - General Bytes Knowledge Base - Confluence

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:

  • Terminal Display: Exchange Rates (Buy/Sell) as seen by the customer.

  • Updated At: the last time the BATM updated it's screen.

    • Terminal Time: the time the individual BATM has locally.

    • Server Time: the time of the event according to CAS.

  • Available Cash For Dispensing: Available/Allocated for SELL purposes.

  • Balance: a transaction is in progress, and this is the amount of fiat involved.

  • Remaining Anonymous Customer Limits (where applicable).

Counters:

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

  • Buy Counters Long: displays the amount of cash ever deposited into the BATM. This amount is saved for the duration of the BATM service life while installed on your CAS.

  • Sell Counters Long: displays the amount of cash ever issued from the BATM. This amount is saved for the duration of the BATM service life while installed on your CAS.

  • Maintenance Counters Long: displays the amount of cash ever deposited into the BATM during maintenance. This amount is saved for the duration of the BATM service life while installed on your CAS.

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

  • Buy Counters Short: displays the amount of cash deposited into the BATM since it was last cleared.

  • Sell Counters Short: displays the amount of cash issued from the BATM since it was last cleared.

  • Maintenance Counters Short: displays the amount of cash deposited into the BATM during maintenance since it was last cleared.


General Settings

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

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

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

  • Enable this after the BATM is deployed onsite, disable it during initial setup only.

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

  • Enable this if you are certain the IP will never unexpectedly change.

  • The IP to be entered is your router’s PUBLIC IP. Entering a local/private IP will result in the BATM being blocked. e.g. 192.168.x.x is a “private” IP - the opposite of public. More info?

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.

Allow Buy Orders: when used with the GBSafe, enables “orders” to be created (instead of transactions). Orders are subject to a different level of legal scrutiny in certain regional jurisdictions.

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

  • Can be any arbitrary identifying information, including any legally required registration numbers.

  • Also see (below): ATM display top left corner

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.

  • Unknown (default).

  • Machine doesn't have a stand and accepts cash in the head. Click to view: image-20240514-183729.png

  • Machine has a stand and accepts the cash in the head. Click to view: image-20240514-183618.png

  • Machine has a stand and accepts the cash in the stand. Click to view: image-20240514-183843.png


Terminal settings may be standardized and applied across common models.

Use Terminal Templates to create & share those settings, see: Terminal Templates - General Bytes Knowledge Base - Confluence

  • Once created, set the preferred Terminal Template here to deploy it on this BATM.


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.

  • The default key is already implemented, so leave this blank during initial setup.

  • Do not change this unless you have read this article: Change the BATM Admin QR Code

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

  • Controlled by the “Terminal Active” setting above (“inactive” displays the specified message).

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.

  • We recommend you use a Scoring Provider instead of this older tool.

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

  • a BUY Rate Source must be configured & live for the balance to be shown.

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.

  • No

  • Always send to email and SMS automatically.

  • On demand email.

  • On demand SMS.

  • On demand email or SMS.

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.

  • Enable wallet backups in the event the wallet fails to arrive.

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

  • Enable this option to permit your customer to request a voice call with that verification code.

  • Voice calls are a paid service & charges will be applied to your account.

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:

Terminals that can dispense cash may authenticate customers using either a QR code or via OTP code. Choose the permitted method(s):

  • Withdraw using QR code (printed sell ticket or delivered as an SMS)

  • Withdraw using phone number

  • Withdraw using QR code or phone number


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.

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.

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

Fiat Settings

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

Crypto Settings

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


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”).

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


Custom Strings

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

See: https://generalbytes.atlassian.net/wiki/spaces/ESD/pages/963280925


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.

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.

  • CORRECT LOCATION: to update a location after the fact,

  • CORRECT FROM DATE: the change the deployment date, after the fact,

  • MOVE TO NEW LOCATION: the BATM is being deployed elsewhere,

  • SHOW HISTORY: show the history of deployments.


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/NFC Settings

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

  • 0 - Minimum Number of Banknotes (default)

  • 1 - Recycler Priority (send lower denomination banknotes from the Recycler whenever possible).

Cash Collection Mode:

  • 0 - DEFAULT - None

  • 1 - Removed cashbox automatically clears short counters and prints cashbox contents.

  • 2 - Removed cashbox requires confirmation on the screen to clear counters and print cashbox contents.

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.

  • Disable if you feel it is a security risk.

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 machines with NFC cards enabled):

  • 0 - DEFAULT - Don't Issue NFC Cards

  • 1 - Issue NFC Cards

  • 2 - Issue NFC Cards Only After SMS One Time Password

  • 3 - Issue NFC Cards Only After Fingerprint


Face Capture

Face Capture Active: will capture a silent selfie during every transaction when enabled. The selfie will be visible in the Identity for that customer (even if Anonymous).


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?

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.

  • The map coordinates displayed on the Location map are used by the provider.

  • See: Locations

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


Profit Override

Allows this Terminal to override the BUY/SELL profit values defined in Crypto Settings.

  • NONE is the only option until the Crypto Settings 'Profit Override Delta Min', 'Profit Override Delta Max' and 'Buy/Sell Profit' are properly set. Once set, a percentage will be shown (e.g. 0.00%).

  • After any Crypto Settings adjustment, reload the Terminal Settings to view the new options.

  • Once properly set, the % options will range between the “Min” and “Max” deltas.

  • See BUY/SELL Profit Override Delta in: https://generalbytes.atlassian.net/wiki/x/BIC9OQ


Save your Terminal Settings.

Save your Terminal settings, and remain in Terminal Settings.

Save your Terminal settings, and return to the Terminal Dashboard.

Copyright © 2020-2024 General Bytes USA LLC