Transaction

5. Transaction

5.1. getTransaction

This function enables the developer to retrieve a single transaction record based on the provided transactionId.

Declaration

JObject getTransaction(string transactionId = "")

Here are the input and output parameters defined against this function.

Type (In/Out)NameDescription
System.string - [In]transactionIdTransaction ID that is to be retrieved. The function will use BLANK value if the parameter is left out during execution. The function will throw an exception if a BLANK value is passed in this parameter.
JObject - [Out]N/AThe transaction result object streamed into resp named parameter and returned.

5.2. listTransaction

This function retrieves a list of transaction history based on the provided filter parameters.

Declaration

JObject listTransaction(int order = -1, int limit = 10, int offset = 0, int createdAtMin = 0,
        int createdAtMax = 0, string filterCustomData = "", string filterDecision = "", string filterDocupass = "",
        string filterProfileId = "")

Here are the input and output parameters defined against this function.

Type (In/Out)NameDescription
System.integer- [In]orderSort results by newest(-1) or oldest(1). If the parameter is left out during execution, the function will use the -1 value. The function will throw an exception if the BLANK value is passed in this parameter. The parameter cannot be 1 or -1.
System.integer- [In]limitA number of items are to be returned per call. The function will use 10 value in case the parameter is left out during execution.
System.integer- [In]offsetStart the list from a particular entry index. The function will use 0 value in case the parameter is left out during execution. limit should be a positive integer greater than 0 and less than or equal to 100.
System.integer- [In]createdAtMinList transactions that were created after this timestamp. The function will use 0 value in case the parameter is left out during execution.
System.integer- [In]createdAtMaxList transactions that were created before this timestamp. The function will use 0 value in case the parameter is left out during execution.
System.string - [In]filterCustomDataFilter result by customData field. The function will use the BLANK value if the parameter is left out during execution.
System.string - [In]filterDecisionFilter result by decision (accept, review, reject). The function will use the BLANK value if the parameter is left out during execution.
System.string - [In]filterDocupassFilter result by Docupass reference. The function will use the BLANK value if the parameter is left out during execution.
System.string - [In]filterProfileIdFilter results by KYC Profile ID. The function will use the BLANK value if the parameter is left out during execution.
JObject - [Out]N/AThe transaction list result object streamed into resp named parameter and returned.

5.3. updateTransaction

This function updates the decision against the provided transactionId. A list of possible decision updates are

  • accept
  • review
  • reject

Declaration

JObject updateTransaction(string transactionId = "", string decision = "")

Here are the input and output parameters defined against this function.

Type (In/Out)NameDescription
System.string - [In]transactionIdTransaction ID against which the decision needs to be updated. The function will use the BLANK value if the parameter is left out during execution. The function will throw an exception if the BLANK value is passed in this parameter.
System.string - [In]decisionUpdated decision. Possible value can be accept, review or reject. The function will throw exception any other value is passed.
JObject - [Out]N/AThe updated transaction result object streamed into resp named parameter and returned.

5.4. deleteTransaction

Consumers can use this function to delete any unnecessary transactions from the system.

Declaration

public JObject deleteTransaction(string transactionId = "")

Here are the input and output parameters defined against this function.

Type (In/Out)NameDescription
System.string - [In]transactionIdTransaction ID that is to be deleted. Function will use BLANK value if the parameter is left out during execution. Function will throw an exception if BLANK value is passed in this parameter.
JObject - [Out]N/AThe deleted transaction result object streamed into resp named parameter and returned.

5.5. saveImage

This function download transaction image onto a local file system.

Declaration

public void saveImage(string imageToken = "", string destination = "")

Here are the input and output parameters defined against this function.

Type (In/Out)NameDescription
System.string - [In]imageTokenImage token from the transaction API response. The function will use the BLANK value if the parameter is left out during execution. The function will throw an exception if the BLANK value is passed in this parameter.
System.string - [In]destinationFull destination path including file name, the file extension should be jpg, for example: '\home\idcard.jpg'. The function will use the BLANK value if the parameter is left out during execution. The function will throw an exception if the BLANK value is passed in this parameter.
JObject - [Out]N/AThe saved image result object streamed into resp named parameter and returned.

5.6. saveFile

This function downloads transaction files onto the local file system using the secured file name obtained from the transaction

Declaration

public void saveFile(string fileName = "", string destination = "")

Here are the input and output parameters defined against this function.

Type (In/Out)NameDescription
System.string - [In]fileNameSecured file name. The function will use the BLANK value if the parameter is left out during execution. The function will throw an exception if the BLANK value is passed in this parameter.
System.string - [In]destinationFull destination path including file name, the file extension should be jpg, for example: '\home\idcard.jpg'. The function will use the BLANK value if the parameter is left out during execution. The function will throw an exception if the BLANK value is passed in this parameter.
JObject - [Out]N/AThe saved file result object streamed into resp named parameter and returned.

5.7. exportTransaction

This function is used to download transaction archives onto the local file system.

Declaration

public void exportTransaction(string destination = "", List<string>? transactionId = null,
        string exportType = "csv", bool ignoreUnrecognized = false, bool ignoreDuplicate = false, int createdAtMin = 0,
        int createdAtMax = 0, string filterCustomData = "", string filterDecision = "", string filterDocupass = "",
        string filterProfileId = "")

Here are the input and output parameters defined against this function.

Type (In/Out)NameDescription
System.string - [In]destinationFull destination path including file name, file extension should be zip, for example: '\home\archive.zip'. The function will use the BLANK value if the parameter is left out during execution. The function will throw an exception if the BLANK value is passed in this parameter.
System.Collections.Generic.List - [In]transactionIdExport only the specified transaction IDs passed in the list. The function will use the BLANK value if the parameter is left out during execution.
System.string - [In]exportTypeExport type of document. Possible value can be csv or json. The function will throw an exception if other value is passed. The function will use csv1 value in case the parameter is left out during execution.
System.bool- [In]ignoreUnrecognizedIgnore unrecognized entries. The function will use false value in case the parameter is left out during execution.
System.bool- [In]ignoreDuplicateIgnore duplicated entries. The function will use false value in case the parameter is left out during execution.
System.integer- [In]createdAtMinList transactions that were created after this timestamp. The function will use 0 value in case the parameter is left out during execution.
System.integer- [In]createdAtMaxList transactions that were created before this timestamp. The function will use 0 value in case the parameter is left out during execution.
System.string - [In]filterCustomDataFilter result by customData field. The function will use BLANK value if the parameter is left out during execution.
System.string - [In]filterDecisionFilter result by decision (accept, review, reject). The function will use the BLANK value if the parameter is left out during execution.
System.string - [In]filterDocupassFilter result by Docupass reference. The function will use the BLANK value if the parameter is left out during execution.
System.string - [In]filterProfileIdFilter result by KYC Profile ID. The function will use the BLANK value if the parameter is left out during execution.
JObject - [Out]N/AThe exported file result object streamed into resp named parameter and returned.