Voice authorisation for BankAxept backup solution

For merchants subscribing to BankAxept backup solution voice authorisation is required if the amount exceeds the voice authorisation limit. p.t. 2500 NOK.

If so, the terminal sends an Input request to to the ECR that requests the cashier to to call a number, inform the voice authorisation service about the BankAxept merchant-id (BAX-number), the amount and the account/card number. The details are displayet at the ECR's display. The cashier then enters the recieved 6-digit authorisation code in the input window or writes in on the paper receipt. If written on the receipt, there is no need to enter the code in the input window, i.e. an empty input response is accepted.

The prompt text to be displayed is.

Reserveløsning: Ring autorisasjonstelefon 24 17 43 91, oppgi brukerstedsnummer / BAX-Number , beløp / Amount,og kontonummer digits 7-17 from PAN, og skriv inn autorisasjonskoden nedenfor eller på kvitteringen.

The strings are replaced by the actual values in each case.

Example Input request

{
  "SaleToPOIRequest": {
    "MessageHeader": {
      "ProtocolVersion": "3.1",
      "ServiceID": "2",
      "MessageClass": "Device",
      "MessageCategory": "Input",
      "MessageType": "Request",
      "DeviceID": "ABC123",
      "SaleID": "ECR123",
      "POIID": "AT12345"
    },
    "InputRequest": {
      "DisplayOutput": {
        "Device": "CashierDisplay",
        "InfoQualify": "Display",
        "OutputContent": {
          "OutputFormat": "Text",
          "OutputText": [
            {
              "Text": "Reserveløsning:"
            },
            {
              "Text": "Ring autorisasjonstelefon 24 17 43 91..."
            }
          ]
        }
      },
      "InputData": {
        "Device": "CashierInput",
        "InfoQualify": "Input",
        "InputCommand": "DigitString",
        "MaxInputTime": 300
      }
    }
  }
}

Property	Description	Mandatory / Optional
InputRequest		Mandatory
DisplayOutput		Mandatory
Device	Always "CashierDisplay"	Mandatory
InfoQualify	Always "Display"	Mandatory
OutputContent		Mandatory
OutputFormat	"Text" to indicate text format	Mandatory
OutputText	List, one per text row	Mandatory
Text	Row text	Mandatory
InputData		Mandatory
Device	Always "CashierInput"	Mandatory
InfoQualify	Always "Input"	Mandatory
InputCommand	"DigitString" (requesting digit input like a phone number)	Mandatory
MaxInputTime	Number of seconds the terminal will wait for input response before timing out and aborting the flow	Mandatory

Example Input response

{
  "SaleToPOIResponse": {
    "MessageHeader": {
      "ProtocolVersion": "3.1",
      "ServiceID": "2",
      "MessageClass": "Device",
      "MessageCategory": "Input",
      "MessageType": "Response",
      "DeviceID": "ABC123",
      "SaleID": "ECR123",
      "POIID": "AT12345"
    },
    "InputResponse": {
      "OutputResult": {
        "Device": "CashierDisplay",
        "InfoQualify": "Display",
        "Response": {
          "Result": "Success"
        }
      },
      "InputResult": {
        "Device": "CashierInput",
        "InfoQualify": "Input",
        "Response": {
          "Result": "Success"
        },
        "Input": {
          "InputCommand": "DigitString",
          "DigitInput": "123456"
        }
      }
    }
  }
}

Property	Description	Mandatory / Optional
InputResponse		Mandatory
OutputResult	One per DisplayOutput item of the request, and in the same order	Mandatory
Device	Copy from request	Mandatory
InfoQualify	Copy from request	Mandatory
Response		Mandatory
Result	"Success" if successful, "Failure" if diplay message failed	Mandatory
InputResult		Mandatory
Device	Copy from request	Mandatory
InfoQualify	Copy from request	Mandatory
Response		Mandatory
Result	"Success" if successful, "Failure" if failed or cancelled by the cashier	Mandatory
ErrorCondition	Not present if "Success", "Cancel" if cancelled by the cashier, "Failure" if other errors	Optional
Input		Mandatory
InputCommand	Copy from request	Mandatory
DigitInput	Authorisation code (6 digits) entered by the cashier	Mandatory