X and Z Report
This API is used to initiate payment requests, specifying the following details:
| Request Details | Values |
|---|---|
| Method | POST |
| URL | https://{ENVIRONMENT}/oidc/poscloud/nexo/getTotals |
| Authorization | https://verifone.cloud/docs/in-store-payments/integration-set-terminal#step-3__003a__00a0setting-up-basic-auth-in-postman |
|
Headers: Content-Type x-terminal-simulator x-site-entity-id
Authorization |
application/json true Entity ID of child to be passed in case parent token is used while calling this API. "user-uid:api" key pair encoded in base64. See the Obtaining API Keys guide for more information. |
| Body > Raw | See the request example below. |
Note: Need to perform a sale by passing a value in SaleTerminalData.TotalsGroupID in the Sale
request, then the SaleTerminalData.TotalsGroupID value can be used to fetch the X-report.
For Z report response increment TotalsGroupID value by 1 in the request.
For example: X-report = 110, Z-report =111
{
"MessageHeader": {
"MessageClass": "SERVICE",
"MessageCategory": "GETTOTALS",
"MessageType": "REQUEST",
"ServiceID": "1234",
"SaleID": "1992",
"POIID": "GSC-A"
},
"GetTotalsRequest": {
"TotalDetails": {
"TotalsGroupID":110
}
}
}POS Cloud will send back the response once the data is received from the terminal, which will look something like this:
{
"MessageHeader": {
"MessageClass": "SERVICE",
"MessageCategory": "GETTOTALS",
"MessageType": "RESPONSE",
"ServiceID": "1234",
"SaleID": "1992",
"POIID": "GSC-A"
},
"GetTotalsResponse": {
"Response": {
"Result": "SUCCESS",
"ErrorCondition": null,
"AdditionalResponse": null
},
"POIReconciliationID": null,
"VF_ClosingSummary": [],
"TransactionTotals": [
{
"PaymentInstrumentType": null,
"AcquirerID": null,
"ErrorCondition": null,
"HostReconciliationID": null,
"CardBrand": null,
"POIID": null,
"SaleID": null,
"OperatorID": null,
"ShiftNumber": null,
"TotalsGroupID": null,
"PaymentCurrency": null,
"PaymentTotals": [],
"LoyaltyUnit": null,
"LoyaltyCurrency": null,
"LoyaltyTotals": null
}
],
"VF_OutputContent": {
"OutputFormat": "TEXT",
"PredefinedContent": null,
"OutputText": [
{
"Text": "\n SETTLEMENT APPROVED\n TERMINAL\n 12345678\n TIME\n 01 Jan 70 05:30\n SETTLEMENT TOTALS\n SALE\n 0\n $0.00\n CASH BACK\n 0\n $0.00\n REFUND\n 0\n $0.00\n Net Amount\n $0.00",
"CharacterSet": null,
"Font": null,
"StartRow": null,
"StartColumn": null,
"Color": null,
"CharacterWidth": null,
"CharacterHeight": null,
"CharacterStyle": null,
"Alignment": null,
"EndOfLineFlag": null
}
],
"OutputXHTML": null,
"OutputBarcode": null
}
}
}