Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
image-20240123-150406.png

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

Questionnaires were introduced in version 20231212.

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

image-20240123-150619.png

Definitions

Create the queries for the survey.

image-20240123-150559.png

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).

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

image-20240123-184253.pngImage Added
  • Shows all Questionnaire answers which were displayed to the Identity / customer during the that transaction.

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

image-20240123-184253.pngImage Removed

ShowsExample:

image-20240123-184415.png

VIEW brings you to enumerates the details:

image-20240123-184506.png

Identity

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

image-20240123-185038.png
  • Export the transaction Questionnaire results to CSV file via the CSV download icon.

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

image-20240123-184506.png

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