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.

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:

Open

• 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:

Open

VIEW enumerates the details:

Open

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

Open

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

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

Open

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