Payment Device Controller Web Bridge

How To Setup local Payment Terminals via Payment Device Controller Web Bridge (PDC Bridge)

PDC Web Bridge is a Payment Device Addressing Service that allows a Web Based Point of Sale to control locally attached Payment Devices via C9PG Addressing Scheme, such as Gateway Merchant ID (GMID) and Gateway Terminal ID (GTID), instead of local IP.

Local Payment Device Controller or Local PDC is a locally installed payment device driver and control service. It is most useful, when Store-and-Forward functionality is desired and installation of local software is practical. 

Store-and-Forward allows temporary storage of payment information in the event of internet outage. Normally, installing a Local PDC is a good trade off, since this functionality is built into the Local PDC. 

The chain of command, when using PDC Bridge, is as follows:

  1. Point of Sale (POS) communicates with PDC Bridge, hosted on C9PG Servers
  2. PDC Bridge communicates with the Local PDC
  3. Local PDC communicated with the Payment Terminal
  4. Local PDC communicates with Cloud9 Payment Gateway (C9PG)
  5. C9PG communicates with Processors/Clearing Houses.

In this way, POS does not need to exercise low level payment terminal level control, using specific API of the payment terminal manufacturer. It is an elegant solution to abstract the complexity of direct payment terminal integration

Table of Contents

JSON API for PDC Bridge

Note: request target is slightly different.

 
Example:
{
     “GMID”: “2001008149”,
     “GTID”: “GT3010023905”,
     “GMPW”: “GMPW3010026163”,
    “TransType”:”Sale”,
    “MainAmt”:”100″,
    “EntryMode”:”Manual”,
    “AccountNum”:”4111111111111111″,
    “ExpDate”:”1223″,
    “CheckDuplicate”:”Y”,
    “Medium”:”Credit”,
    “//NeedSwipeCard”:”Y”
}
 

Local PC Payment Device Setup

The following describes the procedure for local Payment Device Controller install that needs to be done for EVERY local PC/Tablet/mobile device that controls Payment Devices.

Setup Payment Device Firmware

If you have not done so, follow Payment Device Firmware Setup, first.
 

Install Payment Device Controller

  1. Download the PDC for the correct operating system from the Downloads Portal.
  2. Unzip the install file as necessary and install as normal for your operating system (e.g on Windows, run the EXE file)

Payment Device Controller Service

After the installation, PDC service should run and be visible in the bottom right of your Windows toolbar.

You can right click on the PDC Service to show the Settings and Tools menus
 

PDC Setup

Open the PDC Console by typing PDC into the toolbar search space
You can add it to the Start or the toolbar for convenience from here. 
Open the PDC Console by clicking on it. It will start minimized, so click on the toolbar icon to restore it.
 
 

PDC Communication Settings

Click Settings->Cloud9WebSocket Configuration to enter the PDC Bridge Connection Setup

Payment Device Controller Bridge Setup

RESTART PDC after Enabling Cloud9WebSocket

You will have to repeat this setup for every local PC node that controls the Payment Devices.

Terminal Configuration

Click Settings->Terminal Configuration menu to enter Terminal Setup
 
USB or Serial or Bluetooth Setup

Ethernet Setup

Local Payment Device Controller Ethernet Setup

To determine the Payment Device IP and Port, please refer to the Payment Device Firmware Setup Guide.

This information is needed by Local PDC to be able to communicate with the Payment Device via WiFi or Ethernet.

Click OK when done.

Store & Forward Offline Processing

To enable Store & Forward, select Settings -> Store & Forward Configuration
Payment Device Controller Store and Forward Enable

See Store & Forward Guide for more info on usage.

Scroll to Top