Restaurant POS Integration Guide

// After BeginPaymentSession — OpenTab activates the PIN pad and captures the card:
const response = await fetch('https://localhost:8600/PMI/OpenTab', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-ClientId': 'POS1' },
  body: JSON.stringify({ Message: {
    ClientID: 'POS1', Operation: 'OpenTab', RequestID: '2001', Version: '4.7.0',
    ConfigOptions: { CompanyNumber: 185197, StoreNumber: 1, LaneNumber: 1 },
    PaymentDetails: { SessionTranID: sessionTranID },
    PosTranID: 'pos-tran-001'
  }})
});
const { Message } = await response.json();
const tabReferenceID  = Message.HostData.ReferenceID;           // ⚠️ Save for CloseTab
const tabPaymentTranID = Message.PaymentDetails.PaymentTranID;  // ⚠️ Save for CloseTab

# After BeginPaymentSession — OpenTab activates the PIN pad and captures the card:
resp = requests.post(
    'https://localhost:8600/PMI/OpenTab',
    headers={'Content-Type': 'application/json', 'X-ClientId': 'POS1'},
    json={'Message': {'ClientID': 'POS1', 'Operation': 'OpenTab',
          'RequestID': '2001', 'Version': '4.7.0',
          'ConfigOptions': {'CompanyNumber': 185197, 'StoreNumber': 1, 'LaneNumber': 1},
          'PaymentDetails': {'SessionTranID': session_tran_id},
          'PosTranID': 'pos-tran-001'}},
    verify=False
)
msg = resp.json()['Message']
tab_reference_id  = msg['HostData']['ReferenceID']          # Save for CloseTab
tab_payment_tran  = msg['PaymentDetails']['PaymentTranID']  # Save for CloseTab

 [
        'ClientID' => 'POS1',
        'Operation' => 'OpenTab',
        'RequestID' => '2001',
        'Version' => '4.7.0',
        'ConfigOptions' => [
            'CompanyNumber' => 185197,
            'StoreNumber' => 1,
            'LaneNumber' => 1
        ],
        'PaymentDetails' => [
            'SessionTranID' => 'ccl-session-bar-001'
        ],
        'PosTranID' => 'pos-tran-001'
    ]
]);

$ch = curl_init('https://localhost:8600/PMI/OpenTab');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'X-ClientId: POS1'],
    CURLOPT_POSTFIELDS => $body,
]);
$msg = json_decode(curl_exec($ch), true)['Message'];
curl_close($ch);
$tabRef = $msg['HostData']['ReferenceID']; // save for CloseTab

using System.Net.Http.Json;

var handler = new HttpClientHandler { ServerCertificateCustomValidationCallback = (_, _, _, _) => true };
using var client = new HttpClient(handler);
client.DefaultRequestHeaders.Add("X-ClientId", "POS1");

var payload = new {
    Message = new {
        ClientID = "POS1",
        Operation = "OpenTab",
        RequestID = "2001",
        Version = "4.7.0",
        ConfigOptions = new {
            CompanyNumber = 185197,
            StoreNumber = 1,
            LaneNumber = 1
        },
        PaymentDetails = new {
            SessionTranID = "ccl-session-bar-001"
        },
        PosTranID = "pos-tran-001"
    }
};
var resp = await client.PostAsJsonAsync("https://localhost:8600/PMI/OpenTab", payload);
var root = await resp.Content.ReadFromJsonAsync();
var tabRef = root.GetProperty("Message").GetProperty("HostData").GetProperty("ReferenceID").GetString();

require 'net/http'
require 'json'
require 'openssl'

uri = URI('https://localhost:8600/PMI/OpenTab')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE  # dev only

req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req['X-ClientId'] = 'POS1'
req.body = {
  Message: {
    ClientID: 'POS1',
    Operation: 'OpenTab',
    RequestID: '2001',
    Version: '4.7.0',
    ConfigOptions: {
      CompanyNumber: 185197,
      StoreNumber: 1,
      LaneNumber: 1
    },
    PaymentDetails: {
      SessionTranID: 'ccl-session-bar-001'
    },
    PosTranID: 'pos-tran-001'
  }
}.to_json

msg = JSON.parse(http.request(req).body)['Message']
tab_ref           = msg['HostData']['ReferenceID']              # save for CloseTab
tab_payment_tran  = msg['PaymentDetails']['PaymentTranID']      # save for CloseTab

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newBuilder()
    .sslContext(buildTrustAllContext())  // see pmi-integration guide
    .build();

String jsonBody = """{"Message":{"ClientID":"POS1","Operation":"OpenTab","RequestID":"2001","Version":"4.7.0","ConfigOptions":{"CompanyNumber":185197,"StoreNumber":1,"LaneNumber":1},"PaymentDetails":{"SessionTranID":"ccl-session-bar-001"},"PosTranID":"pos-tran-001"}}""";  // Response: HostData.ReferenceID + PaymentDetails.PaymentTranID — save both for CloseTab

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://localhost:8600/PMI/OpenTab"))
    .header("Content-Type", "application/json")
    .header("X-ClientId", "POS1")
    .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
    .build();

HttpResponse resp = client.send(req, HttpResponse.BodyHandlers.ofString());
// Message.HostData.ReferenceID — save for CloseTab

package main

import (
    "bytes"; "crypto/tls"; "encoding/json"; "net/http"
)

func main() {
    tr := &http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}}
    client := &http.Client{Transport: tr}

    body, _ := json.Marshal(map[string]any{
    "Message": map[string]any{
        "ClientID": "POS1",
        "Operation": "OpenTab",
        "RequestID": "2001",
        "Version": "4.7.0",
        "ConfigOptions": map[string]any{
            "CompanyNumber": 185197,
            "StoreNumber": 1,
            "LaneNumber": 1,
        },
        "PaymentDetails": map[string]any{
            "SessionTranID": "ccl-session-bar-001",
        },
        "PosTranID": "pos-tran-001",
    },
})
    req, _ := http.NewRequest("POST", "https://localhost:8600/PMI/OpenTab", bytes.NewBuffer(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-ClientId", "POS1")

    resp, _ := client.Do(req)
    var result map[string]any
    json.NewDecoder(resp.Body).Decode(&result)
    // result["Message"].(map[string]any)["HostData"].(map[string]any)["ReferenceID"]}

// New BeginPaymentSession first, then:
const response = await fetch('https://localhost:8600/PMI/CloseTab', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-ClientId': 'POS1' },
  body: JSON.stringify({ Message: {
    ClientID: 'POS1', Operation: 'CloseTab', RequestID: '2010', Version: '4.7.0',
    ConfigOptions: { CompanyNumber: 185197, StoreNumber: 1, LaneNumber: 1 },
    Amounts: { AmountDue: finalAmount, AmountTendered: finalAmount, TipAmount: tipAmount },
    HostData: { ReferenceID: tabReferenceID },       // from OpenTab
    PaymentDetails: { SessionTranID: newSessionID, PaymentTranID: tabPaymentTranID },
    PosOptions: { AllowAdjustment: false }
  }})
});
const { Message } = await response.json();

resp = requests.post(
    'https://localhost:8600/PMI/CloseTab',
    headers={'Content-Type': 'application/json', 'X-ClientId': 'POS1'},
    json={'Message': {'ClientID': 'POS1', 'Operation': 'CloseTab',
          'RequestID': '2010', 'Version': '4.7.0',
          'ConfigOptions': {'CompanyNumber': 185197, 'StoreNumber': 1, 'LaneNumber': 1},
          'Amounts': {'AmountDue': final_amount, 'AmountTendered': final_amount, 'TipAmount': tip},
          'HostData': {'ReferenceID': tab_reference_id},
          'PaymentDetails': {'SessionTranID': new_session_id, 'PaymentTranID': tab_payment_tran_id},
          'PosOptions': {'AllowAdjustment': False}}},
    verify=False
)

 [
        'ClientID' => 'POS1',
        'Operation' => 'CloseTab',
        'RequestID' => '2010',
        'Version' => '4.7.0',
        'ConfigOptions' => [
            'CompanyNumber' => 185197,
            'StoreNumber' => 1,
            'LaneNumber' => 1
        ],
        'Amounts' => [
            'AmountDue' => '87.50',
            'AmountTendered' => '87.50',
            'TipAmount' => '15.00'
        ],
        'HostData' => [
            'ReferenceID' => 'tab-ref-xyz789'
        ],
        'PaymentDetails' => [
            'SessionTranID' => 'ccl-session-bar-002',
            'PaymentTranID' => 'pmt-tran-bar-abc'
        ],
        'PosOptions' => [
            'AllowAdjustment' => false
        ]
    ]
]);

$ch = curl_init('https://localhost:8600/PMI/CloseTab');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'X-ClientId: POS1'],
    CURLOPT_POSTFIELDS => $body,
]);
$msg = json_decode(curl_exec($ch), true)['Message'];
curl_close($ch);
$authCode = $msg['PaymentDetails']['AuthCode'];

using System.Net.Http.Json;

var handler = new HttpClientHandler { ServerCertificateCustomValidationCallback = (_, _, _, _) => true };
using var client = new HttpClient(handler);
client.DefaultRequestHeaders.Add("X-ClientId", "POS1");

var payload = new {
    Message = new {
        ClientID = "POS1",
        Operation = "CloseTab",
        RequestID = "2010",
        Version = "4.7.0",
        ConfigOptions = new {
            CompanyNumber = 185197,
            StoreNumber = 1,
            LaneNumber = 1
        },
        Amounts = new {
            AmountDue = "87.50",
            AmountTendered = "87.50",
            TipAmount = "15.00"
        },
        HostData = new {
            ReferenceID = "tab-ref-xyz789"
        },
        PaymentDetails = new {
            SessionTranID = "ccl-session-bar-002",
            PaymentTranID = "pmt-tran-bar-abc"
        },
        PosOptions = new {
            AllowAdjustment = false
        }
    }
};
var resp = await client.PostAsJsonAsync("https://localhost:8600/PMI/CloseTab", payload);
var root = await resp.Content.ReadFromJsonAsync();
var authCode = root.GetProperty("Message").GetProperty("PaymentDetails").GetProperty("AuthCode").GetString();

require 'net/http'
require 'json'
require 'openssl'

uri = URI('https://localhost:8600/PMI/CloseTab')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE  # dev only

