This is v9.4 of the developer resources that can be found under Start, Develop, Deploy, Operate, Customize and Reference sections, except with references to the Nok Nok S3 Suite instead of the DigipassONE Platform.

Interface

Prev Next
package com.noknok.gateway.sdk;
/**
 * This interface defines methods for generating transaction text and
 * performing post-transaction actions. Implementations should have a single
 * constructor with the following signature:
 * public MyTransactionManager(IConfigurationManager configurationManager,
 *                             String tenantID, String objectType);
 */
public interface ITransactionManager {
/**
 * The API Server calls this method on every INIT_AUTH/START_OOB_AUTH
 * operation before sending a request to the Auth Server. The implementation 
 * should identify whether it is a transaction (for example, by checking for 
 * transaction.id presence in the request) or an authentication operation. 
 * If it is a transaction operation, the implementation should retrieve 
 * the transaction text based on the given transaction.id and put the 
 * transaction.text into jsonRequest to be sent to the Auth Server. 
 * If the operation is not a transaction (instead it is an authentication),
 * the implementation should just return.
 * Parameters:
 *    request - HTTP request from client.
 *    jsonRequest - REST request from client to be sent to
 *                  Authentication Server (MFAS).
 * Throws:
 *    BadRequestException - if the request is invalid.
 *    InternalErrorException - if another error occurred.
 */
void startTransaction​(javax.servlet.http.HttpServletRequest request,
                      com.google.gson.JsonObject jsonRequest)
/**
 * Called on every FINISH_AUTH/FINISH_OOB_AUTH/STATUS_OOB_AUTH operation
 * after receiving a response from the Auth Server. Implement any expected 
 * behavior after the transaction operation such as removing DB entry 
 * at failure.
 * Parameters:
 *    response - HTTP response to client.
 *    jsonResponse - REST response from Authentication Server (MFAS) to
 *                   be sent to the client.
 * Throws:
 *    InternalErrorException - if another error occurred.
 */
void finishTransaction​(javax.servlet.http.HttpServletResponse response,
                              com.google.gson.JsonObject jsonResponse)
}