New varieties of paper currencies are constantly issued. At some point, you will need to update the firmware in your bill acceptor to recognize these new banknotes.

This article describes updating the acceptor billset.

  • Create a Support ticket if you feel the acceptor needs to be reprogrammed - that procedure is not described here & is deliberately undocumented.


RECYCLER? Read this:

Always empty recyclers before upgrading the firmware!

Recyclers can only store one type of currency (i.e. USD, CAD, or EUR etc).

The primary currency is the only currency saved for dispensing; so if you have a USDCADEUR combination, only USD can be dispensed (while all can be accepted). If you’d prefer to dispense CAD, then you’d have to install a billset that identifies CAD as the primary currency (e.g. CADUSD). Not all combinations are possible. Ask Support if any particular combination is available.

THE Y1530 FIRMWARE WILL BRICK YOUR HEAD. DON’T DO IT!


1. Determine the billset variety.

You’ll need to enter the billset name precisely. It varies by acceptor model & manufacturer.

If you’re uncertain of the billset name, please Create a new Support Ticket and:

We will reply to your support ticket notifying you of the billset “flavor”. All questions (above) must be ascertained before we can prepare the download, so please provide all requested details in advance.


2. After you’ve determined the billset name:

Update the Terminal’s acceptor billset from the CAS action menu.

1. Click “Acceptor Update” from Terminal: ACTIONS

2. Enter the name of the acceptor BILLSET firmware:

3. Click UPGRADE ACCEPTOR.

The maintenance screen will appear on the BATM, and it will download the billset firmware.

4. You’re done. The billset should now accept the specified banknotes.


Alternative method (manual)

Billset installation is performed in 2 distinct steps. This method may be preferred where a large number of BATMs are deployed and an automated process is required.

Step 1: download the billset firmware.

In this example:

  • BT123456 will represent the actual serial number of your BATM.

  • FWNAME will represent the actual firmware package to be installed. To get correct FWNAME value please contact GB tech support. Please mention whether you have a recycler or bill acceptor.

  1. Determine the required billset name (as described above).

  2. Login to your CAS server CLI (Command Line Interface).

  3. Download the latest firmware to your server:

sudo /batm/batm-manage acceptor FWNAME BT123456

Next: apply the upgrade at the BATM (detailed below).

Step 2: install the billset at the BATM.

The acceptor firmware can only be updated at the location itself. This is a security feature, preventing a malicious actor from arbitrarily uploading hacked firmware to your BATM.

Enter the administration menu on your BATM:

Press the "ACCEPTOR UPDATE" button

You should now be able to accept the desired billsets at each updated BATM.


Confirm the upgrade was accepted by looking at either:

The BATM Administration screen:

The Terminal acceptor status in CAS:


Which acceptor do I have?

Two different types of acceptors may be installed: blue (UBA) or yellow (MEI).

UBA Acceptors

Integrated in older models of BATMs (only).

UBA (blue) billsets will start with a "B", i.e. B1EURUSD

MEI Acceptors

Newer BATMs (from 2017 on) use MEI (yellow).

MEI (yellow) billsets will begin with a "Y", i.e. Y1EURUSD


Related articles:

The content by label feature displays related articles automatically, based on labels you choose. To edit options for this feature, select the placeholder below and tap the pencil icon.

Related issues