req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req['X-ClientId'] = 'POS1'
req.body = {
  Message: {
    ClientID: 'POS1',
    Operation: 'CloseTab',
    RequestID: '2010',
    Version: '4.7.0',
    ConfigOptions: {
      CompanyNumber: 185197,
      StoreNumber: 1,
      LaneNumber: 1
    },
    Amounts: {
      AmountDue: '87.50',
      AmountTendered: '87.50',
      TipAmount: '15.00'
    },
    HostData: {
      ReferenceID: 'tab-ref-xyz789'
    },
    PaymentDetails: {
      SessionTranID: 'ccl-session-bar-002',
      PaymentTranID: 'pmt-tran-bar-abc'
    },
    PosOptions: {
      AllowAdjustment: false
    }
  }
}.to_json

msg = JSON.parse(http.request(req).body)['Message']
auth_code = msg['PaymentDetails']['AuthCode']

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newBuilder()
    .sslContext(buildTrustAllContext())  // see pmi-integration guide
    .build();

String jsonBody = """{"Message":{"ClientID":"POS1","Operation":"CloseTab","RequestID":"2010","Version":"4.7.0","ConfigOptions":{"CompanyNumber":185197,"StoreNumber":1,"LaneNumber":1},"Amounts":{"AmountDue":"87.50","AmountTendered":"87.50","TipAmount":"15.00"},"HostData":{"ReferenceID":"tab-ref-xyz789"},"PaymentDetails":{"SessionTranID":"ccl-session-bar-002","PaymentTranID":"pmt-tran-bar-abc"},"PosOptions":{"AllowAdjustment":false}}}""";

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://localhost:8600/PMI/CloseTab"))
    .header("Content-Type", "application/json")
    .header("X-ClientId", "POS1")
    .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
    .build();

HttpResponse resp = client.send(req, HttpResponse.BodyHandlers.ofString());
// Message.PaymentDetails.AuthCode

package main

import (
    "bytes"; "crypto/tls"; "encoding/json"; "net/http"
)

func main() {
    tr := &http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}}
    client := &http.Client{Transport: tr}

    body, _ := json.Marshal(map[string]any{
    "Message": map[string]any{
        "ClientID": "POS1",
        "Operation": "CloseTab",
        "RequestID": "2010",
        "Version": "4.7.0",
        "ConfigOptions": map[string]any{
            "CompanyNumber": 185197,
            "StoreNumber": 1,
            "LaneNumber": 1,
        },
        "Amounts": map[string]any{
            "AmountDue": "87.50",
            "AmountTendered": "87.50",
            "TipAmount": "15.00",
        },
        "HostData": map[string]any{
            "ReferenceID": "tab-ref-xyz789",
        },
        "PaymentDetails": map[string]any{
            "SessionTranID": "ccl-session-bar-002",
            "PaymentTranID": "pmt-tran-bar-abc",
        },
        "PosOptions": map[string]any{
            "AllowAdjustment": false,
        },
    },
})
    req, _ := http.NewRequest("POST", "https://localhost:8600/PMI/CloseTab", bytes.NewBuffer(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-ClientId", "POS1")

    resp, _ := client.Do(req)
    var result map[string]any
    json.NewDecoder(resp.Body).Decode(&result)
    // result["Message"].(map[string]any)["PaymentDetails"].(map[string]any)["AuthCode"]}

// After a new BeginPaymentSession:
const response = await fetch('https://localhost:8600/PMI/Adjustment', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-ClientId': 'POS1' },
  body: JSON.stringify({ Message: {
    ClientID: 'POS1', Operation: 'Adjustment', RequestID: '3001', Version: '4.7.0',
    ConfigOptions: { CompanyNumber: 185197, StoreNumber: 1, LaneNumber: 1 },
    Amounts: { AmountDue: totalWithTip, AmountTendered: totalWithTip, TipAmount: tip },
    PaymentDetails: { SessionTranID: adjSessionID, PaymentTranID: origPaymentTranID },
    AdjustmentData: { OriginalReferenceId: origReferenceID }
  }})
});
const { Message } = await response.json();

resp = requests.post(
    'https://localhost:8600/PMI/Adjustment',
    headers={'Content-Type': 'application/json', 'X-ClientId': 'POS1'},
    json={'Message': {'ClientID': 'POS1', 'Operation': 'Adjustment',
          'RequestID': '3001', 'Version': '4.7.0',
          'ConfigOptions': {'CompanyNumber': 185197, 'StoreNumber': 1, 'LaneNumber': 1},
          'Amounts': {'AmountDue': total_with_tip, 'AmountTendered': total_with_tip, 'TipAmount': tip},
          'PaymentDetails': {'SessionTranID': adj_session_id, 'PaymentTranID': orig_payment_tran_id},
          'AdjustmentData': {'OriginalReferenceId': orig_reference_id}}},
    verify=False
)

 [
        'ClientID' => 'POS1',
        'Operation' => 'Adjustment',
        'RequestID' => '3001',
        'Version' => '4.7.0',
        'ConfigOptions' => [
            'CompanyNumber' => 185197,
            'StoreNumber' => 1,
            'LaneNumber' => 1
        ],
        'Amounts' => [
            'AmountDue' => '62.75',
            'AmountTendered' => '62.75',
            'TipAmount' => '10.00'
        ],
        'PaymentDetails' => [
            'SessionTranID' => 'ccl-session-adj-001',
            'PaymentTranID' => 'pmt-tran-abc123'
        ],
        'AdjustmentData' => [
            'OriginalReferenceId' => 'ref-host-789xyz'
        ]
    ]
]);

$ch = curl_init('https://localhost:8600/PMI/Adjustment');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'X-ClientId: POS1'],
    CURLOPT_POSTFIELDS => $body,
]);
$msg = json_decode(curl_exec($ch), true)['Message'];
curl_close($ch);
$authCode = $msg['PaymentDetails']['AuthCode'];

using System.Net.Http.Json;

var handler = new HttpClientHandler { ServerCertificateCustomValidationCallback = (_, _, _, _) => true };
using var client = new HttpClient(handler);
client.DefaultRequestHeaders.Add("X-ClientId", "POS1");

var payload = new {
    Message = new {
        ClientID = "POS1",
        Operation = "Adjustment",
        RequestID = "3001",
        Version = "4.7.0",
        ConfigOptions = new {
            CompanyNumber = 185197,
            StoreNumber = 1,
            LaneNumber = 1
        },
        Amounts = new {
            AmountDue = "62.75",
            AmountTendered = "62.75",
            TipAmount = "10.00"
        },
        PaymentDetails = new {
            SessionTranID = "ccl-session-adj-001",
            PaymentTranID = "pmt-tran-abc123"
        },
        AdjustmentData = new {
            OriginalReferenceId = "ref-host-789xyz"
        }
    }
};
var resp = await client.PostAsJsonAsync("https://localhost:8600/PMI/Adjustment", payload);
var root = await resp.Content.ReadFromJsonAsync();
var authCode = root.GetProperty("Message").GetProperty("PaymentDetails").GetProperty("AuthCode").GetString();

require 'net/http'
require 'json'
require 'openssl'

uri = URI('https://localhost:8600/PMI/Adjustment')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE  # dev only

req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req['X-ClientId'] = 'POS1'
req.body = {
  Message: {
    ClientID: 'POS1',
    Operation: 'Adjustment',
    RequestID: '3001',
    Version: '4.7.0',
    ConfigOptions: {
      CompanyNumber: 185197,
      StoreNumber: 1,
      LaneNumber: 1
    },
    Amounts: {
      AmountDue: '62.75',
      AmountTendered: '62.75',
      TipAmount: '10.00'
    },
    PaymentDetails: {
      SessionTranID: 'ccl-session-adj-001',
      PaymentTranID: 'pmt-tran-abc123'
    },
    AdjustmentData: {
      OriginalReferenceId: 'ref-host-789xyz'
    }
  }
}.to_json

msg = JSON.parse(http.request(req).body)['Message']
auth_code = msg['PaymentDetails']['AuthCode']

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newBuilder()
    .sslContext(buildTrustAllContext())  // see pmi-integration guide
    .build();

String jsonBody = """{"Message":{"ClientID":"POS1","Operation":"Adjustment","RequestID":"3001","Version":"4.7.0","ConfigOptions":{"CompanyNumber":185197,"StoreNumber":1,"LaneNumber":1},"Amounts":{"AmountDue":"62.75","AmountTendered":"62.75","TipAmount":"10.00"},"PaymentDetails":{"SessionTranID":"ccl-session-adj-001","PaymentTranID":"pmt-tran-abc123"},"AdjustmentData":{"OriginalReferenceId":"ref-host-789xyz"}}}""";

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://localhost:8600/PMI/Adjustment"))
    .header("Content-Type", "application/json")
    .header("X-ClientId", "POS1")
    .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
    .build();

HttpResponse resp = client.send(req, HttpResponse.BodyHandlers.ofString());
// Message.PaymentDetails.AuthCode

package main

import (
    "bytes"; "crypto/tls"; "encoding/json"; "net/http"
)

func main() {
    tr := &http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}}
    client := &http.Client{Transport: tr}

    body, _ := json.Marshal(map[string]any{
    "Message": map[string]any{
        "ClientID": "POS1",
        "Operation": "Adjustment",
        "RequestID": "3001",
        "Version": "4.7.0",
        "ConfigOptions": map[string]any{
            "CompanyNumber": 185197,
            "StoreNumber": 1,
            "LaneNumber": 1,
        },
        "Amounts": map[string]any{
            "AmountDue": "62.75",
            "AmountTendered": "62.75",
            "TipAmount": "10.00",
        },
        "PaymentDetails": map[string]any{
            "SessionTranID": "ccl-session-adj-001",
            "PaymentTranID": "pmt-tran-abc123",
        },
        "AdjustmentData": map[string]any{
            "OriginalReferenceId": "ref-host-789xyz",
        },
    },
})
    req, _ := http.NewRequest("POST", "https://localhost:8600/PMI/Adjustment", bytes.NewBuffer(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-ClientId", "POS1")

    resp, _ := client.Do(req)
    var result map[string]any
    json.NewDecoder(resp.Body).Decode(&result)
    // result["Message"].(map[string]any)["PaymentDetails"].(map[string]any)["AuthCode"]}

const response = await fetch('https://localhost:8600/PMI/GetCardDetails', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-ClientId': 'POS1' },
  body: JSON.stringify({ Message: {
    ClientID: 'POS1', Operation: 'GetCardDetails', RequestID: '4001', Version: '4.7.0',
    ConfigOptions: { CompanyNumber: 185197, StoreNumber: 1, LaneNumber: 1 },
    Amounts: { AmountDue: '52.75', AmountTendered: '52.75' },
    PaymentDetails: { SessionTranID: sessionTranID, PromptTip: 'YES' },
    CardDetails: [{ CardType: 'Credit' }]
  }})
});
const { Message } = await response.json();
const tip = Message.Amounts.TipAmount;       // guest-selected tip
const total = Message.Amounts.AmountTendered; // total incl. tip → pass to Purchase

resp = requests.post(
    'https://localhost:8600/PMI/GetCardDetails',
    headers={'Content-Type': 'application/json', 'X-ClientId': 'POS1'},
    json={'Message': {'ClientID': 'POS1', 'Operation': 'GetCardDetails',
          'RequestID': '4001', 'Version': '4.7.0',
          'ConfigOptions': {'CompanyNumber': 185197, 'StoreNumber': 1, 'LaneNumber': 1},
          'Amounts': {'AmountDue': '52.75', 'AmountTendered': '52.75'},
          'PaymentDetails': {'SessionTranID': session_tran_id, 'PromptTip': 'YES'},
          'CardDetails': [{'CardType': 'Credit'}]}},
    verify=False
)
msg = resp.json()['Message']
tip = msg['Amounts']['TipAmount']
total = msg['Amounts']['AmountTendered']

 [
        'ClientID' => 'POS1',
        'Operation' => 'GetCardDetails',
        'RequestID' => '4001',
        'Version' => '4.7.0',
        'ConfigOptions' => [
            'CompanyNumber' => 185197,
            'StoreNumber' => 1,
            'LaneNumber' => 1
        ],
        'Amounts' => [
            'AmountDue' => '52.75',
            'AmountTendered' => '52.75'
        ],
        'PaymentDetails' => [
            'SessionTranID' => 'ccl-session-tip-001',
            'PromptTip' => 'YES'
        ],
        'CardDetails' => [[
            'CardType' => 'Credit'
        ]]
    ]
]);

