Skip to content

Latest commit

 

History

History
92 lines (61 loc) · 2.26 KB

README.md

File metadata and controls

92 lines (61 loc) · 2.26 KB
Raw

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.

Sequence diagram

  • 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

Please see the video below:

Swagger UI

How to generate a client code

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