Verifone Terminal Status Batch

Performs a bulk update to the current status for connected Verifone NZ payment terminals. See the Batch API resource for how to submit an instance of this batch.

Type Name	File Format	Record Type
verifone-terminal-status	JSONL	Terminal Status

Terminal Status

Attributes

status
string
Current terminal status: “active” or “inactive”.
statusMessage
string
Reason for status. Eg: “config update required”.
terminalId
string
Logical terminal id. Eg: “325-136-329”.
deviceId
string
Hardware serial number. Eg: “T404395000002”.
merchantId
string
Centrapay Merchant API id.
merchantConfigId
string
Centrapay Merchant Config API id.
merchantName
string
Name of merchant. Eg: “Centra Café”.
description
string
Description of the device. Eg “Front Till”.
model
string
Hardware model. Eg: “VX820”.
firstSeen
timestamp
Date when terminal status was first observed.
lastSeen
timestamp
Date when terminal status was last observed.
configVersion
string
Version of loaded terminal configuration. Eg: “20220214.1”.
configUpdatedAt
timestamp
Date when terminal configuration was loaded.
softwareVersion
string
Version of terminal software. Eg: “1.7.134”.
softwareUpdatedAt
timestamp
Date when terminal software was updated.

Example JSONL File

A complete batch example with all batch types included. For more legible examples please refer to Example Models.

Example JSONL

{"merchantId":"06baa0708ee0e000696","merchantConfigId":"baa09e8158300063fc","merchantName":"Centra Café","description":"Till #1","model":"VX820","terminalId":"325-136-331","deviceId":"T404395000004","status":"inactive","statusMessage":"update required","firstSeen":"2020-01-14T09:00:00Z","lastSeen":"2022-03-14T09:00:00Z","configVersion": 20210914.1,"configUpdatedAt":"2021-09-15 09:00:00 UTC","softwareVersion":"1.7.134","softwareUpdatedAt":"2021-11-14 09:00:00 UTC"}
{"merchantId":"06baa0708ee0e000696","merchantConfigId":"baa09e8158300063fc","merchantName":"Centra Café","description":"Till #2","model":"VX820","terminalId":"325-136-329","deviceId":"T404395000002","status":"active","statusMessage":"ok","firstSeen":"2020-01-14T09:00:00Z","lastSeen":"2022-03-14T09:00:00Z","configVersion": 20220214.1,"configUpdatedAt":"2022-02-14 09:00:00 UTC","softwareVersion":"1.7.134","softwareUpdatedAt":"2021-11-14 09:00:00 UTC"}

Pretty Printed Example

Below our records have newlines for legibility. When submitting a batch file you must only use newlines to separate records.

Pretty Printed Example

{
  "merchantId": "06baa0708ee0e000696",
  "merchantConfigId": "baa09e8158300063fc",
  "merchantName": "Centra Café",
  "description": "Till #2",
  "model": "VX820",
  "terminalId": "325-136-329",
  "deviceId": "T404395000002",
  "status": "active",
  "statusMessage": "incompatible hardware",
  "firstSeen": "2020-01-14T09:00:00Z",
  "lastSeen": "2022-03-14T09:00:00Z",
  "configVersion": 20220214.1,
  "configUpdatedAt": "2022-02-14 09:00:00 UTC",
  "softwareVersion": "1.7.134",
  "softwareUpdatedAt": "2021-11-14 09:00:00 UTC"
}