$ch = curl_init('https://localhost:8600/PMI/GetCardDetails');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'X-ClientId: POS1'],
    CURLOPT_POSTFIELDS => $body,
]);
$msg = json_decode(curl_exec($ch), true)['Message'];
curl_close($ch);
$tip = $msg['Amounts']['TipAmount'];

using System.Net.Http.Json;

var handler = new HttpClientHandler { ServerCertificateCustomValidationCallback = (_, _, _, _) => true };
using var client = new HttpClient(handler);
client.DefaultRequestHeaders.Add("X-ClientId", "POS1");

var payload = new {
    Message = new {
        ClientID = "POS1",
        Operation = "GetCardDetails",
        RequestID = "4001",
        Version = "4.7.0",
        ConfigOptions = new {
            CompanyNumber = 185197,
            StoreNumber = 1,
            LaneNumber = 1
        },
        Amounts = new {
            AmountDue = "52.75",
            AmountTendered = "52.75"
        },
        PaymentDetails = new {
            SessionTranID = "ccl-session-tip-001",
            PromptTip = "YES"
        },
        CardDetails = new[] {{'CardType': 'Credit'}}
    }
};
var resp = await client.PostAsJsonAsync("https://localhost:8600/PMI/GetCardDetails", payload);
var root = await resp.Content.ReadFromJsonAsync();
var tip = root.GetProperty("Message").GetProperty("Amounts").GetProperty("TipAmount").GetString();

require 'net/http'
require 'json'
require 'openssl'

uri = URI('https://localhost:8600/PMI/GetCardDetails')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE  # dev only

req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req['X-ClientId'] = 'POS1'
req.body = {
  Message: {
    ClientID: 'POS1',
    Operation: 'GetCardDetails',
    RequestID: '4001',
    Version: '4.7.0',
    ConfigOptions: {
      CompanyNumber: 185197,
      StoreNumber: 1,
      LaneNumber: 1
    },
    Amounts: {
      AmountDue: '52.75',
      AmountTendered: '52.75'
    },
    PaymentDetails: {
      SessionTranID: 'ccl-session-tip-001',
      PromptTip: 'YES'
    },
    CardDetails: [{'CardType': 'Credit'}]
  }
}.to_json

msg = JSON.parse(http.request(req).body)['Message']
tip = msg['Amounts']['TipAmount']

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newBuilder()
    .sslContext(buildTrustAllContext())  // see pmi-integration guide
    .build();

String jsonBody = """{"Message":{"ClientID":"POS1","Operation":"GetCardDetails","RequestID":"4001","Version":"4.7.0","ConfigOptions":{"CompanyNumber":185197,"StoreNumber":1,"LaneNumber":1},"Amounts":{"AmountDue":"52.75","AmountTendered":"52.75"},"PaymentDetails":{"SessionTranID":"ccl-session-tip-001","PromptTip":"YES"},"CardDetails":[{"CardType":"Credit"}]}}""";

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://localhost:8600/PMI/GetCardDetails"))
    .header("Content-Type", "application/json")
    .header("X-ClientId", "POS1")
    .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
    .build();

HttpResponse resp = client.send(req, HttpResponse.BodyHandlers.ofString());
// Message.Amounts.TipAmount (guest-selected tip)

package main

import (
    "bytes"; "crypto/tls"; "encoding/json"; "net/http"
)

func main() {
    tr := &http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}}
    client := &http.Client{Transport: tr}

    body, _ := json.Marshal(map[string]any{
    "Message": map[string]any{
        "ClientID": "POS1",
        "Operation": "GetCardDetails",
        "RequestID": "4001",
        "Version": "4.7.0",
        "ConfigOptions": map[string]any{
            "CompanyNumber": 185197,
            "StoreNumber": 1,
            "LaneNumber": 1,
        },
        "Amounts": map[string]any{
            "AmountDue": "52.75",
            "AmountTendered": "52.75",
        },
        "PaymentDetails": map[string]any{
            "SessionTranID": "ccl-session-tip-001",
            "PromptTip": "YES",
        },
        "CardDetails": []any{{'CardType': 'Credit'}},
    },
})
    req, _ := http.NewRequest("POST", "https://localhost:8600/PMI/GetCardDetails", bytes.NewBuffer(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-ClientId", "POS1")

    resp, _ := client.Do(req)
    var result map[string]any
    json.NewDecoder(resp.Body).Decode(&result)
    // result["Message"].(map[string]any)["Amounts"].(map[string]any)["TipAmount"]}

// Step 2: GetCardDetails — GiftCard type (after BeginPaymentSession)
const gcdResp = await fetch('https://localhost:8600/PMI/GetCardDetails', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-ClientId': 'POS1' },
  body: JSON.stringify({ Message: {
    ClientID: 'POS1', Operation: 'GetCardDetails', RequestID: '1002', Version: '4.7.0',
    ConfigOptions: { CompanyNumber: 185197, StoreNumber: 1, LaneNumber: 1 },
    Amounts: { AmountDue: '45.00', AmountTendered: '45.00' },
    PaymentDetails: { SessionTranID: sessionTranID },
    CardDetails: [{ CardType: 'GiftCard' }]
  }})
});
const { Message: gcd } = await gcdResp.json();
const paymentTranID = gcd.PaymentDetails.PaymentTranID;

// Step 3: Purchase with GiftCard flag
const purResp = await fetch('https://localhost:8600/PMI/Purchase', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-ClientId': 'POS1' },
  body: JSON.stringify({ Message: {
    ClientID: 'POS1', Operation: 'Purchase', RequestID: '1003', Version: '4.7.0',
    ConfigOptions: { CompanyNumber: 185197, StoreNumber: 1, LaneNumber: 1 },
    Amounts: { AmountDue: '45.00', AmountTendered: '45.00' },
    PaymentDetails: { SessionTranID: sessionTranID, PaymentTranID: paymentTranID },
    PosOptions: { CardType: 'GiftCard' }
  }})
});
const { Message: pur } = await purResp.json();
// ⚠️ parseFloat(pur.Amounts.AmountApproved) < 45.00 → partial approval, prompt for another tender
const cardBalance = pur.Amounts.CardBalance;

# Step 2: GetCardDetails — GiftCard type
gcd = requests.post(
    'https://localhost:8600/PMI/GetCardDetails',
    headers={'Content-Type': 'application/json', 'X-ClientId': 'POS1'},
    json={'Message': {'ClientID': 'POS1', 'Operation': 'GetCardDetails',
          'RequestID': '1002', 'Version': '4.7.0',
          'ConfigOptions': {'CompanyNumber': 185197, 'StoreNumber': 1, 'LaneNumber': 1},
          'Amounts': {'AmountDue': '45.00', 'AmountTendered': '45.00'},
          'PaymentDetails': {'SessionTranID': session_tran_id},
          'CardDetails': [{'CardType': 'GiftCard'}]}},
    verify=False
).json()['Message']
payment_tran_id = gcd['PaymentDetails']['PaymentTranID']

# Step 3: Purchase with GiftCard flag
pur = requests.post(
    'https://localhost:8600/PMI/Purchase',
    headers={'Content-Type': 'application/json', 'X-ClientId': 'POS1'},
    json={'Message': {'ClientID': 'POS1', 'Operation': 'Purchase',
          'RequestID': '1003', 'Version': '4.7.0',
          'ConfigOptions': {'CompanyNumber': 185197, 'StoreNumber': 1, 'LaneNumber': 1},
          'Amounts': {'AmountDue': '45.00', 'AmountTendered': '45.00'},
          'PaymentDetails': {'SessionTranID': session_tran_id, 'PaymentTranID': payment_tran_id},
          'PosOptions': {'CardType': 'GiftCard'}}},
    verify=False
).json()['Message']
# ⚠️ float(pur['Amounts']['AmountApproved']) < 45.00 → partial, prompt for second tender
card_balance = pur['Amounts']['CardBalance']

 [
        'ClientID' => 'POS1',
        'Operation' => 'GetCardDetails',
        'RequestID' => '1002',
        'Version' => '4.7.0',
        'ConfigOptions' => [
            'CompanyNumber' => 185197,
            'StoreNumber' => 1,
            'LaneNumber' => 1
        ],
        'Amounts' => [
            'AmountDue' => '45.00',
            'AmountTendered' => '45.00'
        ],
        'PaymentDetails' => [
            'SessionTranID' => 'ccl-gc-session-001'
        ],
        'CardDetails' => [[
            'CardType' => 'GiftCard'
        ]]
    ]
]);

$ch = curl_init('https://localhost:8600/PMI/GetCardDetails');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'X-ClientId: POS1'],
    CURLOPT_POSTFIELDS => $body,
]);
$msg = json_decode(curl_exec($ch), true)['Message'];
curl_close($ch);
$paymentTranID = $msg['PaymentDetails']['PaymentTranID'];

using System.Net.Http.Json;

var handler = new HttpClientHandler { ServerCertificateCustomValidationCallback = (_, _, _, _) => true };
using var client = new HttpClient(handler);
client.DefaultRequestHeaders.Add("X-ClientId", "POS1");

