Versions Compared

Version Old Version 1 New Version 2
Changes made by

Charles Wernicke

Charles Wernicke

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The settings here permit for a wide variety of options, and you can customize your SMS messages, screen messages, and receipts in ways that display your place as a professional in the market.

...

Custom strings define your BATM’s personality.

Own it! Put your special touch on it; let it represent you.

Info

Fonts cannot currently be changed or resized.

NOTE: some warning
Info
Note

NOTE:

  • Some of these fields may not appear in older software

versions. Different BATM

  • versions

will also display different settings

  • .

  • Update your software to the latest versions if you experience any trouble!

...

Info

Different BATM versions will display different settings.

...

Each field is a type, represented by the prefix:

...

This is a wallet QR code: {qr(text.crypto.destination)}

The following HTML formatting fields may be used in certain strings:

  • <b> begin bold type

  • </b> end bold type

  • <i> begin italics

  • </i> end italics

  • <br/> break (creates a new line after this)

  • You may NOT use "<" or ">" characters in your text (except as shown above)

Info

The "strings" are just plain text formatted with HTML fields and graphics.

Info

For exampleExample:

<b>This is bold text</b> and <i>this is italicized text.</i>

will be displayed as:

This is bold text and this is italicized text.

...

Warning

Fonts cannot currently be changed or resized.

...

Descriptions:

Common to all BATM versions:

support_phone: the phone number displayed on your BATM screen for support.

(not Empty - no default set)

registration_delay: the time (in minutes) given to your customer of the expected delay for identity registration

Code Block
15

. This is displayed on the BATM screen for your customer after they choose to register.

Code Block
15

printer_paper_wallet_template: this is printed when a paper wallet is selectedchosen.

Code Block
<b>PAPER WALLET - {text.cryptoCurrency}</b><br/><br/><br/><b>Spend</b><br/>{text.cryptoCurrency} - private key - keep this QR code private!{bmp.privatekey}{text.privatekey}{bmp.logo}<b>Load</b><br/>{text.cryptoCurrency} - public key<br/>{text.address}{bmp.address}<br/>

printer_buy_crypto_ticket_template: a the paper BUY receipt printed by the BATM3contents.

Code Block
{bmp.logo}<b>BUY CRYPTO RECEIPT</b><br/><br/><b>TX ID:</b> {text.transaction.id}<br/><b>Time:</b> {text.time}<br/><b>Price:</b> {text.fiat.amount} {text.fiat.currency}<br/><b>Fixed Fee:</b> {text.fiat.fee.fixed} {text.fiat.currency}<br/><b>Crypto:</b> {text.crypto.amount} {text.crypto.currency}<br/><b>Rate:</b> 1 {text.crypto.currency} = {text.crypto.rate} {text.fiat.currency}<br/><b>Destination:</b> {text.crypto.destination}<br/><br/>Keep this receipt!<br/><br/><b>Operator:</b> Name, Address, Phone, etc<br/><br/>

sms_buy_crypto_ticket_template:  this SMS message is sent to customers after a BUY when using the optional SMS delivery.

Code Block
BUY CRYPTO RECEIPT TX ID: {text.transaction.id} Time: {text.time} Price: {text.fiat.amount} {text.fiat.currency} Fixed Fee: {text.fiat.fee.fixed} {text.fiat.currency} Crypto: {text.crypto.amount} {text.crypto.currency} Destination: {text.crypto.destination}

email_buy_crypto_ticket_template: this email message is sent to customers after a BUY when using the optional email delivery. Supports basic HTML tags.

Code Block
{bmp.logo}<b>BUY CRYPTO RECEIPT</b><br/><br/><b>TX ID:</b> {text.transaction.id}<br/><b>Time:</b> {text.time}<br/><b>Price:</b> {text.fiat.amount} {text.fiat.currency}<br/><b>Fixed Fee:</b> {text.fiat.fee.fixed} {text.fiat.currency}<br/><b>Crypto:</b> {text.crypto.amount} {text.crypto.currency}<br/><b>Rate:</b> 1 {text.crypto.currency} = {text.crypto.rate} {text.fiat.currency}<br/><b>Destination:</b> {text.crypto.destination}<br/><br/><br/><b>Operator:</b> Name, Address, Phone, etc<br/><br/>

