Terminal Templates

Terminal Templates

Set your common Terminal Settings here. Each BATM type has a different set of…settings - so at least one different page of defaults is needed for each model you deploy. Not every Organization will deploy all models of BATMs, and in some instances you may choose to have multiple defaults for a single model - depending upon the regions that you service.

Example:

 

+ADD creates a new Terminal Setting.

Name

Lists the descriptive title of the Terminal Setting.

Organization

Lists which organization owns that Terminal Setting.

Terminal type

Lists the model (display style) for these settings.

Terminals using this settings

Displays the number of Terminals using this Terminal Setting.

Actions

These commands apply to this Terminal Setting:

Actions

These commands apply to this Terminal Setting:

VIEW: examine these Terminal Settings.

SHOW TERMINALS: display the Terminals using this Setting.

DELETE: delete the Terminal Setting. This button is unavailable if any Terminals are set to use this shared Setting.

image-20240823-182616.png

DUPLICATE: create another Terminal Template duplicating this one.


These fields are mandatory; they MUST be set before you “Submit” (or all changes are lost).

  • Name*

  • AML/KYC Setting *

  • Main Cash Currency*

  • Crypto Currency*

  • Fiat Settings

  • Crypto Settings

  • Languages: Default Language*

  • Language: Preferred Languages*

Setting Details


The page may vary depending upon the BATM model being setup. In this example, a BATMTwo is used.

  • Enter a Name and select the Terminal type.


Settings

image-20250922-200114.png

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 policy.

Skin: a custom theme that you may choose to display on this terminal. See: https://generalbytes.atlassian.net/wiki/x/TwAYOg

Resource Bundle: if Resource Bundles are deployed in “Look & Feel”, select the relevant RB here.

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

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


image-20250922-201351.png

Administration Key: This is the key encoded in the QR code that 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.

  • Controlled by the “Terminal Active” setting above (inactive = display this 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.

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.

Don't Accept Cash If You Don't Have Enough Supply: stop a BUY if insufficient coin in your hot wallet. This does not check Exchange fiat balances, only coin balances.

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.


image-20250922-201725.png

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.

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

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 Failed Transactions: 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 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: https://generalbytes.atlassian.net/wiki/spaces/ESD/pages/2856189993

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.


image-20250922-202054.png

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.

Hide discount amount:

Hide the discount amount on the terminal screen. Discounts are still allowed for customers.

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

Show redeem QR code on the terminal screen:

After a successful sell transaction, the QR code will be displayed on the terminal (in addition to the printed REDEEM ticket) containing data enabling the cash withdrawal. By enabling it you increase the risk of the withdrawal code being stolen by surveillance or someone standing close to the BATM with a camera.

Show Market Rate On Insert Cash Screen

If enabled, the market exchange rate will be displayed on the terminal's cash insertion screen. The value displayed will be the same as provided by the rate source without any adjustments, such as for fees or discounts.

Show Percentage Fee On Insert Cash Screen

If enabled, the percentage fee applied will be displayed on the terminal's cash insertion screen. The percentage fee used is the one selected based on the configuration, evaluated from crypto settings (Profit in %), terminal profit override or extension profit override.

Enable image screen from resource bundle:

Show the additional screen (before Terms & Conditions) screen from the resource bundle.

Enable image screen after transaction from resource bundle:

Show the additional screen (after transaction success screen) from the resource bundle.

Hide sell SMS notification opt-in dialog:

Enabled = customers are prompted to receive SMS notifications about the sell transaction progress. The dialog is displayed for anonymous sell transactions when the identity phone number is not known.


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.

image-20250922-204327.png

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 which currencies are supported.

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 cryptocurrency 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.

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 most languages!

Default Language **: the language that the BATM uses unless another is selected.

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: https://generalbytes.atlassian.net/wiki/spaces/ESD/pages/963280925


Printing Settings

image-20250320-181624.png

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

Allow PDF Wallet Generation: enable to allow PDF wallets as an option.

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

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

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.

Print Withdrawal Receipt: [Never / Always]


Cash/NFC Settings

image-20250922-205156.png

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, provided:

    • an hour+ has elapsed since the most recent cash collection, and

    • the cashbox/stacker contents have changed since the last collection.

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

  • 3 - Removed cash box expects barcode scan and automatically clears counters and prints 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 Tolerance: 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 card dispensers):

  • 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


Location Restrictions

Once configured, a Terminal Template can only be applied to Terminals within the same country and, if specified, the same region. To avoid limiting Terminal Template availability by location, leave the Location options unconfigured. If only a country is specified (and the region is left unconfigured), the template restriction will apply to the entire country. If you add multiple locations, the template applies if any of them match.

image-20250922-210046.png

Publish Settings

You may choose to keep your BATM hidden from the public, otherwise: publish it!

image-20250922-210346.png

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

Publish: 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 coordinates displayed on the map are used by CoinATMRadar - not the address.

  • For help with Locations, 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.

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

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

Report Cash Boxes Contains Of IN Type: types of fiat accepted as set in “Fiat Settings”.

Report Cash Boxes Contains Of OUT Type: types of fiat dispensed as set in “Fiat Settings”.

Report Opening Hours: as set in the Terminal’s Location, see: https://generalbytes.atlassian.net/wiki/spaces/ESD/pages/968818689

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

The following published Terminal-specific fields are still set in Terminal details (not here):

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.

For more details, see: https://generalbytes.atlassian.net/l/c/m11RhTww


SUBMIT

Save your Terminal settings.

 

Copyright © 2020-2025 General Bytes USA LLC