var payload = new {
    Message = new {
        ClientID = "POS1",
        Operation = "GetCardDetails",
        RequestID = "1002",
        Version = "4.7.0",
        ConfigOptions = new {
            CompanyNumber = 185197,
            StoreNumber = 1,
            LaneNumber = 1
        },
        Amounts = new {
            AmountDue = "45.00",
            AmountTendered = "45.00"
        },
        PaymentDetails = new {
            SessionTranID = "ccl-gc-session-001"
        },
        CardDetails = new[] {{'CardType': 'GiftCard'}}
    }
};
var resp = await client.PostAsJsonAsync("https://localhost:8600/PMI/GetCardDetails", payload);
var root = await resp.Content.ReadFromJsonAsync();
var paymentTranID = root.GetProperty("Message").GetProperty("PaymentDetails").GetProperty("PaymentTranID").GetString();

require 'net/http'
require 'json'
require 'openssl'

uri = URI('https://localhost:8600/PMI/GetCardDetails')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE  # dev only

req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req['X-ClientId'] = 'POS1'
req.body = {
  Message: {
    ClientID: 'POS1',
    Operation: 'GetCardDetails',
    RequestID: '1002',
    Version: '4.7.0',
    ConfigOptions: {
      CompanyNumber: 185197,
      StoreNumber: 1,
      LaneNumber: 1
    },
    Amounts: {
      AmountDue: '45.00',
      AmountTendered: '45.00'
    },
    PaymentDetails: {
      SessionTranID: 'ccl-gc-session-001'
    },
    CardDetails: [{'CardType': 'GiftCard'}]
  }
}.to_json

msg = JSON.parse(http.request(req).body)['Message']
payment_tran_id = msg['PaymentDetails']['PaymentTranID']

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newBuilder()
    .sslContext(buildTrustAllContext())  // see pmi-integration guide
    .build();

String jsonBody = """{"Message":{"ClientID":"POS1","Operation":"GetCardDetails","RequestID":"1002","Version":"4.7.0","ConfigOptions":{"CompanyNumber":185197,"StoreNumber":1,"LaneNumber":1},"Amounts":{"AmountDue":"45.00","AmountTendered":"45.00"},"PaymentDetails":{"SessionTranID":"ccl-gc-session-001"},"CardDetails":[{"CardType":"GiftCard"}]}}""";

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://localhost:8600/PMI/GetCardDetails"))
    .header("Content-Type", "application/json")
    .header("X-ClientId", "POS1")
    .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
    .build();

HttpResponse resp = client.send(req, HttpResponse.BodyHandlers.ofString());
// Message.PaymentDetails.PaymentTranID

package main

import (
    "bytes"; "crypto/tls"; "encoding/json"; "net/http"
)

func main() {
    tr := &http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}}
    client := &http.Client{Transport: tr}

    body, _ := json.Marshal(map[string]any{
    "Message": map[string]any{
        "ClientID": "POS1",
        "Operation": "GetCardDetails",
        "RequestID": "1002",
        "Version": "4.7.0",
        "ConfigOptions": map[string]any{
            "CompanyNumber": 185197,
            "StoreNumber": 1,
            "LaneNumber": 1,
        },
        "Amounts": map[string]any{
            "AmountDue": "45.00",
            "AmountTendered": "45.00",
        },
        "PaymentDetails": map[string]any{
            "SessionTranID": "ccl-gc-session-001",
        },
        "CardDetails": []any{{'CardType': 'GiftCard'}},
    },
})
    req, _ := http.NewRequest("POST", "https://localhost:8600/PMI/GetCardDetails", bytes.NewBuffer(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-ClientId", "POS1")

    resp, _ := client.Do(req)
    var result map[string]any
    json.NewDecoder(resp.Body).Decode(&result)
    // result["Message"].(map[string]any)["PaymentDetails"].(map[string]any)["PaymentTranID"]}

const resp = await fetch('https://localhost:8600/PMI/Activate', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-ClientId': 'POS1' },
  body: JSON.stringify({ Message: {
    ClientID: 'POS1', Operation: 'Activate', RequestID: '5001', Version: '4.7.0',
    ConfigOptions: { CompanyNumber: 185197, StoreNumber: 1, LaneNumber: 1 },
    Amounts: { ActivationAmount: '50.00' },
    PaymentDetails: { SessionTranID: sessionTranID },
    PosOptions: { CardType: 'GiftCard' },
    PosTranID: 'pos-gc-001'
  }})
});
const { Message } = await resp.json();
// Message.Amounts.CardBalance → '50.00'
// Message.CardDetails[0].LastFour → '4400'

result = requests.post(
    'https://localhost:8600/PMI/Activate',
    headers={'Content-Type': 'application/json', 'X-ClientId': 'POS1'},
    json={'Message': {'ClientID': 'POS1', 'Operation': 'Activate',
          'RequestID': '5001', 'Version': '4.7.0',
          'ConfigOptions': {'CompanyNumber': 185197, 'StoreNumber': 1, 'LaneNumber': 1},
          'Amounts': {'ActivationAmount': '50.00'},
          'PaymentDetails': {'SessionTranID': session_tran_id},
          'PosOptions': {'CardType': 'GiftCard'},
          'PosTranID': 'pos-gc-001'}},
    verify=False
).json()['Message']
card_balance = result['Amounts']['CardBalance']  # '50.00'

 [
        'ClientID' => 'POS1',
        'Operation' => 'Activate',
        'RequestID' => '5001',
        'Version' => '4.7.0',
        'ConfigOptions' => [
            'CompanyNumber' => 185197,
            'StoreNumber' => 1,
            'LaneNumber' => 1
        ],
        'Amounts' => [
            'ActivationAmount' => '50.00'
        ],
        'PaymentDetails' => [
            'SessionTranID' => 'ccl-gc-session-act'
        ],
        'PosOptions' => [
            'CardType' => 'GiftCard'
        ],
        'PosTranID' => 'pos-gc-001'
    ]
]);

$ch = curl_init('https://localhost:8600/PMI/Activate');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'X-ClientId: POS1'],
    CURLOPT_POSTFIELDS => $body,
]);
$msg = json_decode(curl_exec($ch), true)['Message'];
curl_close($ch);
$balance = $msg['Amounts']['CardBalance'];

using System.Net.Http.Json;

var handler = new HttpClientHandler { ServerCertificateCustomValidationCallback = (_, _, _, _) => true };
using var client = new HttpClient(handler);
client.DefaultRequestHeaders.Add("X-ClientId", "POS1");

var payload = new {
    Message = new {
        ClientID = "POS1",
        Operation = "Activate",
        RequestID = "5001",
        Version = "4.7.0",
        ConfigOptions = new {
            CompanyNumber = 185197,
            StoreNumber = 1,
            LaneNumber = 1
        },
        Amounts = new {
            ActivationAmount = "50.00"
        },
        PaymentDetails = new {
            SessionTranID = "ccl-gc-session-act"
        },
        PosOptions = new {
            CardType = "GiftCard"
        },
        PosTranID = "pos-gc-001"
    }
};
var resp = await client.PostAsJsonAsync("https://localhost:8600/PMI/Activate", payload);
var root = await resp.Content.ReadFromJsonAsync();
var balance = root.GetProperty("Message").GetProperty("Amounts").GetProperty("CardBalance").GetString();

require 'net/http'
require 'json'
require 'openssl'

uri = URI('https://localhost:8600/PMI/Activate')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE  # dev only

req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req['X-ClientId'] = 'POS1'
req.body = {
  Message: {
    ClientID: 'POS1',
    Operation: 'Activate',
    RequestID: '5001',
    Version: '4.7.0',
    ConfigOptions: {
      CompanyNumber: 185197,
      StoreNumber: 1,
      LaneNumber: 1
    },
    Amounts: {
      ActivationAmount: '50.00'
    },
    PaymentDetails: {
      SessionTranID: 'ccl-gc-session-act'
    },
    PosOptions: {
      CardType: 'GiftCard'
    },
    PosTranID: 'pos-gc-001'
  }
}.to_json

msg = JSON.parse(http.request(req).body)['Message']
balance = msg['Amounts']['CardBalance']

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newBuilder()
    .sslContext(buildTrustAllContext())  // see pmi-integration guide
    .build();

String jsonBody = """{"Message":{"ClientID":"POS1","Operation":"Activate","RequestID":"5001","Version":"4.7.0","ConfigOptions":{"CompanyNumber":185197,"StoreNumber":1,"LaneNumber":1},"Amounts":{"ActivationAmount":"50.00"},"PaymentDetails":{"SessionTranID":"ccl-gc-session-act"},"PosOptions":{"CardType":"GiftCard"},"PosTranID":"pos-gc-001"}}""";

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://localhost:8600/PMI/Activate"))
    .header("Content-Type", "application/json")
    .header("X-ClientId", "POS1")
    .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
    .build();

HttpResponse resp = client.send(req, HttpResponse.BodyHandlers.ofString());
// Message.Amounts.CardBalance

package main

import (
    "bytes"; "crypto/tls"; "encoding/json"; "net/http"
)

func main() {
    tr := &http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}}
    client := &http.Client{Transport: tr}

    body, _ := json.Marshal(map[string]any{
    "Message": map[string]any{
        "ClientID": "POS1",
        "Operation": "Activate",
        "RequestID": "5001",
        "Version": "4.7.0",
        "ConfigOptions": map[string]any{
            "CompanyNumber": 185197,
            "StoreNumber": 1,
            "LaneNumber": 1,
        },
        "Amounts": map[string]any{
            "ActivationAmount": "50.00",
        },
        "PaymentDetails": map[string]any{
            "SessionTranID": "ccl-gc-session-act",
        },
        "PosOptions": map[string]any{
            "CardType": "GiftCard",
        },
        "PosTranID": "pos-gc-001",
    },
})
    req, _ := http.NewRequest("POST", "https://localhost:8600/PMI/Activate", bytes.NewBuffer(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-ClientId", "POS1")

    resp, _ := client.Do(req)
    var result map[string]any
    json.NewDecoder(resp.Body).Decode(&result)
    // result["Message"].(map[string]any)["Amounts"].(map[string]any)["CardBalance"]}

const resp = await fetch('https://localhost:8600/PMI/BalanceInquiry', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-ClientId': 'POS1' },
  body: JSON.stringify({ Message: {
    ClientID: 'POS1', Operation: 'BalanceInquiry', RequestID: '5002', Version: '4.7.0',
    ConfigOptions: { CompanyNumber: 185197, StoreNumber: 1, LaneNumber: 1 },
    PaymentDetails: { SessionTranID: sessionTranID }
  }})
});
const { Message } = await resp.json();
const cardBalance = Message.Amounts.CardBalance; // e.g. '32.50'

result = requests.post(
    'https://localhost:8600/PMI/BalanceInquiry',
    headers={'Content-Type': 'application/json', 'X-ClientId': 'POS1'},
    json={'Message': {'ClientID': 'POS1', 'Operation': 'BalanceInquiry',
          'RequestID': '5002', 'Version': '4.7.0',
          'ConfigOptions': {'CompanyNumber': 185197, 'StoreNumber': 1, 'LaneNumber': 1},
          'PaymentDetails': {'SessionTranID': session_tran_id}}},
    verify=False
).json()['Message']
card_balance = result['Amounts']['CardBalance']  # e.g. '32.50'

 [
        'ClientID' => 'POS1',
        'Operation' => 'BalanceInquiry',
        'RequestID' => '5002',
        'Version' => '4.7.0',
        'ConfigOptions' => [
            'CompanyNumber' => 185197,
            'StoreNumber' => 1,
            'LaneNumber' => 1
        ],
        'PaymentDetails' => [
            'SessionTranID' => 'ccl-gc-session-bal'
        ]
    ]
]);

