pos-proxy
How it works
POS Proxy is a web server that redirects json requests to a POS terminal connected via USB. You can also use this example to see how to integrate the Payneteasy mPOS SDK to your java application.
- Client - a client code to start a payment
- POS Proxy - this application
- gate.payneteasy.com - Our authorisation server
- Merchant site - we can make a callback to your server with a final order status
Swagger UI
- Run the application
- Go to the http://0.0.0.0:8081/pos-proxy/swagger-ui
Please see the video below:
How to generate a client code
- Install swagger-codegen from https://github.com/swagger-api/swagger-codegen
- Run swagger-codegen with your language
swagger-codegen generate -i http://0.0.0.0:8081/pos-proxy/swagger-ui/pos-proxy.json -l java
Run it from docker
amd64
docker run -it -p 8081:8081/tcp payneteasy/pos-proxy:amd64
arm 64 v8 (Raspberry PI 3)
docker run -it -p 8081:8081/tcp payneteasy/pos-proxy:arm64v8
arm 32 v7 (Raspberry PI 1/2)
docker run -it -p 8081:8081/tcp payneteasy/pos-proxy:arm32v7
Requirements
- Java 1.8 (Oracle or OpenJDK)
How to build and run
./mvnw clean package
cd server/target && java -jar server-1.3-SNAPSHOT-jar-with-dependencies.jar
How to run from release page
wget https://github.com/payneteasy/pos-proxy/releases/download/1.3.0/pos-proxy-1.3.0.jar
java -jar server-1.0-1-SNAPSHOT-jar-with-dependencies.jar
How to change a listening port
You can change the listening port by pass this via -D option or via environment variable.
Via environment variable:
export HTTP_SERVER_PORT=9090
java -jar server-1.3-SNAPSHOT-jar-with-dependencies.jar
Via -D option:
java -DHTTP_SERVER_PORT=9090 -jar server-1.3-SNAPSHOT-jar-with-dependencies.jar
How to connect to a Verifone terminal via USB cable
Run socat program to listen 27016 tcp port and redirects all tcp packets to a tty device.
socat -d -d -v -x tcp4-listen:27015,reuseaddr,fork file:/dev/ttyACM0,nonblock,echo=0,raw