Migrating from acceptSDK

Main Differences

If you are coming from the old acceptSDK, you will find that many things are now different on the ePOS SDK.

There is no backend configuration to fill anymore: only an environment parameter and some credentials are needed to initialise the SDK, as seen in this section.

Another important difference is that the ePOS SDK has been structured into a set of "managers" that take care of the different features, such as terminal management, print management, customer management, etc. You will interact with the managers using the ePOS instance as bridge.

Another thing to consider is that, architecturally, the possibilities on ePOS go beyond of those in accept, thanks to the multiple levels of hierarchy. If previously you were limited to users and merchants, now you can have partners, separate shops and different roles and permissions for all users. If in accept only simple payments existed, now we use Sales objects, which consist of one or more payments, interconnected with each other.

The Bad news

Even though some principles from the old acceptSDK still remain (terminals need to be found, and terminal updates need to be checked and applied, before the hardware can be used), all the differences and new additions make impossible for us to create a golden rule for your transition between SDKs. In other words: we suggest you start from scratch, anew, to avoid complications. This is so because, internally, a very different online API is used and the scope of the SDK is bigger and more ambitious.

The Good news

To make your learning easier, we have created a set of Examples as tests that will trigger the complete flows, teaching you how to use the most relevant features of ePOS. There is no UI demo this time, but integration test that will bring you from the beginning to the end of payments, search requests, printing, and other actions. This developer portal has been also prepared to guide you during the development, answering any question that may arise.

We created the ePOS SDK to offer a more robust and modern solution for all the POS needs you may have, including new catalogue and cash management features, multi-tender and authorisation/capture payments, as well as new printing and scanner hardware. But if something remain unclear or you want to do a proposal, do not hesitate and contact us through our public repository.