$ch = curl_init('https://localhost:8600/PMI/BalanceInquiry');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'X-ClientId: POS1'],
    CURLOPT_POSTFIELDS => $body,
]);
$msg = json_decode(curl_exec($ch), true)['Message'];
curl_close($ch);
$balance = $msg['Amounts']['CardBalance'];

using System.Net.Http.Json;

var handler = new HttpClientHandler { ServerCertificateCustomValidationCallback = (_, _, _, _) => true };
using var client = new HttpClient(handler);
client.DefaultRequestHeaders.Add("X-ClientId", "POS1");

var payload = new {
    Message = new {
        ClientID = "POS1",
        Operation = "BalanceInquiry",
        RequestID = "5002",
        Version = "4.7.0",
        ConfigOptions = new {
            CompanyNumber = 185197,
            StoreNumber = 1,
            LaneNumber = 1
        },
        PaymentDetails = new {
            SessionTranID = "ccl-gc-session-bal"
        }
    }
};
var resp = await client.PostAsJsonAsync("https://localhost:8600/PMI/BalanceInquiry", payload);
var root = await resp.Content.ReadFromJsonAsync();
var balance = root.GetProperty("Message").GetProperty("Amounts").GetProperty("CardBalance").GetString();

require 'net/http'
require 'json'
require 'openssl'

uri = URI('https://localhost:8600/PMI/BalanceInquiry')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE  # dev only

req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req['X-ClientId'] = 'POS1'
req.body = {
  Message: {
    ClientID: 'POS1',
    Operation: 'BalanceInquiry',
    RequestID: '5002',
    Version: '4.7.0',
    ConfigOptions: {
      CompanyNumber: 185197,
      StoreNumber: 1,
      LaneNumber: 1
    },
    PaymentDetails: {
      SessionTranID: 'ccl-gc-session-bal'
    }
  }
}.to_json

msg = JSON.parse(http.request(req).body)['Message']
balance = msg['Amounts']['CardBalance']

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newBuilder()
    .sslContext(buildTrustAllContext())  // see pmi-integration guide
    .build();

String jsonBody = """{"Message":{"ClientID":"POS1","Operation":"BalanceInquiry","RequestID":"5002","Version":"4.7.0","ConfigOptions":{"CompanyNumber":185197,"StoreNumber":1,"LaneNumber":1},"PaymentDetails":{"SessionTranID":"ccl-gc-session-bal"}}}""";

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://localhost:8600/PMI/BalanceInquiry"))
    .header("Content-Type", "application/json")
    .header("X-ClientId", "POS1")
    .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
    .build();

HttpResponse resp = client.send(req, HttpResponse.BodyHandlers.ofString());
// Message.Amounts.CardBalance

package main

import (
    "bytes"; "crypto/tls"; "encoding/json"; "net/http"
)

func main() {
    tr := &http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}}
    client := &http.Client{Transport: tr}

    body, _ := json.Marshal(map[string]any{
    "Message": map[string]any{
        "ClientID": "POS1",
        "Operation": "BalanceInquiry",
        "RequestID": "5002",
        "Version": "4.7.0",
        "ConfigOptions": map[string]any{
            "CompanyNumber": 185197,
            "StoreNumber": 1,
            "LaneNumber": 1,
        },
        "PaymentDetails": map[string]any{
            "SessionTranID": "ccl-gc-session-bal",
        },
    },
})
    req, _ := http.NewRequest("POST", "https://localhost:8600/PMI/BalanceInquiry", bytes.NewBuffer(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-ClientId", "POS1")

    resp, _ := client.Do(req)
    var result map[string]any
    json.NewDecoder(resp.Body).Decode(&result)
    // result["Message"].(map[string]any)["Amounts"].(map[string]any)["CardBalance"]}

const resp = await fetch('https://localhost:8600/PMI/Reload', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-ClientId': 'POS1' },
  body: JSON.stringify({ Message: {
    ClientID: 'POS1', Operation: 'Reload', RequestID: '5003', Version: '4.7.0',
    ConfigOptions: { CompanyNumber: 185197, StoreNumber: 1, LaneNumber: 1 },
    Amounts: { ReloadAmount: '25.00' },
    PaymentDetails: { SessionTranID: sessionTranID }
  }})
});
const { Message } = await resp.json();
// Message.Amounts.CardBalance → new balance (e.g. '57.50')

result = requests.post(
    'https://localhost:8600/PMI/Reload',
    headers={'Content-Type': 'application/json', 'X-ClientId': 'POS1'},
    json={'Message': {'ClientID': 'POS1', 'Operation': 'Reload',
          'RequestID': '5003', 'Version': '4.7.0',
          'ConfigOptions': {'CompanyNumber': 185197, 'StoreNumber': 1, 'LaneNumber': 1},
          'Amounts': {'ReloadAmount': '25.00'},
          'PaymentDetails': {'SessionTranID': session_tran_id}}},
    verify=False
).json()['Message']
card_balance = result['Amounts']['CardBalance']  # new balance e.g. '57.50'

 [
        'ClientID' => 'POS1',
        'Operation' => 'Reload',
        'RequestID' => '5003',
        'Version' => '4.7.0',
        'ConfigOptions' => [
            'CompanyNumber' => 185197,
            'StoreNumber' => 1,
            'LaneNumber' => 1
        ],
        'Amounts' => [
            'ReloadAmount' => '25.00'
        ],
        'PaymentDetails' => [
            'SessionTranID' => 'ccl-gc-session-reload'
        ]
    ]
]);

$ch = curl_init('https://localhost:8600/PMI/Reload');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'X-ClientId: POS1'],
    CURLOPT_POSTFIELDS => $body,
]);
$msg = json_decode(curl_exec($ch), true)['Message'];
curl_close($ch);
$newBalance = $msg['Amounts']['CardBalance'];

using System.Net.Http.Json;

var handler = new HttpClientHandler { ServerCertificateCustomValidationCallback = (_, _, _, _) => true };
using var client = new HttpClient(handler);
client.DefaultRequestHeaders.Add("X-ClientId", "POS1");

var payload = new {
    Message = new {
        ClientID = "POS1",
        Operation = "Reload",
        RequestID = "5003",
        Version = "4.7.0",
        ConfigOptions = new {
            CompanyNumber = 185197,
            StoreNumber = 1,
            LaneNumber = 1
        },
        Amounts = new {
            ReloadAmount = "25.00"
        },
        PaymentDetails = new {
            SessionTranID = "ccl-gc-session-reload"
        }
    }
};
var resp = await client.PostAsJsonAsync("https://localhost:8600/PMI/Reload", payload);
var root = await resp.Content.ReadFromJsonAsync();
var newBalance = root.GetProperty("Message").GetProperty("Amounts").GetProperty("CardBalance").GetString();

require 'net/http'
require 'json'
require 'openssl'

uri = URI('https://localhost:8600/PMI/Reload')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE  # dev only

req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req['X-ClientId'] = 'POS1'
req.body = {
  Message: {
    ClientID: 'POS1',
    Operation: 'Reload',
    RequestID: '5003',
    Version: '4.7.0',
    ConfigOptions: {
      CompanyNumber: 185197,
      StoreNumber: 1,
      LaneNumber: 1
    },
    Amounts: {
      ReloadAmount: '25.00'
    },
    PaymentDetails: {
      SessionTranID: 'ccl-gc-session-reload'
    }
  }
}.to_json

msg = JSON.parse(http.request(req).body)['Message']
new_balance = msg['Amounts']['CardBalance']

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newBuilder()
    .sslContext(buildTrustAllContext())  // see pmi-integration guide
    .build();

String jsonBody = """{"Message":{"ClientID":"POS1","Operation":"Reload","RequestID":"5003","Version":"4.7.0","ConfigOptions":{"CompanyNumber":185197,"StoreNumber":1,"LaneNumber":1},"Amounts":{"ReloadAmount":"25.00"},"PaymentDetails":{"SessionTranID":"ccl-gc-session-reload"}}}""";

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://localhost:8600/PMI/Reload"))
    .header("Content-Type", "application/json")
    .header("X-ClientId", "POS1")
    .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
    .build();

HttpResponse resp = client.send(req, HttpResponse.BodyHandlers.ofString());
// Message.Amounts.CardBalance (new balance after reload)

package main

import (
    "bytes"; "crypto/tls"; "encoding/json"; "net/http"
)

