User Guide for PC POS Terminal Integration via USB Connectivity v1.0.0

1. Get ready before integration

1.1 POS Terminal and FOMO App

1. Obtain the POS terminal provided by FOMO, and make sure the POS has FOMO Pay App installed.
2. Turn on the POS terminal. Go to Settings -> Display -> Screen Timeout. Make sure the screen timeout has been set to Never.

1.2 Computer and accessories

1. USB A to USB C cable.

Figure 1. Sample of USB A to USB C cable

2. Requirement of the computer operation system:

3. Make sure you have the local admin permission to install the .exe files provided by FOMO.

1.3 Installation Package

2. Setup

1. Install Zadig and pos-usb-client.exe on your computer.
2. Turn on POS terminal. Connect the POS terminal to the computer via USB cable. Make sure the screen is always on.
3. Run Zadig.
   1. Select tab of Options -> List All Devices -> I23M01_GL.

• Input field should be auto populated.
• Notes: The prefilled value may vary for different device models. For more details, please contact FOMO staff to confirm.

Figure 2. Screen capture of Replace Driver in Zadig

• Make sure the driver will be updated to libusb-win32(v1.4.0.0). Click the button of "Replace Driver".
• Open Device Manager -> USB Ports.
  1. Uninstall device for current device I23M01_GL.
  2. Disconnect the USB cable to the POS Terminal.
  3. Reconnect the POS Terminal.

Notes: 5b and 5c are necessary steps to reflect the correct driver name in Device Manager.

Figure 3. Screen capture of Device Manager after step 5c

• Open FOMO Pay App on POS Terminal. Go to the home page (i.e. Enter amount page).
• Open Command Prompt on the computer. Copy and paste the path of pos-usb-client.exe (e.g. sample path circled in red), then type in the following instruction and press the Enter button on the keyboard. The listener should be enabled.

connect --vid 0e8d --pid 2008 --listen localhost:8080

Figure 4. Screen capture of Command Prompt - Enable listener

• If the POS terminal prompts a message asking for authorizing the PC to control POS, select the option of "Always allowed" and confirm the authorization.

3. Integration with POS Terminal

You can find the APIs at https://nsb26n6ul5.apidog.io/.

Please contact FOMO staff for the password.

3.1 Create payment

POST /CreatePayment

To instruct terminal into payment mode..

Request

Response

curl -X POST "http://localhost:8080/CreatePayment" \  -H "x-api-version: v1" \  -H "Content-Type: application/json" \  -d '{    "amount": "1.00",    "retrieval_reference_number": "invoice-123456789",    "condition_code": "82"  }'

{
  "success": true,
  "message": "Create payment command processed",
  "retrieval_reference_number": "invoice-123456789",
  "condition_code": "82"
}

Appendix - Table 1 – Condition Code for Create payment, Query payment

If any payment method is not listed in this form, please contact FOMO staff.

3.2 Cancel payment

POST /CancelPayment

To instruct terminal into standby mode.

Please be reminded that in progress payment will not be cancelled automatically. If you need to void a payment, please use /VoidPayment.

Request

Response

curl -X POST "http://localhost:8080/CancelPayment" \  -H "x-api-version: v1" \  -H "Content-Type: application/json" \  -d '{}'

{
  "success": true,
  "message": "Cancel payment command processed"
}

3.3 Query payment

POST /QueryPayment

To query a payment status.

Request

Response

curl -X POST "http://localhost:8080/QueryPayment" \  -H "x-api-version: v1" \  -H "Content-Type: application/json" \  -d '{    "retrieval_reference_number": "invoice-123456789"  }'

{
  "success": true,
  "message": "Query payment command processed",
  "retrieval_reference_number": "invoice-123456789",
  "condition_code": "82",
  "transaction_id": "100100090250128303091105",
  "transaction_status": "00"
}

Appendix - Table 2 – Response Code for Query payment Response

3.4 Void payment

POST /VoidPayment

To void a payment.

Request

Response

curl -X POST "http://localhost:8080/VoidPayment" \  -H "x-api-version: v1" \  -H "Content-Type: application/json" \  -d '{    "retrieval_reference_number": "invoice-123456789"  }'

{
  "success": true,
  "message": "Void payment command processed"
}

3.5 Submit batch

POST /SubmitBatch

To submit in a batch.

Request

Response

curl -X POST "http://localhost:8080/SubmitBatch" \  -H "x-api-version: v1" \  -H "Content-Type: application/json" \  -d '{}'

{
  "success": true,
  "message": "Submit batch command processed"
}