Notification Policies

Notification Policies

Staying on top of your business is important. You must setup notifications to receive timely feedback. These should be setup carefully to ensure an optimal customer experience.

  1. Create a common Notification Policy,

  2. assign it to every Terminal, and

  3. stay notified!

Commonly used notifications:

  • Stacker Manipulation (is your cash being touched?)

  • Customer Enrolled (is a customer waiting for your approval?)

  • Transaction Failed (check your wallets / exchanges)


Notification Policy Dashboard

Quickly view a summary of the existing policies with the Dashboard, and test them with but a single click.

image-20260710-190015.png

Name

The descriptive name of the Notification Policy.

Organization

Which Organization “owns” this setting.

Rules

A summary listing of the notification rules that have been configured for the identified Notification Policy.

Actions: View

View the Notification Policy.

Actions: Duplicate

The easy way to replicate an existing policy for modification.

Actions: Delete

Remove the Policy.

Actions: Test Sending

Test it! Make sure it works as expected.

How to create a new Policy: Notification Policies


Notification Policy Details

image-20260710-191337.png

Name*: a descriptive name for the Notification Policy.

Organization*: (admin only) select the affected Organization.

image-20260710-191443.png

List of Rules: a single Notification Policy may have one, or many Rules.

  • A Rule is a trigger, an event that you select to claim your attention.

image-20260710-191651.png
  • See Notification Policy Rules (below) for details about each Rule.

Actions: what occurs after an event is triggered?

image-20260710-191824.png

Terminal Filter selects Terminal groups using tags.

Available Actions:

Action

Notes

Action

Notes

Send email

 

Send SMS

Always use a fully qualified target phone number

  • ( e.g. in the US: +19415551234 )

Send Telegram message

See: Telegram Notifications

Voice call

Charges will apply.

Call Webhook

For systems using registered extensions ONLY.

  • Retry times (after failure) are: 30s, 60s, 300s, 900s, 3600s

Send approval link by SMS

Customer Enrolled Rule only

Send approval link by email

Customer Enrolled Rule only

Send approval link by Telegram

Customer Enrolled Rule only

See: Telegram Notifications

Action Parameter: enter the actual phone number, email, or Telegram ID of the notification recipient.

image-20260710-192727.png

 

Delete any unnecessary or obsolete Actions.

  • You must have at least one Action per Rule.

image-20260710-192347.png

 

Add an additional Action to increase the number of notifications (or the recipients) as desired.

image-20260710-192820.png

 

Delete the Rule.

  • You must have at least one Rule per Policy.


Create a new Notification Policy

A new policy will be created, with an empty Name, Organization, and no Rules.

  1. Set the Name.

  2. Assign it to a relevant Organization.

  3. Create a new Rule: image-20260710-193912.png

  4. Set the appropriate Rule trigger/condition.

  5. Set the Parameters and Filters (if any).

  6. Set the Action and Action Parameters.

  7. Save the Notification Policy: image-20260710-193754.png


Notification Policy Rules

Rule

Parameters (bold = required)

Notes

Rule

Parameters (bold = required)

Notes

Transaction Success
  • Fiat

  • Amount

It’s good to know your BATM is doing what it’s supposed to do!

Transaction Failed
  • Fiat

  • Amount

Any Buy, Sell, or Withdraw transaction “fails” when it cannot be processed. There are a few reasons that this can occur; invalid data (e.g. bad configuration), amount is not calculated due to rate source unavailability, wallet or exchange has insufficient coin or fiat.

Wallet Crypto Balance Low
  • Coin

  • Amount

Restock your hot wallet!

Exchange Crypto Balance Low
  • Coin

  • Amount

Increase the available coin at your Exchange.

Cash High
  • Fiat

  • Amount “High”

more cash = more risk; clear it out regularly

Customer Enrolled

 

AML/KYC Event: a customer has submitted his/her identity documents & is awaiting your approval.

Store Order Prepared

n/a

Currently unsupported.

Store Order Paid

n/a

Currently unsupported.

POS Order Prepared

n/a

Currently unsupported.

POS Order Paid

n/a

Currently unsupported.

Terminal Offline X Minutes
  • time offline

Terminal has been offline for the [parameters] time.

  • default = 2 minutes

Terminal Online Again

 

Terminal has regained a connection to CAS.

Stacker Manipulation

 

Stacker/cashbox has been pulled or inserted.