printer_pos_crypto_ticket_template: printed for the CortexPay POS.

Code Block
{bmp.logo}<b>Order ID:</b> {text.orderid}<br/><b>Total price:</b> {text.totalprice} {text.cashcurrency}<br/><b>Tip:</b> {text.tip} {text.cashcurrency}<br/><b>Amount with tip:</b> {text.amounttip} {text.cashcurrency}<br/><b>Amount to be paid:</b> {text.amountpaid} {text.ammountcurrency}<br/><br/>{bmp.logo}<br/><br/><br/><br/>

terms_and_conditions: this is shown on the BATM screen before a transaction - add . Add a "!" to the beginning of the string to force the customer to accept the terms & conditions prior to the transaction. Supports basic HTML tags.

Starts with !n! (e.g. !10!) - wait n seconds before Agree button is activated and can be clicked.

(Empty - no default set)

alternative_welcome_message: replaces the default: "Welcome to Bitcoin ATM".

(Empty - no default set)

alternative_buy_message: replaces the default: "Buy Bitcoins" on the main screen

(Empty - no default set)

alternative_screensaver_message: replaces the default: "BUY BITCOINS!" on the screensaver

(Empty - no default set)

special_configuration: used ONLY under direction of development / support. See chart (below).

(Empty - no default set)

  • separate Separate multiple fields using a space (" ")                

    • datasaving  decreases ping period (reduces data usage & responsiveness)

    • paperwalletonly  forces paper wallet usage - required in certain jurisdictions. 

    • btc_reject_bc1  rejects customer SegWit wallet addresses ("bc1")

    • -Xcoinnections - see CAS > HELP > Configuration Of Coinnections

    • -Xbitflyer=1 enables BitFlyer

    • rebootIntervalMinutesXXX  changes the "no connection" timeout            

      • Example: rebootIntervalMinutes010  sets a 10 minute timeout

    .

  • The chart is at the bottom of this article.

buy_transaction_failed_additional_message: these further instructions are displayed on the BATM screen to a customer in the event a BUY transaction fails (e.g. "Please call xxx-yyy-zzzz").

(Empty - no default set)

sell_transaction_failed_additional_message: these further instructions are displayed on the BATM screen to a customer in the event a SELL transaction fails (e.g. "Please call xxx-yyy-zzzz").

(Empty - no default set)

withdraw_transaction_failed_additional_message: these further instructions are displayed on the BATM screen to a customer in the event a REDEEM transaction fails (e.g. "Please call xxx-yyy-zzzz").

(Empty - no default set)

sms_otp: the message text when delivering one time SMS passwords to customers.

(Empty - no default set)

  • Password field is represented within the text by: {text.otp}

...

  • Example: “Here is your GB OT passcode:”

pep_rejected_info: displayed to customers that are rejected due to PEP restrictions.

Code Block
Please contact our support team  {support_phone}.

registrations_disabled: displayed when new registrations are not being accepted, or are being pre-processed by third-parties (and registration is no longer performed at the BATM).

Code Block
We are sorry, to register please visit (not set).

BATM 3/4 ONLY:

printer_sell_crypto_ticket_template: this receipt should display the QR code and crypto amount the customer is required to send to you. This ticket is then scanned at the BATM for the customer to withdraw fiat.