func main() {
    tr := &http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}}
    client := &http.Client{Transport: tr}

    body, _ := json.Marshal(map[string]any{
    "Message": map[string]any{
        "ClientID": "POS1",
        "Operation": "Reload",
        "RequestID": "5003",
        "Version": "4.7.0",
        "ConfigOptions": map[string]any{
            "CompanyNumber": 185197,
            "StoreNumber": 1,
            "LaneNumber": 1,
        },
        "Amounts": map[string]any{
            "ReloadAmount": "25.00",
        },
        "PaymentDetails": map[string]any{
            "SessionTranID": "ccl-gc-session-reload",
        },
    },
})
    req, _ := http.NewRequest("POST", "https://localhost:8600/PMI/Reload", bytes.NewBuffer(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-ClientId", "POS1")

    resp, _ := client.Do(req)
    var result map[string]any
    json.NewDecoder(resp.Body).Decode(&result)
    // result["Message"].(map[string]any)["Amounts"].(map[string]any)["CardBalance"]}

const resp = await fetch('https://localhost:8600/PMI/Deactivate', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-ClientId': 'POS1' },
  body: JSON.stringify({ Message: {
    ClientID: 'POS1', Operation: 'Deactivate', RequestID: '5004', Version: '4.7.0',
    ConfigOptions: { CompanyNumber: 185197, StoreNumber: 1, LaneNumber: 1 },
    Amounts: { ActivationAmount: '50.00' },
    PaymentDetails: { SessionTranID: sessionTranID }
  }})
});
const { Message } = await resp.json();
// Message.Amounts.CardBalance → '0.00'

result = requests.post(
    'https://localhost:8600/PMI/Deactivate',
    headers={'Content-Type': 'application/json', 'X-ClientId': 'POS1'},
    json={'Message': {'ClientID': 'POS1', 'Operation': 'Deactivate',
          'RequestID': '5004', 'Version': '4.7.0',
          'ConfigOptions': {'CompanyNumber': 185197, 'StoreNumber': 1, 'LaneNumber': 1},
          'Amounts': {'ActivationAmount': '50.00'},
          'PaymentDetails': {'SessionTranID': session_tran_id}}},
    verify=False
).json()['Message']
card_balance = result['Amounts']['CardBalance']  # '0.00'

 [
        'ClientID' => 'POS1',
        'Operation' => 'Deactivate',
        'RequestID' => '5004',
        'Version' => '4.7.0',
        'ConfigOptions' => [
            'CompanyNumber' => 185197,
            'StoreNumber' => 1,
            'LaneNumber' => 1
        ],
        'Amounts' => [
            'ActivationAmount' => '50.00'
        ],
        'PaymentDetails' => [
            'SessionTranID' => 'ccl-gc-session-deact'
        ]
    ]
]);

$ch = curl_init('https://localhost:8600/PMI/Deactivate');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'X-ClientId: POS1'],
    CURLOPT_POSTFIELDS => $body,
]);
$msg = json_decode(curl_exec($ch), true)['Message'];
curl_close($ch);
// $msg['Amounts']['CardBalance'] === '0.00'

using System.Net.Http.Json;

var handler = new HttpClientHandler { ServerCertificateCustomValidationCallback = (_, _, _, _) => true };
using var client = new HttpClient(handler);
client.DefaultRequestHeaders.Add("X-ClientId", "POS1");

var payload = new {
    Message = new {
        ClientID = "POS1",
        Operation = "Deactivate",
        RequestID = "5004",
        Version = "4.7.0",
        ConfigOptions = new {
            CompanyNumber = 185197,
            StoreNumber = 1,
            LaneNumber = 1
        },
        Amounts = new {
            ActivationAmount = "50.00"
        },
        PaymentDetails = new {
            SessionTranID = "ccl-gc-session-deact"
        }
    }
};
var resp = await client.PostAsJsonAsync("https://localhost:8600/PMI/Deactivate", payload);
var root = await resp.Content.ReadFromJsonAsync();
// root.GetProperty("Message").GetProperty("Amounts").GetProperty("CardBalance").GetString();

require 'net/http'
require 'json'
require 'openssl'

uri = URI('https://localhost:8600/PMI/Deactivate')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE  # dev only

req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req['X-ClientId'] = 'POS1'
req.body = {
  Message: {
    ClientID: 'POS1',
    Operation: 'Deactivate',
    RequestID: '5004',
    Version: '4.7.0',
    ConfigOptions: {
      CompanyNumber: 185197,
      StoreNumber: 1,
      LaneNumber: 1
    },
    Amounts: {
      ActivationAmount: '50.00'
    },
    PaymentDetails: {
      SessionTranID: 'ccl-gc-session-deact'
    }
  }
}.to_json

msg = JSON.parse(http.request(req).body)['Message']
# msg['Amounts']['CardBalance'] == '0.00'

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newBuilder()
    .sslContext(buildTrustAllContext())  // see pmi-integration guide
    .build();

String jsonBody = """{"Message":{"ClientID":"POS1","Operation":"Deactivate","RequestID":"5004","Version":"4.7.0","ConfigOptions":{"CompanyNumber":185197,"StoreNumber":1,"LaneNumber":1},"Amounts":{"ActivationAmount":"50.00"},"PaymentDetails":{"SessionTranID":"ccl-gc-session-deact"}}}""";

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://localhost:8600/PMI/Deactivate"))
    .header("Content-Type", "application/json")
    .header("X-ClientId", "POS1")
    .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
    .build();

HttpResponse resp = client.send(req, HttpResponse.BodyHandlers.ofString());
// Message.Amounts.CardBalance === "0.00"

package main

import (
    "bytes"; "crypto/tls"; "encoding/json"; "net/http"
)

func main() {
    tr := &http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}}
    client := &http.Client{Transport: tr}

    body, _ := json.Marshal(map[string]any{
    "Message": map[string]any{
        "ClientID": "POS1",
        "Operation": "Deactivate",
        "RequestID": "5004",
        "Version": "4.7.0",
        "ConfigOptions": map[string]any{
            "CompanyNumber": 185197,
            "StoreNumber": 1,
            "LaneNumber": 1,
        },
        "Amounts": map[string]any{
            "ActivationAmount": "50.00",
        },
        "PaymentDetails": map[string]any{
            "SessionTranID": "ccl-gc-session-deact",
        },
    },
})
    req, _ := http.NewRequest("POST", "https://localhost:8600/PMI/Deactivate", bytes.NewBuffer(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-ClientId", "POS1")

    resp, _ := client.Do(req)
    var result map[string]any
    json.NewDecoder(resp.Body).Decode(&result)
    // result["Message"].(map[string]any)["Amounts"].(map[string]any)["CardBalance"]}

const resp = await fetch('https://localhost:8600/PMI/CashOut', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-ClientId': 'POS1' },
  body: JSON.stringify({ Message: {
    ClientID: 'POS1', Operation: 'CashOut', RequestID: '5005', Version: '4.7.0',
    ConfigOptions: { CompanyNumber: 185197, StoreNumber: 1, LaneNumber: 1 },
    PaymentDetails: { SessionTranID: sessionTranID },
    PosOptions: { TranType: 'CashOut' }
  }})
});
const { Message } = await resp.json();
// Message.Amounts.AmountApproved → amount cashed out
// Message.Amounts.CardBalance → '0.00'

result = requests.post(
    'https://localhost:8600/PMI/CashOut',
    headers={'Content-Type': 'application/json', 'X-ClientId': 'POS1'},
    json={'Message': {'ClientID': 'POS1', 'Operation': 'CashOut',
          'RequestID': '5005', 'Version': '4.7.0',
          'ConfigOptions': {'CompanyNumber': 185197, 'StoreNumber': 1, 'LaneNumber': 1},
          'PaymentDetails': {'SessionTranID': session_tran_id},
          'PosOptions': {'TranType': 'CashOut'}}},
    verify=False
).json()['Message']
amount_cashed_out = result['Amounts']['AmountApproved']
card_balance = result['Amounts']['CardBalance']  # '0.00'

 [
        'ClientID' => 'POS1',
        'Operation' => 'CashOut',
        'RequestID' => '5005',
        'Version' => '4.7.0',
        'ConfigOptions' => [
            'CompanyNumber' => 185197,
            'StoreNumber' => 1,
            'LaneNumber' => 1
        ],
        'PaymentDetails' => [
            'SessionTranID' => 'ccl-gc-session-cashout'
        ],
        'PosOptions' => [
            'TranType' => 'CashOut'
        ]
    ]
]);

$ch = curl_init('https://localhost:8600/PMI/CashOut');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'X-ClientId: POS1'],
    CURLOPT_POSTFIELDS => $body,
]);
$msg = json_decode(curl_exec($ch), true)['Message'];
curl_close($ch);
$dispensed = $msg['Amounts']['AmountApproved'];

using System.Net.Http.Json;

var handler = new HttpClientHandler { ServerCertificateCustomValidationCallback = (_, _, _, _) => true };
using var client = new HttpClient(handler);
client.DefaultRequestHeaders.Add("X-ClientId", "POS1");

var payload = new {
    Message = new {
        ClientID = "POS1",
        Operation = "CashOut",
        RequestID = "5005",
        Version = "4.7.0",
        ConfigOptions = new {
            CompanyNumber = 185197,
            StoreNumber = 1,
            LaneNumber = 1
        },
        PaymentDetails = new {
            SessionTranID = "ccl-gc-session-cashout"
        },
        PosOptions = new {
            TranType = "CashOut"
        }
    }
};
var resp = await client.PostAsJsonAsync("https://localhost:8600/PMI/CashOut", payload);
var root = await resp.Content.ReadFromJsonAsync();
var dispensed = root.GetProperty("Message").GetProperty("Amounts").GetProperty("AmountApproved").GetString();

require 'net/http'
require 'json'
require 'openssl'

uri = URI('https://localhost:8600/PMI/CashOut')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE  # dev only

req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req['X-ClientId'] = 'POS1'
req.body = {
  Message: {
    ClientID: 'POS1',
    Operation: 'CashOut',
    RequestID: '5005',
    Version: '4.7.0',
    ConfigOptions: {
      CompanyNumber: 185197,
      StoreNumber: 1,
      LaneNumber: 1
    },
    PaymentDetails: {
      SessionTranID: 'ccl-gc-session-cashout'
    },
    PosOptions: {
      TranType: 'CashOut'
    }
  }
}.to_json

msg = JSON.parse(http.request(req).body)['Message']
dispensed = msg['Amounts']['AmountApproved']

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newBuilder()
    .sslContext(buildTrustAllContext())  // see pmi-integration guide
    .build();

String jsonBody = """{"Message":{"ClientID":"POS1","Operation":"CashOut","RequestID":"5005","Version":"4.7.0","ConfigOptions":{"CompanyNumber":185197,"StoreNumber":1,"LaneNumber":1},"PaymentDetails":{"SessionTranID":"ccl-gc-session-cashout"},"PosOptions":{"TranType":"CashOut"}}}""";

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://localhost:8600/PMI/CashOut"))
    .header("Content-Type", "application/json")
    .header("X-ClientId", "POS1")
    .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
    .build();

HttpResponse resp = client.send(req, HttpResponse.BodyHandlers.ofString());
// Message.Amounts.AmountApproved (cash dispensed), CardBalance → "0.00"

package main

import (
    "bytes"; "crypto/tls"; "encoding/json"; "net/http"
)

