POS Globalpay Terminal Payment DocumentationPOS Globalpay Terminal Payment Documentation
Buy Now
View Demo
  • Getting Started

    • Overview
    • Key Features
    • Installation
  • Configuration

    • Admin Settings
    • Node Server & SSL
  • Hardware & App

    • Mobile Terminal App
    • UPA Java Emulator
  • Operations

    • Checkout Workflow
    • Order Metadata
  • Support

    • Troubleshooting
    • FAQ
Core POS System
Buy Now
View Demo
  • Getting Started

    • Overview
    • Key Features
    • Installation
  • Configuration

    • Admin Settings
    • Node Server & SSL
  • Hardware & App

    • Mobile Terminal App
    • UPA Java Emulator
  • Operations

    • Checkout Workflow
    • Order Metadata
  • Support

    • Troubleshooting
    • FAQ
Core POS System
  • Getting Started

    • POS Globalpay Terminal Payment Documentation
    • System Overview
    • Detailed Features List
    • Plugin Installation
  • Setup & Configuration

    • Admin Gateway Configuration
    • Node.js Socket Server & Security Setup
  • Hardware & Emulator Setup

    • Globalpay Android Terminal App Setup
    • UPA Java Terminal Emulator Setup
  • Store Operations & Checkout

    • POS Checkout Workflow & Interactive Prompts
    • Order Fulfillment & Metadata Audit Logging
  • Help & FAQ

    • Troubleshooting Guide
    • Frequently Asked Questions (FAQ)

Detailed Features List

1. POS Globalpay Payment Gateway Integration

  • Native Gateway Registration: Registers a custom WooCommerce payment gateway (POS Global Payment Terminal Gateway).
  • Dynamic Synchronization: Syncs payment title and description automatically with the WooCommerce POS custom payments table.
  • POS Checkout Integration: Seamlessly presents as a payment method option on the POS cashier checkout page.

Administration Settings

  • Enable/Disable: Toggle gateway availability on the POS cashier checkout page.
  • Default Gateway: Option to make Globalpay Terminal the default pre-selected payment option.
  • Title: Customize the customer- and cashier-facing payment title.
  • Description: Customize explanatory description text shown during checkout.
  • Test Mode: Switch between Sandbox/Test environment and Production mode.
  • Merchant ID: Securely input your Globalpay merchant credential.
  • Settings Link: Direct link on the WordPress Plugins page for fast access.

2. Device Communication & Node.js Socket Server

  • WebSocket Bridge: Mounts a custom Node.js socket server script into the POS server registry via integration hooks.
  • Low-Latency Transmission: Instant data transfer to initiate transactions, collect card details, and receive success/error callbacks.
  • Node Server Configuration:
    • Node Server Address (Domain / IP)
    • Node Server PORT
    • Server HTTPS Status (SSL toggle)
    • Connection Retry Timeout (ms)
    • Start/Stop Server controls directly from admin dashboard
    • SSL Certificate Key & SSL Private Key input
    • Real-time environment variable health checkmarks (✓)

3. Authentication and Security

  • Bearer JWT Token Authentication: Authenticates cashier sessions via secure JWT tokens stored in user-specific cookies.
  • Role-Based Access Control: Restricts token generation and socket access strictly to users with the Point of Sale cashier role.
  • REST API Route: Protected custom POST route (/wp-json/pos-globalpay/...) for settings retrieval.
  • AJAX Nonce Verification: Protects state changes against CSRF attacks.

4. Order Fulfillment & Metadata Logging

  • Pending Payment State: Sets order status to Pending Payment during active swipe/insert to prevent double-deduction.
  • Automatic Completion: Upgrades order status to Completed immediately upon terminal approval.
  • Error Notices: Captures declines and reader disconnections and displays localized error notices to cashiers.
  • Audit Metadata Saved:
    • Transaction ID
    • Reference Number
    • Response ID
    • ECR ID
    • Platform
    • Total Amount

5. E-Commerce Compatibility

  • WooCommerce Blocks: Fully registered with WooCommerce payment method registry for block checkout compatibility.
  • HPOS Compatibility: Built for High-Performance Order Storage database schema as well as legacy wp_postmeta.
Prev
System Overview
Next
Plugin Installation