pax-ecr-on-device

A demo ECR on Device Android application designed to run on the PAX family of payment terminals.

Getting Started

To run this application, you will need:

• A compatible payment terminal
• A version of the payment application that supports receiving NEXO-retailer messages via Intent
• The ECR on Device feature enabled via the dev-menu in the payment application

PayEx developers can find the necessary version of the payment application in the pax-payment-app repository on the branch swb-develop. Partners may download a packaged version via the TMS, or request one from customer service agent.

Usage

Upon launching the ECR on Device application, you will be prompted to configure the app. Enter the POI-ID and the currency associated with that POI. If you are debugging, consider enabling the Response-screen flag to view responses from the terminal.

To verify that everything is functioning correctly, you can:

• Send a login request
• Access the payment application from the footer menu

Restart the terminal if the application stalls or becomes unresponsive.

Contributing

We welcome contributions to enhance the ECR on Device application. To contribute, please follow these steps:

1. Fork the Repository
2. Clone the Repository
3. Create a Branch
4. Implement your changes and ensure they are well-tested.
5. Commit your changes with clear and descriptive commit messages.
6. Push your changes to your forked repository
7. Open a pull request on the original repository, detailing your changes and any issues they address.

Please ensure your contributions adhere to the project's coding standards and include appropriate documentation. For significant changes, consider discussing them with the repository maintainers before starting work.