Questionnaires

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.

Selectors

Define when, where, and how the surveys will be shown.

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