Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/payneteasy/pos-proxy
Connect to a POS terminal via simple API
https://github.com/payneteasy/pos-proxy
java miura mpos pax pos spire spm2 verifone vx820
Last synced: 6 days ago
JSON representation
Connect to a POS terminal via simple API
- Host: GitHub
- URL: https://github.com/payneteasy/pos-proxy
- Owner: payneteasy
- Created: 2018-06-09T10:58:23.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-07-05T23:05:56.000Z (over 1 year ago)
- Last Synced: 2024-04-16T07:50:22.094Z (9 months ago)
- Topics: java, miura, mpos, pax, pos, spire, spm2, verifone, vx820
- Language: Java
- Size: 2.71 MB
- Stars: 16
- Watchers: 5
- Forks: 3
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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:
[](https://youtu.be/_A6wEbFHIOI)
## How to generate a client code
* Install swagger-codegen from https://github.com/swagger-api/swagger-codegen
* Run swagger-codegen with your language
```bash
swagger-codegen generate -i http://0.0.0.0:8081/pos-proxy/swagger-ui/pos-proxy.json -l java
```
## Run it from docker
### amd64
```bash
docker run -it -p 8081:8081/tcp payneteasy/pos-proxy:amd64
```
### arm 64 v8 (Raspberry PI 3)
```bash
docker run -it -p 8081:8081/tcp payneteasy/pos-proxy:arm64v8
```
### arm 32 v7 (Raspberry PI 1/2)
```bash
docker run -it -p 8081:8081/tcp payneteasy/pos-proxy:arm32v7
```
## Requirements
* Java 1.8 (Oracle or OpenJDK)
## How to build and run
```bash
./mvnw clean package
cd server/target && java -jar server-1.3-SNAPSHOT-jar-with-dependencies.jar
```
## How to run from release page
```bash
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:
```bash
export HTTP_SERVER_PORT=9090
java -jar server-1.3-SNAPSHOT-jar-with-dependencies.jar
```
Via -D option:
```bash
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.
```bash
socat -d -d -v -x tcp4-listen:27015,reuseaddr,fork file:/dev/ttyACM0,nonblock,echo=0,raw
```