Terminal Errors

 

Terminal is “out of order” with any of these problems:

  • SERVER IS NOT REACHABLE,

  • ACCEPTOR STACKER OUT,

  • ACCEPTOR STACKER FULL,

  • ERROR_ACCEPTOR_OTHER_ERROR,

  • NO CAMERA,

  • PAPER MISSING,

  • ACCEPTOR JAM ERROR,

  • CARD MISSING (NFC CARD)

Transaction Cash Limit Reached

Specific Cash Limit *

When supplied, confines the notification(s) to only that specific limit period (per day, per week, etc).

Your customer has reached their upper limit permitted for that Identity.

Cash Low
  • Fiat

  • Amount “Low”

Dispensers are getting low on total fiat on hand; this may result in lost “Sells”.

Cashbox Banknote Count High
  • Fiat

  • Amount “High”

 

Cashbox Banknote Count Low
  • Fiat

  • Amount “Low”

 

Invalid Payment Received

 

You have a SELL problem. Your customer sent you a payment that wasn’t quite right.

Balance Cleared

 

A transaction was started but not finished. After a 10 minute delay, the BATM automatically auto-completes the transaction & “clears” the balance to permit another transaction.

Transaction Supply Limit Reached

 

Your customer has reached their upper limit permitted for that Identity.

Rate Source Not Available



Your Rate Source is offline.

  • Transactions are blocked until resolved.

Short Counters Cleared



Cash has been cleared from the machine by an attendant.

Watchlist Scan Ban

 

A transaction score violation has occurred.

Photo Printed

 

for use with Photokiosks only

  • Currently unsupported.

Exchange Fiat Balance Low
  • Fiat

  • Amount

Increase the available funds at your Exchange.

Stacker Out For X minutes
  • time threshold

Used when the Stacker Manipulation rule has driven you absolutely insane.

Door Sensor

 

The BATM door has been opened.

Stacker Out Outside Opening Hours

 

Relies on:

Transaction scoring provider flagged a transaction or an address

 

Transaction Scoring trigger.

The transaction was blocked.

QR-Code sticker detected

 

The security feature must first be enabled.

Alarm Status

 

For use with BATM alarms.

Alarm Triggered

 

For use with BATM alarms.

Alarm PIN Accepted

 

For use with BATM alarms.

Alarm PIN Not Accepted

 

For use with BATM alarms.

Transaction scoring provider flagged a transaction or an address as suspicious but not with a score high enough to be blocked

 

Transaction Scoring trigger.

The transaction was permitted.

Terminal rejected due to wrong IP address

 

When IP Whitelist Enabled is active.

Dispenser Cassette Manipulation

 

Fires when a dispenser cassette is ejected.

Acceptor acceptance problem

 

Fires when the acceptor rejects a banknote 3 consecutive times.

Cashback Created

 

A cashback has been sent to a customer.

Cash Collection Missed

 

A scheduled cash collection didn’t occur.

Dispenser Initialization Failed

 

Triggered when a dispenser problem is detected during dispenser activity.

Transaction attempts reached

 

Triggered after a customer initiates (then abandons) a transaction - 3 consecutive times.

Machine inactivity

 

Your BATM hasn’t been used in 2 days!

Possible Fraud

 

The BATM senses that a door is open and a transaction was attempted.

Blacklisted Address Used

 

A blacklisted wallet address was presented at the BATM.

Watched identity performed transaction

 

An Identity (marked to be “watched”) conducted a transaction.

Recycler Cash Low
  • Fiat

  • Amount “Low”

Your Recycler drums are low on outgoing (dispensing) cash.

Terminal Recovered from Error

 

If a BATM was offline for any reason, this notification is sent when it recovers.

Transaction Queued

 

When using input or output queues, this notification is sent when any transaction enters those queues.

See: https://generalbytes.atlassian.net/wiki/x/A4DY2Q

Terminal IP Whitelist Automatically Updated

 

When using this Terminal option, the notification will be sent after the whitelist is updated.

https://generalbytes.atlassian.net/wiki/x/AYDUQw

Terminal Certificate Fingerprint Mismatch

 

This warning is sent when a BATM presents an unexpected certificate.

https://generalbytes.atlassian.net/wiki/x/iQCPNw

Cashbox Empty Error When Dispensing

 

A dispenser cassette is empty.

Copyright © 2020-2026 General Bytes USA LLC