func main() {
    tr := &http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}}
    client := &http.Client{Transport: tr}

    body, _ := json.Marshal(map[string]any{
    "Message": map[string]any{
        "ClientID": "POS1",
        "Operation": "CashOut",
        "RequestID": "5005",
        "Version": "4.7.0",
        "ConfigOptions": map[string]any{
            "CompanyNumber": 185197,
            "StoreNumber": 1,
            "LaneNumber": 1,
        },
        "PaymentDetails": map[string]any{
            "SessionTranID": "ccl-gc-session-cashout",
        },
        "PosOptions": map[string]any{
            "TranType": "CashOut",
        },
    },
})
    req, _ := http.NewRequest("POST", "https://localhost:8600/PMI/CashOut", bytes.NewBuffer(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-ClientId", "POS1")

    resp, _ := client.Do(req)
    var result map[string]any
    json.NewDecoder(resp.Body).Decode(&result)
    // result["Message"].(map[string]any)["Amounts"].(map[string]any)["AmountApproved"]}

const resp = await fetch('https://localhost:8600/PMI/IncrementalAuth', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-ClientId': 'POS1' },
  body: JSON.stringify({ Message: {
    ClientID: 'POS1', Operation: 'IncrementalAuth', RequestID: '7001', Version: '4.7.0',
    ConfigOptions: { CompanyNumber: 185197, StoreNumber: 1, LaneNumber: 1 },
    Amounts: { AmountDue: '50.00', AmountTendered: '50.00', TotalAmountTendered: '150.00' },
    PaymentDetails: { SessionTranID: sessionTranID },
    CardDetails: [{ CardType: 'Credit' }],
    AdjustmentData: { OriginalReferenceId: originalReferenceId }
  }})
});
const { Message } = await resp.json();
const newReferenceId = Message.HostData.ReferenceID;

result = requests.post(
    'https://localhost:8600/PMI/IncrementalAuth',
    headers={'Content-Type': 'application/json', 'X-ClientId': 'POS1'},
    json={'Message': {'ClientID': 'POS1', 'Operation': 'IncrementalAuth',
          'RequestID': '7001', 'Version': '4.7.0',
          'ConfigOptions': {'CompanyNumber': 185197, 'StoreNumber': 1, 'LaneNumber': 1},
          'Amounts': {'AmountDue': '50.00', 'AmountTendered': '50.00', 'TotalAmountTendered': '150.00'},
          'PaymentDetails': {'SessionTranID': session_tran_id},
          'CardDetails': [{'CardType': 'Credit'}],
          'AdjustmentData': {'OriginalReferenceId': original_reference_id}}},
    verify=False
).json()['Message']
new_reference_id = result['HostData']['ReferenceID']

 [
        'ClientID' => 'POS1',
        'Operation' => 'IncrementalAuth',
        'RequestID' => '7001',
        'Version' => '4.7.0',
        'ConfigOptions' => [
            'CompanyNumber' => 185197,
            'StoreNumber' => 1,
            'LaneNumber' => 1
        ],
        'Amounts' => [
            'AmountDue' => '50.00',
            'AmountTendered' => '50.00',
            'TotalAmountTendered' => '150.00'
        ],
        'PaymentDetails' => [
            'SessionTranID' => 'ccl-inc-session-001'
        ],
        'CardDetails' => [[
            'CardType' => 'Credit'
        ]],
        'AdjustmentData' => [
            'OriginalReferenceId' => 'tab-ref-xyz789'
        ]
    ]
]);

$ch = curl_init('https://localhost:8600/PMI/IncrementalAuth');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'X-ClientId: POS1'],
    CURLOPT_POSTFIELDS => $body,
]);
$msg = json_decode(curl_exec($ch), true)['Message'];
curl_close($ch);
$newRef = $msg['HostData']['ReferenceID'];

using System.Net.Http.Json;

var handler = new HttpClientHandler { ServerCertificateCustomValidationCallback = (_, _, _, _) => true };
using var client = new HttpClient(handler);
client.DefaultRequestHeaders.Add("X-ClientId", "POS1");

var payload = new {
    Message = new {
        ClientID = "POS1",
        Operation = "IncrementalAuth",
        RequestID = "7001",
        Version = "4.7.0",
        ConfigOptions = new {
            CompanyNumber = 185197,
            StoreNumber = 1,
            LaneNumber = 1
        },
        Amounts = new {
            AmountDue = "50.00",
            AmountTendered = "50.00",
            TotalAmountTendered = "150.00"
        },
        PaymentDetails = new {
            SessionTranID = "ccl-inc-session-001"
        },
        CardDetails = new[] {{'CardType': 'Credit'}},
        AdjustmentData = new {
            OriginalReferenceId = "tab-ref-xyz789"
        }
    }
};
var resp = await client.PostAsJsonAsync("https://localhost:8600/PMI/IncrementalAuth", payload);
var root = await resp.Content.ReadFromJsonAsync();
var newRef = root.GetProperty("Message").GetProperty("HostData").GetProperty("ReferenceID").GetString();

require 'net/http'
require 'json'
require 'openssl'

uri = URI('https://localhost:8600/PMI/IncrementalAuth')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE  # dev only

req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req['X-ClientId'] = 'POS1'
req.body = {
  Message: {
    ClientID: 'POS1',
    Operation: 'IncrementalAuth',
    RequestID: '7001',
    Version: '4.7.0',
    ConfigOptions: {
      CompanyNumber: 185197,
      StoreNumber: 1,
      LaneNumber: 1
    },
    Amounts: {
      AmountDue: '50.00',
      AmountTendered: '50.00',
      TotalAmountTendered: '150.00'
    },
    PaymentDetails: {
      SessionTranID: 'ccl-inc-session-001'
    },
    CardDetails: [{'CardType': 'Credit'}],
    AdjustmentData: {
      OriginalReferenceId: 'tab-ref-xyz789'
    }
  }
}.to_json

msg = JSON.parse(http.request(req).body)['Message']
new_ref = msg['HostData']['ReferenceID']

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newBuilder()
    .sslContext(buildTrustAllContext())  // see pmi-integration guide
    .build();

String jsonBody = """{"Message":{"ClientID":"POS1","Operation":"IncrementalAuth","RequestID":"7001","Version":"4.7.0","ConfigOptions":{"CompanyNumber":185197,"StoreNumber":1,"LaneNumber":1},"Amounts":{"AmountDue":"50.00","AmountTendered":"50.00","TotalAmountTendered":"150.00"},"PaymentDetails":{"SessionTranID":"ccl-inc-session-001"},"CardDetails":[{"CardType":"Credit"}],"AdjustmentData":{"OriginalReferenceId":"tab-ref-xyz789"}}}""";

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://localhost:8600/PMI/IncrementalAuth"))
    .header("Content-Type", "application/json")
    .header("X-ClientId", "POS1")
    .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
    .build();

HttpResponse resp = client.send(req, HttpResponse.BodyHandlers.ofString());
// Message.HostData.ReferenceID (new reference for further incremental auths)

package main

import (
    "bytes"; "crypto/tls"; "encoding/json"; "net/http"
)

func main() {
    tr := &http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}}
    client := &http.Client{Transport: tr}

    body, _ := json.Marshal(map[string]any{
    "Message": map[string]any{
        "ClientID": "POS1",
        "Operation": "IncrementalAuth",
        "RequestID": "7001",
        "Version": "4.7.0",
        "ConfigOptions": map[string]any{
            "CompanyNumber": 185197,
            "StoreNumber": 1,
            "LaneNumber": 1,
        },
        "Amounts": map[string]any{
            "AmountDue": "50.00",
            "AmountTendered": "50.00",
            "TotalAmountTendered": "150.00",
        },
        "PaymentDetails": map[string]any{
            "SessionTranID": "ccl-inc-session-001",
        },
        "CardDetails": []any{{'CardType': 'Credit'}},
        "AdjustmentData": map[string]any{
            "OriginalReferenceId": "tab-ref-xyz789",
        },
    },
})
    req, _ := http.NewRequest("POST", "https://localhost:8600/PMI/IncrementalAuth", bytes.NewBuffer(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-ClientId", "POS1")

    resp, _ := client.Do(req)
    var result map[string]any
    json.NewDecoder(resp.Body).Decode(&result)
    // result["Message"].(map[string]any)["HostData"].(map[string]any)["ReferenceID"]}

// Call before GetCardDetails to activate the PIN pad display
const resp = await fetch('https://localhost:8600/PMI/StartNotifications', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-ClientId': 'POS1' },
  body: JSON.stringify({ Message: {
    ClientID: 'POS1', Operation: 'StartNotifications', RequestID: '9001', Version: '4.7.0',
    ConfigOptions: { CompanyNumber: 185197, StoreNumber: 1, LaneNumber: 1 }
  }})
});
const { Message } = await resp.json();
// Message.StatusMessage → 'Notifications started'

# Call before GetCardDetails to activate the PIN pad display
result = requests.post(
    'https://localhost:8600/PMI/StartNotifications',
    headers={'Content-Type': 'application/json', 'X-ClientId': 'POS1'},
    json={'Message': {'ClientID': 'POS1', 'Operation': 'StartNotifications',
          'RequestID': '9001', 'Version': '4.7.0',
          'ConfigOptions': {'CompanyNumber': 185197, 'StoreNumber': 1, 'LaneNumber': 1}}},
    verify=False
).json()['Message']
# result['StatusMessage'] → 'Notifications started'

 [
        'ClientID' => 'POS1',
        'Operation' => 'StartNotifications',
        'RequestID' => '9001',
        'Version' => '4.7.0',
        'ConfigOptions' => [
            'CompanyNumber' => 185197,
            'StoreNumber' => 1,
            'LaneNumber' => 1
        ]
    ]
]);

$ch = curl_init('https://localhost:8600/PMI/StartNotifications');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'X-ClientId: POS1'],
    CURLOPT_POSTFIELDS => $body,
]);
$msg = json_decode(curl_exec($ch), true)['Message'];
curl_close($ch);
// $msg['Status'] === 'Success'

using System.Net.Http.Json;

var handler = new HttpClientHandler { ServerCertificateCustomValidationCallback = (_, _, _, _) => true };
using var client = new HttpClient(handler);
client.DefaultRequestHeaders.Add("X-ClientId", "POS1");

var payload = new {
    Message = new {
        ClientID = "POS1",
        Operation = "StartNotifications",
        RequestID = "9001",
        Version = "4.7.0",
        ConfigOptions = new {
            CompanyNumber = 185197,
            StoreNumber = 1,
            LaneNumber = 1
        }
    }
};
var resp = await client.PostAsJsonAsync("https://localhost:8600/PMI/StartNotifications", payload);
var root = await resp.Content.ReadFromJsonAsync();
// root.GetProperty("Message").GetProperty("Status").GetString();

require 'net/http'
require 'json'
require 'openssl'

uri = URI('https://localhost:8600/PMI/StartNotifications')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE  # dev only

