API & SDK developers

CASHMAG API & SDK for cash recycler

Integrate 10 years of cashing experience in 5 lines of code

Since 2008, cash recycler interfacing has proven how complicated, long and costly it could be to interface cash recyclers of different brands and models, in a simple, powerful and mostly reliable way.

Unfortunately, there isn’t any norm such as OPOS for these devices to be able to exchange in standard terms. We have decided to write and make available our CASHMAG API & SDK for Cash Recycler.

As you can see on the following diagram, this API & SDK is the one we use with CASHMAG Connect for our cashing softwares (GOMC-POS & CASHMAG ANDROID).

API CASH RECLYCLER


A multi-platform API & SDK

API & SDK available for various OS

windows

  • .NET with C# and Visual basic languages, intended to softwares written with this Microsoft development environment
  • Active X for languages used on Windows, such as WinDev, Delphi, PowerBuilder, etc
  • JAVA

android

JAVA

ios

Callups in Web Socket

linux

Callups in Web Socket

Need additional information ?
Whether you are developers, editors, builders, we will respond quickly and always with pleasure.

Contact us


Several CASH management compatible devices

We have interfaced several modules from different makers. You don’t have to choose while developing, since we have made all calls compatible. You just have to implement our API & SDK and choose the model you want to interface, currently available or in our next developments. Your development work needs to be performed only once !

Simultaneously managing several devices

Once development completed using our API & SDK, when deploying, you can choose to have 1 or several modules connected to onto your software. This will allow your customer to have a greater storage capacity, modules for different currencies, or a full failure tolerance system.

This remains completely transparent on your code writing. This feature is directly managed in our API & SDK!

Share 1 cash recycler with several programs

On 1 cash recycler from several programs. In the event of simultaneous cashing on different POS, the transaction is queued on the first request, putting the second POS on hold.

As soon as the first transaction is completed, this automatically releases the second one.

multiposte

An API & SDK easy to integrate to your software

  • You can choose to only manage the cashing part. There is then only one function to integrate: Paytransaction. The callup of this sole function allows to make both payment and cash back with speed and reliability with all cash recycler modules. Integration is as simple. We provide code examples for different available languages, that you just have to copy-paste to the right place, in your source code.

ANDROID Code

private void payTransaction() {
       
            Thread thread = new Thread() {
                @Override
                public void run() {
                    try {

                        // Creating an ArrayList of String
                        ArrayList transaction_deposits;
                        ArrayList transaction_dispensed;                                                            

                        //payTransaction
                        RequestStatus statusPayTransaction = new CashRecycler().payTransaction(
                                new BigDecimal(findViewById(R.id.payTrasactionInput).getText().toString()),             // Amount
                                "EUR"                                                                                   // Currency
                        );

                        if (! statusPayTransaction.isValid()) {                                              

                            //Show rest to dispense
                            BigDecimal balance = (BigDecimal) statusPayTransaction.getResult()
                                    .getFieldValues()
                                    .get(PayTransaction.TRANSACTION_AMOUNT_BALANCE.getId());

                            updateSubTitle("Can't pay : " + statusPayTransaction.getErrorMessage() + "\n" + "Rest to dispense: " + balance);
                        }
                    } catch (InterruptedException | InstantiationException | IllegalAccessException | ServerException exception) {
                        updateSubTitle(" exception : " + exception.getMessage());
                    }
                }
            };

            thread.start();
            } 
  • Other admin, stock and flow management functions are accessible through a provided program. You can choose a full implementation which will grant you access to all high level functions of the API & SDK in order to integrate them to your software, enabling total control and user-friendliness integrity. You can access all admin functions directly from your soft.

Smart change back system integrated to the API & SDK

In general, smart change back is simple, in « greedy » mode. In other words, return as few notes and coins as possible. This method, comfortable for the customer, is often a hassle for the shop-keeper. Indeed, the latter ends up with denomination surplus and deficit, forcing him to make as many trips to the bank.

Our way to return change (as a good shop-keeper would do), facilitates change back for high-stock denominations which then naturally exhaust, while saving on low-stock denominations, which then fill up naturally.

Learn more

This API & SDK makes cash recyclers more reliable

Reliability is the critical point on this type of device. Indeed, when you install a cash recycler in a shop, it gains control over cash registers, and a technical failure then jams all cash registers, which is very upsetting and forces the staff to switch to manual mode. This is the most negative point for all equipped business owners. And despite technical progress achieved on such devices, a technical failure cannot be prevented, often caused by simple paper jam. As for bank notes, their very poor condition may cause them to jam the note module (it makes perfect sense as a copy machine gets jams the same way even with brand new paper).

Coins can also be damaged, causing jamming due to the tightness typical to coin modules, necessary to reject counterfeit. It should also be acknowledged that staff rarely take care of the equipment at their disposal, even more when the owner purchased such devices because of « shrinkage » issues. In this case, the device keeps the company’s money safe from its employees.

As you can see, there are many reasons for these devices’ technical failures, which in the end, is only as logical as it is predictable. Such failures can therefore not be avoided. We thus integrated them into our API & SDK so their consequences may be as little damaging as possible to their users. It is in fact our main distinction from many other implementations : failure management !

We are able to « inhibit » a specific note recycler or coin hopper, so the rest of the device doesn’t get blocked and keeps working. This ability is made possible by our in-house developers, while the manufacturer doesn’t have this feature implemented to his specifics.

It is critical for us to come up with solutions that allow uninterrupted activity, even in the event of a subset failure, so the cash recycler and cashing operations do not stop. All these features are natively available on our API & SDK. Use it in your development to directly benefit from its possibilities, as it goes for all our softwares : effortless!

Do not hesitate anymore, contact us to submit your projects, whether you are a developer, an editor, a manufacturer, we will always answer shortly with the same pleasure.

Contact us


CASHMAG 5R

  • Secure rear access
  • Automatically rejects counterfeit notes and coins
  • Compatible with all available softwares
cash recyclers CASHMAG 5R

CASHMAG 5K

  • easyShare and innovative
  • Automatically rejects counterfeit notes and coins
  • Compatible with all available softwares
CASHMAG 5K

CASHMAG 1F

  • THE compact cash recycler, both reliable & fast.
  • Designed in two separate modules
  • Compatible all available softwares
cash recycler CASHMAG 1F

CASHMAG HYBRID

  • Installation without any modification
  • Automatically rejects counterfeit notes and coins
  • Compatible with all available softwares
Cash recycler CASHMAG HYBRID

CASHMAG automatic Desktop recycler

CASHMAG DESKTOP

  • The cash recycler to lay!
  • Automatically rejects counterfeit notes and coins
  • Compatible with all available softwares