Code Block
{bmp.logo}<b>SELL CRYPTO RECEIPT AND REDEEM TICKET</b><br/><br/><b>TX ID:</b> {text.transaction.id}<br/><b>Time:</b> {text.time}<br/><b>Price:</b> {text.fiat.amount} {text.fiat.currency}<br/><b>Fixed Fee:</b> {text.fiat.fee.fixed} {text.fiat.currency}<br/><b>Crypto:</b> {text.crypto.amount} {text.crypto.currency}<br/><b>Rate:</b> 1 {text.crypto.currency} = {text.crypto.rate} {text.fiat.currency}<br/><b>Destination:</b> {text.crypto.destination}<br/><b>UUID:</b> {text.transaction.uuid}<br/><br/><b>Operator:</b> Name, Address, Phone, etc<br/><br/><b>How to proceed:</b><br/><b>1.Please send exactly </b> {text.crypto.amount} {text.crypto.currency} to <br/>{text.crypto.destination}<br/><b>before {text.transaction.expirationTimestamp}.</b>{bmp.paymentrequest}<br/><b>2.Wait a few minutes before your payment is confirmed.</b><br/><b>3.On machine choose REDEEM TICKET.</b><br/><b>4.Scan QR code on this ticket.</b><br/><br/><b>DON'T LOSE THIS REDEEM TICKET!!</b><br/><b>TICKET IS NEEDED FOR CASH WITHDRAWAL!!</b><br/>{bmp.logo}<br/>

printer_withdrawal_ticket_template: this is the paper SELL receipt printed by the BATM3 after the fiat has been withdrawn by the customer.

Code Block
{bmp.logo}<b>CASH WITHDRAWAL RECEIPT</b><br/><br/><b>TX ID:</b> {text.transaction.id}<br/><b>Related TX:</b> {text.transaction.related.id}<br/><b>Time:</b> {text.time}<br/><b>Amount:</b> {text.fiat.amount} {text.fiat.currency}<br/><b>UUID:</b> {text.transaction.uuid}<br/><br/><b>Operator:</b> Name, Address, Phone, etc<br/><br/><br/>{bmp.logo}<br/>

sell_withdrawal_ready: SMS that the SELL is ready for customer withdrawal

Code Block
Cash withdrawal {text.transaction.id} is ready.

sell_invalid_payment: SMS that the SELL is invalid - the wrong amount has been sent

Code Block
Invalid payment {text.transaction.id} received.

sell_timed_out: SMS that the SELL offer has expired, payment not received

Code Block
Sell offer {text.transaction.id} expired. Don't send the payment.

sell_arriving: SMS that the SELL is processing, waiting for confirmations

Code Block
Transaction {text.transaction.id} arriving, thank you. We will inform you when the cash withdrawal is ready

customer_unregistered: displayed when a customer has been unregistered, as may occur when their registration documents expire.

Code Block
We are sorry, you were unregistered due to the expiration of your ID document.

custom_pep_question: this may be customized to comply with jurisdictional requirements.

(Empty - no default set)

printer_cash_collection_ticket_template: enables a custom cash collection ticket, as mandated by certain armored car (and other cash pickup) services.

(Empty - no default set)

registration_submitted_successfully_additional_message: shown to the customer after successfully uploading the required registration documents.

(Empty - no default set)

marketing_opt_in_agreement_text: this window (when displayed) shows after the QR has been presented by a UNREGISTERED or REGISTERED during a transaction. An “opt-in” is required for marketing in various regions.

  • Leave empty to skip the agreement.

(Empty - no default set)

marketing_opt_in_agreement_title: customizethe title to the marketing opt-in agreement above.

Code Block
MARKETING AGREEMENT

...

SELL-capable (BATMThree/BATMFour) only:

printer_sell_crypto_ticket_template: this paper offer prints after a SELL is negotiated. It displays the QR code and crypto amount the customer is required to send to you to consummate your offer. The ticket is then scanned at the BATM for the customer to withdraw the agreed upon fiat.

