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