Reconciliation

🚧

Development mode

ePOS Payments is in development. You can find the API specification in development here. If you are interested in gaining access when available then please contact us via our support page

Overview

Send a Reconciliation message from your ePOS system to submit the end of business day for the merchant which sends a message to the acquirer to process a batch cut-off for the merchant's day.

The ePOS Payments API supports this functionality as follows:

  • nexo Retailer ReconciliationRequest with ReconciliationType set to Sale Reconciliation

Sample Workflow

This sequence diagram maps to the steps in the Reconciliation sample request and response payloads that follow.

ReconciliationReconciliation

Sample Reconciliation Request Body payload

Below is an example of a nexo Reconciliation Request payload (body only). In this example the cashier is submitting the end of business day for the merchant.

It is worth noting the following:

  • MessageCategory must be set as "Reconciliation"
  • MessageType must be set as "Request"
  • POIID must be set as "CAP"
  • ReconciliationType must be set as "SaleReconciliation"
{
  "SaleToPOIRequest": {
    "MessageHeader": {
      "MessageClass": "Service",
      "MessageCategory": "Reconciliation",
      "MessageType": "Request",
      "ServiceID": "3731207678",
      "SaleID": "Salesystem-00000001",
      "POIID": "CAP"
    },
    "ReconciliationRequest": {
      "ReconciliationType": "SaleReconciliation"
    }
  }
}

Sample Reconciliation Response Body payload

Below is an example of a successful nexo Reconciliation Response payload (body only). In this example the end of day submission has been processed successfully.

It is worth noting the following:

  • Result is "Success"
{
  "SaleToPOIResponse": {
    "MessageHeader": {
      "MessageCategory": "Reconciliation",
      "MessageClass": "Service",
      "MessageType": "Response",
      "POIID": "CAP",
      "SaleID": "Salesystem-00000001",
      "ServiceID": "3731207678"
    },
    "ReconciliationResponse": {
      "ReconciliationType": "SaleReconciliation",
      "Response": {
        "Result": "Success"
      }
    }
  }
}

Did this page help you?