Code Block
{bmp.logo}<b>SELL CRYPTO RECEIPT AND REDEEM TICKET</b><br/><br/><b>TX ID:</b> {text.transaction.id}<br/><b>Time:</b> {text.time}<br/><b>Price:</b> {text.fiat.amount} {text.fiat.currency}<br/><b>Fixed Fee:</b> {text.fiat.fee.fixed} {text.fiat.currency}<br/><b>Crypto:</b> {text.crypto.amount} {text.crypto.currency}<br/><b>Rate:</b> 1 {text.crypto.currency} = {text.crypto.rate} {text.fiat.currency}<br/><b>Destination:</b> {text.crypto.destination}<br/><b>UUID:</b> {text.transaction.uuid}<br/><br/><b>Operator:</b> Name, Address, Phone, etc<br/><br/><b>How to proceed:</b><br/><b>1.Please send exactly </b> {text.crypto.amount} {text.crypto.currency} to <br/>{text.crypto.destination}<br/><b>before {text.transaction.expirationTimestamp}.</b>{bmp.paymentrequest}<br/><b>2.Wait a few minutes before your payment is confirmed.</b><br/><b>3.On machine choose REDEEM TICKET.</b><br/><b>4.Scan QR code on this ticket.</b><br/><br/><b>DON'T LOSE THIS REDEEM TICKET!!</b><br/><b>TICKET IS NEEDED FOR CASH WITHDRAWAL!!</b><br/>{bmp.logo}<br/>

email_cashback_ticket_template: this message is sent to a customer to permit a manually-created redemption (REDEEM) transaction. The message includes a REDEEM QR code.

Code Block
{bmp.logo}<b>CASHBACK RECEIPT AND REDEEM TICKET</b><br/><br/><b>TX ID:</b> {text.transaction.id}<br/><b>Time:</b> {text.time}<br/><b>Amount:</b> {text.fiat.amount} {text.fiat.currency}<br/><br/>{qr(cashback)}<br/>How to proceed:<br/>1. Choose REDEEM TICKET on the ATM.<br/>2. Scan the QR code on this ticket.<br/><br/>DON'T LOSE THIS REDEEM TICKET!!<br/>TICKET IS NEEDED FOR CASH WITHDRAWAL!!<br/>{bmp.logo}<br/>

printer_withdrawal_ticket_template: this paper SELL receipt is printed by the BATM after the fiat has been withdrawn by the customer.

Code Block
{bmp.logo}<b>CASH WITHDRAWAL RECEIPT</b><br/><br/><b>TX ID:</b> {text.transaction.id}<br/><b>Related TX:</b> {text.transaction.related.id}<br/><b>Time:</b> {text.time}<br/><b>Amount:</b> {text.fiat.amount} {text.fiat.currency}<br/><b>UUID:</b> {text.transaction.uuid}<br/><br/><b>Operator:</b> Name, Address, Phone, etc<br/><br/><br/>{bmp.logo}<br/>

sell_withdrawal_ready: this SMS communicates that the SELL is ready for customer withdrawal.

Code Block
Cash withdrawal {text.transaction.id} is ready.

sell_invalid_payment: this SMS notifies your customer that the wrong amount has been submitted to the wallet specified in printer_sell_crypto_ticket_template.

Code Block
Invalid payment {text.transaction.id} received.

sell_timed_out: this SMS notifies your customer that your SELL offer has expired, and the payment was not received within the required time limit.

Code Block
Sell offer {text.transaction.id} expired. Don't send the payment.

sell_arriving: this SMS notifies your customer that the coin satisfying the SELL terms has been seen on the network, and is waiting for the required confirmations (next: sell_withdrawal_ready).

Code Block
Transaction {text.transaction.id} arriving, thank you. We will inform you when the cash withdrawal is ready.

...

Field Assignments & Definitions

Field

Description

Applies to:

{text.time}

Transaction time at location.

All

{text.transaction.id}

The RID of the transaction.

All

{text.fiat.amount}

The fiat amount of this transaction.;

All

{text.fiat.currency}

The fiat (USD/EUR/etc) used.

All

{text.crypto.amount}

The amount of coin involved.

All

{text.crypto.currency}

The type of coin (BTC/LTC/etc).

All

{text.crypto.destination}

The wallet presented during the BUY.

BUY

{text.fiat.fee.fixed}

Any flat fee assessed.

All

{text.crypto.rate}

The calculated rate based on the amount involved, your percentages, and fees.

All

