Questionnaires

Open

Questionnaires enable Operators to query and save specific questions from their customers. This might be useful for marketing, government-compliance purposes, and/or both.

Questionnaires were introduced in version 20231212.

• Terminal firmware must be 20231212 (or newer) to display Questionnaires.

Definitions

Create the queries for the survey.

Results found in Transactions:

Questionnaire results are listed in the Transaction log (via ACTIONS).

• See: https://generalbytes.atlassian.net/l/cp/f7v0Gvaf

Click on the Transaction “Show Questionnaire Results” to view the results of that transaction's responses:

• Shows all Questionnaire answers which were displayed to the customer during that transaction.

• Export the transaction Questionnaire results to CSV file via the CSV download icon.

Example:

VIEW enumerates the details:

Results found in Identities:

All Questionnaire responses from this Identity / customer (only) are listed in Questionnaire Results.

• Export all identity Questionnaire results to CSV file via the download icon.

  • CSV file structure:

    • Questionnaire name

    • Completion time

    • Identity public ID

    • Transaction local ID

    • Transaction remote ID

    • Question

    • Answer

• Export the transaction Questionnaire results to CSV file via the CSV download icon.

• Clicking VIEW displays the Questionnaire Result Answers for that Questionnaire.

Extension Support

Operators are able to use extensions to override some values, or to approve / reject transactions. Extensions are used for Prepare or Submit of the transaction.

Prepare transaction API calls:

• com.generalbytes.batm.server.extensions.ITransactionListener#overrideTransactionPreparation

  • is used to override some parameters using the output object,

  • overridable parameters:

    • errorMessage

    • cashTransactionLimit

    • cashTransactionMinimum

    • supplyTransactionLimit

    • allowedDiscountCode

• com.generalbytes.batm.server.extensions.ITransactionListener#isTransactionPreparationApproved

  • is used to approve/reject the transaction,

  • in the event of rejection, an error message can be propagated to the display terminal by setting errorMessage on the input object

 Submit transaction API calls:

• com.generalbytes.batm.server.extensions.ITransactionListener#overrideTransactionRequest

  • is used to override some parameters using the output object,

  • overridable parameters:

    • cryptoAmount

    • errorMessage

• com.generalbytes.batm.server.extensions.ITransactionListener#isTransactionApproved

  • is used to approve/reject the transaction,

  • in the event of rejection, an error message can be propagated to the display terminal by setting errorMessage on the input object