req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req['X-ClientId'] = 'POS1'
req.body = {
  Message: {
    ClientID: 'POS1',
    Operation: 'StartNotifications',
    RequestID: '9001',
    Version: '4.7.0',
    ConfigOptions: {
      CompanyNumber: 185197,
      StoreNumber: 1,
      LaneNumber: 1
    }
  }
}.to_json

msg = JSON.parse(http.request(req).body)['Message']
# msg['Status'] == 'Success'

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newBuilder()
    .sslContext(buildTrustAllContext())  // see pmi-integration guide
    .build();

String jsonBody = """{"Message":{"ClientID":"POS1","Operation":"StartNotifications","RequestID":"9001","Version":"4.7.0","ConfigOptions":{"CompanyNumber":185197,"StoreNumber":1,"LaneNumber":1}}}""";

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://localhost:8600/PMI/StartNotifications"))
    .header("Content-Type", "application/json")
    .header("X-ClientId", "POS1")
    .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
    .build();

HttpResponse resp = client.send(req, HttpResponse.BodyHandlers.ofString());
// Message.Status === "Success"

package main

import (
    "bytes"; "crypto/tls"; "encoding/json"; "net/http"
)

func main() {
    tr := &http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}}
    client := &http.Client{Transport: tr}

    body, _ := json.Marshal(map[string]any{
    "Message": map[string]any{
        "ClientID": "POS1",
        "Operation": "StartNotifications",
        "RequestID": "9001",
        "Version": "4.7.0",
        "ConfigOptions": map[string]any{
            "CompanyNumber": 185197,
            "StoreNumber": 1,
            "LaneNumber": 1,
        },
    },
})
    req, _ := http.NewRequest("POST", "https://localhost:8600/PMI/StartNotifications", bytes.NewBuffer(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-ClientId", "POS1")

    resp, _ := client.Do(req)
    var result map[string]any
    json.NewDecoder(resp.Body).Decode(&result)
    // result["Message"].(map[string]any)["Status"]}

// Poll in a loop while waiting for GetCardDetails to return
async function pollNotifications(sessionActive) {
  while (sessionActive()) {
    const resp = await fetch('https://localhost:8600/PMI/GetNotifications?timeout=3', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json', 'X-ClientId': 'POS1' },
      body: JSON.stringify({ Message: {
        ClientID: 'POS1', Operation: 'GetNotifications', RequestID: '9002', Version: '4.7.0'
      }})
    });
    const data = await resp.json().catch(() => null);
    if (data?.Notification?.length) {
      data.Notification.forEach(n => displayMessage(n.CustomerText));
    }
  }
}

# Poll in a loop while waiting for GetCardDetails to return
import threading

def poll_notifications(stop_event):
    while not stop_event.is_set():
        try:
            resp = requests.post(
                'https://localhost:8600/PMI/GetNotifications',
                params={'timeout': 3},
                headers={'Content-Type': 'application/json', 'X-ClientId': 'POS1'},
                json={'Message': {'ClientID': 'POS1', 'Operation': 'GetNotifications',
                      'RequestID': '9002', 'Version': '4.7.0'}},
                verify=False, timeout=5
            ).json()
            for n in resp.get('Notification', []):
                print(n.get('CustomerText', ''))
        except Exception:
            pass

 [
        'ClientID' => 'POS1',
        'Operation' => 'GetNotifications',
        'RequestID' => '9002',
        'Version' => '4.7.0'
    ]
]);

$ch = curl_init('https://localhost:8600/PMI/GetNotifications');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'X-ClientId: POS1'],
    CURLOPT_POSTFIELDS => $body,
]);
$msg = json_decode(curl_exec($ch), true)['Message'];
curl_close($ch);
// $data['Notification'] — array of customer-facing strings

using System.Net.Http.Json;

var handler = new HttpClientHandler { ServerCertificateCustomValidationCallback = (_, _, _, _) => true };
using var client = new HttpClient(handler);
client.DefaultRequestHeaders.Add("X-ClientId", "POS1");

var payload = new {
    Message = new {
        ClientID = "POS1",
        Operation = "GetNotifications",
        RequestID = "9002",
        Version = "4.7.0"
    }
};
var resp = await client.PostAsJsonAsync("https://localhost:8600/PMI/GetNotifications", payload);
var root = await resp.Content.ReadFromJsonAsync();
// root.GetProperty("Notification").EnumerateArray()

require 'net/http'
require 'json'
require 'openssl'

uri = URI('https://localhost:8600/PMI/GetNotifications')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE  # dev only

req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req['X-ClientId'] = 'POS1'
req.body = {
  Message: {
    ClientID: 'POS1',
    Operation: 'GetNotifications',
    RequestID: '9002',
    Version: '4.7.0'
  }
}.to_json

msg = JSON.parse(http.request(req).body)['Message']
# data['Notification']  # array of customer-facing strings

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newBuilder()
    .sslContext(buildTrustAllContext())  // see pmi-integration guide
    .build();

String jsonBody = """{"Message":{"ClientID":"POS1","Operation":"GetNotifications","RequestID":"9002","Version":"4.7.0"}}""";

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://localhost:8600/PMI/GetNotifications"))
    .header("Content-Type", "application/json")
    .header("X-ClientId", "POS1")
    .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
    .build();

HttpResponse resp = client.send(req, HttpResponse.BodyHandlers.ofString());
// Parse resp.body() → Notification[] array

package main

import (
    "bytes"; "crypto/tls"; "encoding/json"; "net/http"
)

func main() {
    tr := &http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}}
    client := &http.Client{Transport: tr}

    body, _ := json.Marshal(map[string]any{
    "Message": map[string]any{
        "ClientID": "POS1",
        "Operation": "GetNotifications",
        "RequestID": "9002",
        "Version": "4.7.0",
    },
})
    req, _ := http.NewRequest("POST", "https://localhost:8600/PMI/GetNotifications", bytes.NewBuffer(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-ClientId", "POS1")

    resp, _ := client.Do(req)
    var result map[string]any
    json.NewDecoder(resp.Body).Decode(&result)
    // result["Notification"].([]any)}

// Call after card is captured (GetCardDetails returns)
const resp = await fetch('https://localhost:8600/PMI/StopNotifications', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-ClientId': 'POS1' },
  body: JSON.stringify({ Message: {
    ClientID: 'POS1', Operation: 'StopNotifications', RequestID: '9003', Version: '4.7.0',
    ConfigOptions: { CompanyNumber: 185197, StoreNumber: 1, LaneNumber: 1 }
  }})
});
const { Message } = await resp.json();
// Message.StatusMessage → 'Notifications stopped'

# Call after card is captured (GetCardDetails returns)
result = requests.post(
    'https://localhost:8600/PMI/StopNotifications',
    headers={'Content-Type': 'application/json', 'X-ClientId': 'POS1'},
    json={'Message': {'ClientID': 'POS1', 'Operation': 'StopNotifications',
          'RequestID': '9003', 'Version': '4.7.0',
          'ConfigOptions': {'CompanyNumber': 185197, 'StoreNumber': 1, 'LaneNumber': 1}}},
    verify=False
).json()['Message']
# result['StatusMessage'] → 'Notifications stopped'

 [
        'ClientID' => 'POS1',
        'Operation' => 'StopNotifications',
        'RequestID' => '9003',
        'Version' => '4.7.0',
        'ConfigOptions' => [
            'CompanyNumber' => 185197,
            'StoreNumber' => 1,
            'LaneNumber' => 1
        ]
    ]
]);

$ch = curl_init('https://localhost:8600/PMI/StopNotifications');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'X-ClientId: POS1'],
    CURLOPT_POSTFIELDS => $body,
]);
$msg = json_decode(curl_exec($ch), true)['Message'];
curl_close($ch);
// $msg['Status'] === 'Success'

using System.Net.Http.Json;

var handler = new HttpClientHandler { ServerCertificateCustomValidationCallback = (_, _, _, _) => true };
using var client = new HttpClient(handler);
client.DefaultRequestHeaders.Add("X-ClientId", "POS1");

var payload = new {
    Message = new {
        ClientID = "POS1",
        Operation = "StopNotifications",
        RequestID = "9003",
        Version = "4.7.0",
        ConfigOptions = new {
            CompanyNumber = 185197,
            StoreNumber = 1,
            LaneNumber = 1
        }
    }
};
var resp = await client.PostAsJsonAsync("https://localhost:8600/PMI/StopNotifications", payload);
var root = await resp.Content.ReadFromJsonAsync();
// root.GetProperty("Message").GetProperty("Status").GetString();

require 'net/http'
require 'json'
require 'openssl'

uri = URI('https://localhost:8600/PMI/StopNotifications')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE  # dev only

req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req['X-ClientId'] = 'POS1'
req.body = {
  Message: {
    ClientID: 'POS1',
    Operation: 'StopNotifications',
    RequestID: '9003',
    Version: '4.7.0',
    ConfigOptions: {
      CompanyNumber: 185197,
      StoreNumber: 1,
      LaneNumber: 1
    }
  }
}.to_json

msg = JSON.parse(http.request(req).body)['Message']
# msg['Status'] == 'Success'

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newBuilder()
    .sslContext(buildTrustAllContext())  // see pmi-integration guide
    .build();

String jsonBody = """{"Message":{"ClientID":"POS1","Operation":"StopNotifications","RequestID":"9003","Version":"4.7.0","ConfigOptions":{"CompanyNumber":185197,"StoreNumber":1,"LaneNumber":1}}}""";

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://localhost:8600/PMI/StopNotifications"))
    .header("Content-Type", "application/json")
    .header("X-ClientId", "POS1")
    .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
    .build();

HttpResponse resp = client.send(req, HttpResponse.BodyHandlers.ofString());
// Message.Status === "Success"

package main

import (
    "bytes"; "crypto/tls"; "encoding/json"; "net/http"
)

func main() {
    tr := &http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}}
    client := &http.Client{Transport: tr}

    body, _ := json.Marshal(map[string]any{
    "Message": map[string]any{
        "ClientID": "POS1",
        "Operation": "StopNotifications",
        "RequestID": "9003",
        "Version": "4.7.0",
        "ConfigOptions": map[string]any{
            "CompanyNumber": 185197,
            "StoreNumber": 1,
            "LaneNumber": 1,
        },
    },
})
    req, _ := http.NewRequest("POST", "https://localhost:8600/PMI/StopNotifications", bytes.NewBuffer(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-ClientId", "POS1")

    resp, _ := client.Do(req)
    var result map[string]any
    json.NewDecoder(resp.Body).Decode(&result)
    // result["Message"].(map[string]any)["Status"]}