{text.privatekey}

The text version of any private key when a hard-copy is chosen by the customer.

BUY

{text.transaction.uuid

This ID links a WITHDRAW to this SELL.

SELL

{text.transaction.expirationTimestamp}

The expiration datetime of the SELL offer.

ALL

{text.transaction.related.id}

The ID of the associated SELL.

WITHDRAW

{text.otp}

The OTP sent to a Customer.

OTP

{bmp.logo}

Your logo from Sprites (or GB).

All

{bmp.paymentrequest}

The QR-coded SELL offer.

SELL

{bmp.address}

A QR-coded wallet address.

BUY

{bmp.privatekey}

A QR-coded private key.

BUY

...

Permitted Fields

Custom String

Permitted Fields

sms_buy_crypto_ticket_template

{text.time}
{text.transaction.id}
{text.fiat.amount}
{text.fiat.currency}
{text.crypto.amount}
{text.crypto.currency}
{text.crypto.destination}
{text.fiat.fee.fixed}
{text.crypto.rate}

email_buy_crypto_ticket_template

{text.time}
{text.transaction.id}
{text.fiat.amount}
{text.fiat.currency}
{text.crypto.amount}
{text.crypto.currency}
{text.crypto.destination}
{text.fiat.fee.fixed}
{text.crypto.rate}
{bmp.logo}

printer_paper_wallet_template

{text.address}
{text.privatekey}
{text.cryptoCurrency}
{bmp.address}
{bmp.privatekey}
{bmp.logo}

printer_buy_crypto_ticket_template

{text.time}
{text.transaction.id}
{text.fiat.amount}
{text.fiat.currency}
{text.crypto.amount}
{text.crypto.currency}
{text.crypto.destination}
{text.fiat.fee.fixed}
{text.crypto.rate}
{bmp.logo}

printer_sell_crypto_ticket_template

{bmp.logo}
{bmp.paymentrequest}
{text.time}
{text.transaction.id}
{text.fiat.amount}
{text.fiat.currency}
{text.crypto.amount}
{text.crypto.currency}
{text.crypto.destination}
{text.transaction.uuid}
{text.fiat.fee.fixed}
{text.transaction.expirationTimestamp}
{text.crypto.rate}

printer_withdrawal_ticket_template

{bmp.logo}
{text.time}
{text.transaction.id}
{text.transaction.related.id}
{text.fiat.amount}
{text.fiat.currency}
{text.transaction.uuid}

printer_pos_crypto_ticket_template

{bmp.logo}
{text.orderid}
{text.totalprice}
{text.tip}
{text.amounttip}
{text.amountpaid}
{text.cashcurrency}
{text.ammountcurrency}

sell_withdrawal_ready

{text.transaction.id}
{text.fiat.amount}
{text.fiat.currency}
{text.crypto.amount}
{text.crypto.currency}
{text.crypto.destination}
{text.fiat.fee.fixed}
{text.crypto.rate}

sell_invalid_payment

sell_timed_out

sell_arriving

...

Special configuration strings:

Info

Separate multiple fields using a space (" ").

Setting

Description

datasaving

Decreases the “ping” frequency

  • reduces data usage & increases responsiveness

paperwalletonly

Force paper wallet usage (required in certain jurisdictions.

btc_reject_bc1

Rejects customer SegWit wallet addresses ("bc1").

ltc_reject_ltc1

Rejects customer wallet addresses beginning with ("ltc1").

-Xbitflyer=1

Enables BitFlyer

rebootIntervalMinutes=

Changes the "no connection" timeout.

  • Example: rebootIntervalMinutes=10  sets a 10 minute timeout

checkpin=abcd

Terminal will ask for numerical PIN before purchase.

  • Minimum PIN length = 4

  • Example: checkpin=4

alarm_pin=abcd

Assign a numerical PIN for disarming the alarm.

  • Example: alarm_pin=12345

experimental

(deprecated) Implements the new (experimental) Terminal UI.

legacy

Implements the old (legacy) Terminal UI.