Customer Present Cloud API

The Customer Present Cloud API (CPCA) enables OS-agnostic integration with Lane/Series countertop terminals via a simple REST API. No SDK required — works with any programming language that can make HTTPS requests.

Base URL

https://secure.cyogate.net/api/cpca/v1/

Core Endpoints

Endpoint	Method	Description
/register	POST	Register a new terminal
/transaction	POST	Initiate a transaction on a terminal
/asyncstatus	POST	Poll transaction status
/cancel	POST	Cancel in-progress transaction
/terminals/list	POST	List registered terminals
/terminals/status	POST	Get terminal status
/terminals/reboot	POST	Remotely reboot a terminal

Complete Transaction Flow

// 1. Initiate transaction
$response = gateway_post('https://secure.cyogate.net/api/cpca/v1/transaction', [
    'security_key' => PRIVATE_KEY,
    'terminal_id'  => $terminal_id,
    'type'         => 'sale',
    'amount'       => '45.00',
    'order_id'     => 'ORDER-123',
]);
$ref = $response['transaction_ref'];

// 2. Poll for result
do {
    sleep(2);
    $status = gateway_post('.../asyncstatus', ['security_key' => PRIVATE_KEY, 'transaction_ref' => $ref]);
} while ($status['status'] === 'pending' || $status['status'] === 'processing');

// 3. Handle result
if ($status['status'] === 'complete' && $status['response'] == '1') {
    fulfill_order($status['transactionid']);
}

See Lane/Series for full device setup and configuration guides.